{"uid":"cap_SaQgwUtJ-XU7k96Bh_p3g","slug":"topic-scorer-taxonomy-phrase-recommender-6df00015","name":"topic-scorer: Taxonomy Phrase Recommender","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/phrases?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"n":{"type":"integer","default":30,"maximum":100,"minimum":1,"description":"Bank size."},"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":{"id":"344","path":"...","phrases":["firewall","intrusion detection"],"taxonomy":"google_ads_topics"}},"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_SkjLS8hqqk7BXCctKyBJu","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":"Returns the ranked taxonomy category for a page or draft and lists the key phrases it still needs to rank higher in that category.","exampleAgentPrompt":"Score my blog draft about network security and tell me which phrases I'm still missing to rank in the 'Computers & Electronics/Network Security' category of Google Ads Topics taxonomy — give me the top 30 phrases.","exampleUseCases":[{"title":"SEO gap analysis for a blog post","prompt":"I just wrote a draft about home espresso machines — score it against the google_ads_topics taxonomy for the 'Food & Drink/Coffee & Tea' category and tell me the 30 phrases it still needs to rank well there."},{"title":"Ad targeting alignment check","prompt":"Check my product description against the google_merchant taxonomy for the 'Apparel & Accessories/Shoes' category and list the top 20 phrases I should add to make it rank in that category."},{"title":"Content strategy for LinkedIn audience","prompt":"I'm writing a piece targeting software engineers on LinkedIn — score it against the linkedin_industries taxonomy for 'Software Development' and show me the 25 missing phrases I need to include."}],"resultDescription":"A JSON object containing the matched taxonomy category id, its full path within the taxonomy, the taxonomy name, and an ordered list of phrases (up to n, max 100) that the content is currently missing but needs to rank well in that category.","failureModes":["Unknown or ambiguous category substring returns an error — use topic_scorer_find to resolve the correct category id first","Invalid taxonomy enum value causes a 400-level error","n out of range (must be 1–100) returns a validation error","Malformed or missing required fields (category, taxonomy) cause request rejection","Payment failure or insufficient funds returns a 402 error before processing"],"whenToPreferThis":"Choose this endpoint when you need concrete phrase-level recommendations to improve a page's ranking within a specific known taxonomy category — it's distinct from a simple pass/fail check (use the sibling endpoint for that) and is ideal for content gap analysis, SEO optimization loops, and ad targeting alignment workflows where you know the target category and want actionable missing terms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:45:36.243Z","isFirstParty":false,"canonicalSlug":"topic-scorer-taxonomy-phrase-recommender-6df00015"}