topic-scorer
Một MCP server chấm điểm trang hoặc bản nháp theo 11,485 danh mục phân loại công khai, trả về thứ hạng của trang hoặc bản nháp trong từng hệ thống phân loại và cung cấp các cụm từ còn thiếu. Miễn phí, không cần khóa.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://topic-scorer.pixelcove.co/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
How it works
Three steps take a draft from a target category to a list of edits.
-
Look up the category id
topic_scorer_findsearches all six taxonomies by substring and returns matching ids and paths. -
Score the text against the target
topic_scorer_scoretakes up to 32,768 characters of text or HTML. One embedding, cosine similarity to every category, ranked per taxonomy. -
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.
| TAXONOMY | CATEGORIES |
|---|---|
| Google Ads Topics | 2,558 |
| Google Merchant | 5,595 |
| IAB Content 3.1 | 704 |
| IAB Audience 1.1 | 1,558 |
| IAB Ad Product 2.0 | 583 |
| LinkedIn Industries v2 | 487 |
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.
| TOOL | WHAT IT RETURNS |
|---|---|
| topic_scorer_taxonomies | The six taxonomies with their label and category count. |
| topic_scorer_find | Categories whose path contains your query, with the id you pass to the scoring tools. |
| topic_scorer_score | Top categories per taxonomy, plus the target's rank, score, gap to #1, and a phrase bank split into used and unused. |
| topic_scorer_gate | A pass or fail against a rank threshold, for content pipelines that block a draft until it clears. |
| topic_scorer_phrases | The 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.
| LIMIT | VALUE |
|---|---|
| Calls per caller | 50 per UTC day |
| Calls across all callers | 1,000 per UTC day |
| Text length | up 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.