topic-scorer

Server MCP yang menilai halaman atau draf berdasarkan 11.485 kategori taksonomi publik, mengembalikan peringkatnya untuk setiap taksonomi, dan memberi tahu frasa yang masih dibutuhkan. Gratis, tanpa kunci.

Server MCP Terhosting

npx add-mcp 'https://topic-scorer.pixelcove.co/mcp'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

How it works

Three steps take a draft from a target category to a list of edits.

  1. Look up the category id

    topic_scorer_find searches all six taxonomies by substring and returns matching ids and paths.
  2. Score the text against the target

    topic_scorer_score takes up to 32,768 characters of text or HTML. One embedding, cosine similarity to every category, ranked per taxonomy.
  3. Act on the rank and the phrase bank

    Read the rank and the gap to #1 rather than the raw score. Work the unused phrases into the draft, then score it again.

topic-scorer measures topical alignment. It doesn't predict where a page ranks in a search engine.

Taxonomies covered

Six public taxonomies, loaded whole. Every call ranks your text inside all of them.

TAXONOMYCATEGORIES
Google Ads Topics2,558
Google Merchant5,595
IAB Content 3.1704
IAB Audience 1.11,558
IAB Ad Product 2.0583
LinkedIn Industries v2487

total 11,485 categories / one embedding at 768 dimensions

Tools

Five tools on one endpoint. Text goes in as text: topic-scorer never fetches a URL for you.

TOOLWHAT IT RETURNS
topic_scorer_taxonomiesThe six taxonomies with their label and category count.
topic_scorer_findCategories whose path contains your query, with the id you pass to the scoring tools.
topic_scorer_scoreTop categories per taxonomy, plus the target's rank, score, gap to #1, and a phrase bank split into used and unused.
topic_scorer_gateA pass or fail against a rank threshold, for content pipelines that block a draft until it clears.
topic_scorer_phrasesThe ranked phrase bank for one category: 1 to 4 word phrases a page on that topic contains.

Limits

Every tool is free. Daily caps keep the embedding bill bounded, and all five tools count toward them.

LIMITVALUE
Calls per caller50 per UTC day
Calls across all callers1,000 per UTC day
Text lengthup to 32,768 characters

Connect

Point any MCP client at the endpoint over streamable HTTP. You need no key.

MCP client config

MCP CLIENT CONFIG

{
  "mcpServers": {
    "topic-scorer": {
      "type": "http",
      "url": "https://topic-scorer.pixelcove.co/mcp"
    }
  }
}

Lookup with curl

CURL / TOPIC_SCORER_FIND

curl -sS https://topic-scorer.pixelcove.co/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"tools/call",
       "params":{"name":"topic_scorer_find",
         "arguments":{"query":"network security",
           "taxonomy":"google_ads_topics"}}}'

You get back the category id and its full path. Pass that id as category to topic_scorer_score, topic_scorer_gate, or topic_scorer_phrases.