{"uid":"cap_TowAK94L_4eMxFocAaUcV","slug":"topic-scorer-taxonomy-scoring-over-mcp-by-pixelcove-468f61fd","name":"topic-scorer: Taxonomy Scoring over MCP by PixelCove","description":"An MCP server that scores a page or draft against 11,485 public taxonomy categories, returns its rank per taxonomy, and gives you the phrases it still needs. $0.05 per call.","url":"https://topic-scorer.pixelcove.co/v1/score?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"per":{"type":"integer","default":10,"maximum":25,"minimum":1,"description":"Rows per taxonomy."},"full":{"type":"boolean","default":false,"description":"Score the whole text as the mean of 8,192-char chunks instead of only the first 8,192 chars."},"text":{"type":"string","maxLength":32768,"minLength":1,"description":"The page or draft text to score, as plain text or HTML (tags are stripped). 1 to 32768 characters. URLs are not fetched; send the content."},"phrases":{"type":"integer","default":30,"maximum":100,"minimum":0,"description":"Phrase bank size for the target category (0 skips it)."},"category":{"type":"string","maxLength":200,"minLength":1,"description":"Target category id, full path, or a unique path substring within the taxonomy (use topic_scorer_find to look one up)."},"taxonomy":{"enum":["google_ads_topics","google_merchant","iab_content","iab_audience","iab_ad_product","linkedin_industries"],"type":"string","description":"Taxonomy of the target category."}}},"responseSchema":{"type":"json","example":{"chars":5120,"model":"gemini-embedding-001","target":{"id":"344","path":"Computers & Electronics > Computer Security > Network Security","rank":1,"score":0.842,"gap_to_top":0},"phrases":{"used":["firewall"],"unused":["intrusion detection"]},"taxonomies":{"google_ads_topics":{"top":[{"id":"344","path":"...","rank":1,"score":0.842}],"count":2558,"label":"Google Ads Topics"}},"scored_chars":5120}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wKtgt6VVejDLktvDHyqx8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores a text document against 11,485 public taxonomy categories and returns ranked matches plus missing phrases needed to improve targeting.","exampleAgentPrompt":"Score this article against the google_ads_topics taxonomy, targeting the category 'Computers & Electronics > Computer Security > Network Security', and give me the top 10 results plus up to 30 phrases I still need to include: [paste article text here].","exampleUseCases":[{"title":"Ad targeting category check for landing page","prompt":"I just wrote a landing page about home solar panel installation — can you score it against the google_ads_topics taxonomy targeting 'Home & Garden > Home Improvement > Solar Energy' and tell me my rank plus what phrases I'm missing to rank #1?"},{"title":"IAB content classification for editorial article","prompt":"Here's a draft article about machine learning in healthcare. Score it against the iab_content taxonomy targeting 'Technology & Computing > Artificial Intelligence' and show me the top 10 matching categories and the 30 phrases it still needs."},{"title":"LinkedIn industry alignment check for B2B copy","prompt":"I need to know if my B2B SaaS homepage copy aligns with the 'Information Technology & Services' category in the linkedin_industries taxonomy — can you score it and tell me the rank and gap phrases?"}],"resultDescription":"Returns a JSON object containing: the number of characters scored, the embedding model used, the target category's rank and relevance score and gap to top, a phrase bank split into used and unused phrases for the target category, and a breakdown of top-ranked categories across the requested taxonomy with their IDs, full paths, ranks, and scores.","failureModes":["Text exceeds 32,768 character limit — request rejected","Category string does not uniquely match any taxonomy entry — use topic_scorer_find to resolve","Taxonomy enum value not recognized — must be one of the six supported values","Empty or whitespace-only text input — minimum 1 character required","Payment not completed — x402 payment of $0.05 USDC required per call","Text too short to produce meaningful embeddings — low-confidence scores returned"],"whenToPreferThis":"Choose this endpoint when you need precise, ranked placement of a piece of content within a named public taxonomy (Google Ads Topics, IAB Content, IAB Audience, IAB Ad Product, Google Merchant, or LinkedIn Industries) and want actionable phrase suggestions to improve category relevance. It is ideal for content optimization workflows, ad targeting validation, and programmatic SEO. Prefer it over generic keyword tools when you need structured taxonomy-level scoring with a gap analysis, not just keyword density or raw similarity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:43:05.516Z","isFirstParty":false,"canonicalSlug":"topic-scorer-taxonomy-scoring-over-mcp-by-pixelcove-468f61fd"}