Materialize Score

Internal Service — This is not an HTTP endpoint. It’s called directly by the generate-all orchestrator.

Purpose

Copies the pre-payment ranking score to the visibility_score_history table. This preserves the initial score so users can see their progress over time. Runs in GROUP 1f (parallel with scrape, fire-and-forget). Doesn’t need scraped pages.

Function Signature

async def run_materialize_score(url: str, org_slug: str) -> StepResult

Parameters

Parameter	Type	Description
`url`	`str`	The website URL
`org_slug`	`str`	The Clerk organization slug

Returns

{
  "name": "materialize_score",
  "status": "success",
  "data": {
    "score": 72,
    "entity_id": "uuid-..."
  }
}

What It Does

Fetches the pre-payment ranking score from the ranking database
Creates a history entry in visibility_score_history
This becomes the “Day 0” baseline for tracking improvement

Database Schema

INSERT INTO visibility_score_history (
  entity_id,
  score,
  recorded_at
) VALUES (
  'uuid-...',
  72,
  NOW()
);

Code Location

src/app/apis/onboarding/generate_all/
├── scoring.py          # materialize_score function
└── tasks/
    └── scoring.py      # run_materialize_score task wrapper

Getting Started

Website

Onboarding

Cron

Your Current Setup

Explore

Settings - Toggle

Settings - Business

Settings - Team

Settings - Billing

Settings - Domain

Webhooks

Health

Manual Trigger

Purpose

Function Signature

Parameters

Returns

What It Does

Database Schema

Code Location

​Purpose

​Function Signature

​Parameters

​Returns

​What It Does

​Database Schema

​Code Location

Purpose

Function Signature

Parameters

Returns

What It Does

Database Schema

Code Location