# topic-scorer

> Score a page or draft against 11,485 public taxonomy categories (Google Ads Topics, Google Merchant, IAB Content 3.1, IAB Audience 1.1, IAB Ad Product 2.0, LinkedIn Industries v2) by embedding similarity, rank it per taxonomy, and get the phrases that pull it toward a target category. A topical-alignment check for content briefs and SEO/GEO audits, not a ranking predictor.

## Tools

- **topic_scorer_taxonomies** (Free): Lists the six taxonomies with their label and category count. Free. Call it first to pick the taxonomy for topic_scorer_find.
- **topic_scorer_find** (Free): Finds categories whose path contains the query (case-insensitive substring), optionally within one taxonomy. Free. Returns up to `limit` hits with id and path; pass the id as `category` to the paid tools.
- **topic_scorer_score** ($0.05/call): Scores text against every category in all six taxonomies (one embedding, cosine similarity) and returns the top `per` rows per taxonomy. With `taxonomy` and `category` it also returns the target's rank, score, gap to #1, and a phrase bank split into phrases the text already uses and phrases it does not. Read the rank and the gap, not the raw percent (scores compress into a 70 to 90 band). Paid, $0.05/call; read-only and safe to retry.
- **topic_scorer_gate** ($0.05/call): Pass/fail check: does the text rank within the top `min_rank` categories of its target taxonomy? Returns `pass`, the target's rank and gap to #1, the taxonomy's top five, and the unused phrases to work in. Use it as a content-pipeline gate. Paid, $0.05/call; read-only and safe to retry.
- **topic_scorer_phrases** ($0.05/call): Returns the ranked phrase bank for one category: 1 to 4 word phrases a page squarely about that category would contain, ordered by similarity to the category. Use it to seed a brief. Paid, $0.05/call; read-only and safe to retry.

## Links

- [MCP endpoint](https://topic-scorer.pixelcove.co/mcp)
- [Documentation](https://github.com/PixelCove/topic-scorer#readme)
- Contact: jon@pixelcove.co