Skip to content

v0.9.2 — Discovery + AI/GEO

Latest
Latest

Choose a tag to compare

View all tags
@mailnike mailnike released this 20 Jun 01:04
v0.9.2
e2ad0c6

SEOMonster v0.9.2 — Discovery + AI/GEO

The biggest release since the technical-SEO line: SEOMonster goes from "diagnose my own data" to "discover what I don't, and prove it moved" — including the AI answer surfaces (ChatGPT, Perplexity, Gemini, Google AI Overviews). 11 new tools across four tracks — 59 → 70 tools.

Everything new keeps the project's design law: tools stay deterministic and data-grounded (the host LLM does the generative/semantic work), every score is banded + evidence-tagged (causal / correlational / informational — never a false-precision number), and the free GSC / GA4 / HTTP core needs no new keys. The optional vendors are pluggable and degrade gracefully.

What's new

Track A — AI / GEO citation

  • ai_citation_readiness — is a page structured to be cited by LLM answer engines? Leads with a render-blindness check (AI crawlers don't run JS), then scores evidence-backed signals (statistics, quotations, cited sources, no keyword-stuffing). Reports schema.org / FAQ / llms.txt as informational only — the 2026 evidence doesn't support them as AI-citation drivers. Free.
  • ai_referral_overview — GA4 referral sessions from AI apps (native ai-assistant channel + source regex) and AI-crawler robots coverage (GPTBot/ClaudeBot/PerplexityBot…). Surfaces the ~70% dark-traffic undercount. Free.
  • ai_citation_track — sampled brand share-of-voice across Perplexity / OpenAI / Anthropic / Gemini + Google AI Overviews for a managed prompt set, with a 95% confidence interval and run-to-run volatility — not an "AI rank" (single runs are statistically meaningless). Honest about the API-vs-UI gap. Optional engine keys / DataForSEO.

Track B — net-new keyword discovery

  • gsc_keyword_expand — ground host-brainstormed candidates against your own Search Console data; net-new terms with no visible footprint, scored by sibling-strength. Free.
  • serp_adjacency_expand — Google Autocomplete (free core) + optional People-Also-Ask / related searches.
  • keyword_universe — competitor keyword gap (the one thing no Google product gives you) + volume/difficulty/intent. Optional (DataForSEO; Google Ads for volume).

Track C — content winnability

  • content_brief_data — competitor heading union, median word-count floor, schema, entities, and 2026 GEO writing directives, so the host writes the brief from evidence. Free.
  • topic_cluster_map — four-quadrant gap (defend / optimize / create / monitor) from your own GSC data; the create quadrant is your missing-subtopic list. Free.
  • content_opportunities gains an additive winnability block (existing fields unchanged).

Track D — close the loop

  • internal_link_recommend — specific source→target internal links from high-authority pages to striking-distance pages, with anchor text and over-optimization guards. Free.
  • rank_change_attribution — did a change move the needle? Difference-in-differences vs a matched control group, a 95% CI, a three-state verdict, and a confounders block that auto-detects the 2025 GSC data-regime breaks. Observational, never a causal claim. Free.
  • onpage_serp_gap — the headings / entities / schema the top results have that your page lacks, as concrete actions. Free with caller URLs; optional SERP auto-fetch adds zero-click-risk + competitor-authority signals.

Optional providers (all pluggable; the core works without them)

  • DataForSEO (DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD) — SERP/PAA, keyword volume/difficulty/intent, competitor gap, Google AIO.
  • Open PageRank (OPENPAGERANK_API_KEY) — free competitor domain authority.
  • AI engines (PERPLEXITY_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY) — for ai_citation_track (any subset).
  • Google Ads (GOOGLE_ADS_DEVELOPER_TOKEN / GOOGLE_ADS_CUSTOMER_ID) — volume alternative to DataForSEO.

Quality & validation

  • Validated live across three rounds against a real portfolio: the full free GSC/GA4/HTTP surface, then the paid surface (DataForSEO + Open PageRank + Gemini) — ai_citation_track ran 42 live queries with full statistical machinery. All findings closed.
  • New system_status tool groups (ai, content, discovery) and optional services (dataforseo, openpagerank, google_ads, ai_engines).
  • 567 tests, ruff clean, security review clean. No breaking changes — every existing tool keeps its contract.

Upgrade

uvx seo-monster@latest        # or your host's MCP config / the .mcpb bundle

No config changes required; the new providers are opt-in. Call system_status to see what's configured.

Full details in CHANGELOG.md.

Assets 5
Loading