tuyv seo-seranking
Live AI visibility tracking via the SE Ranking REST API.
Prerequisites
- Run
extensions/seranking/install.sh(orinstall.ps1). - An SE Ranking API key (https://seranking.com/api.html).
- Before any call, verify
SERANKING_API_KEYis present in~/.claude/settings.jsonunderenv.. If absent, tell the user to run the installer.
Routing
| Command | Purpose |
|---|---|
/seo seranking ai-visibility <brand> |
Share-of-voice for brand across ChatGPT, Gemini, Perplexity, AI Overviews, AI Mode |
/seo seranking serp <keyword> |
Top 100 organic positions + SERP features |
/seo seranking backlinks <url> |
Backlink profile (alternative vendor source to Ahrefs / DataForSEO) |
/seo seranking competitors <url> |
Top 10 organic competitors and shared-keyword gaps |
AI Share-of-Voice scoring
SE Ranking samples each AI platform's responses for brand mentions across a configurable prompt set. The scorer is the same logic used by Profound / Peec AI but bundled into one MCP/API. Output fields:
chatgpt_sov: % of sampled prompts where the brand appears in the response.gemini_sov: same, against Google Gemini.perplexity_sov: same, against Perplexity.ai_overviews_sov: brand citation rate inside Google AI Overviews.ai_mode_sov: brand citation rate inside Google AI Mode (US English first).
Report each as a percentage with a confidence note based on sample size.
Cost guardrails
SE Ranking API uses unit accounting. Single AI visibility query is
~5 units (1 per platform). Use "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py to log
spend across vendors.
Cross-skill delegation
- For traditional backlinks + content audit, fall back to
seo-backlinks/seo-content. - For platform-specific deep-dives (ChatGPT only, Perplexity only), prefer the dedicated
seo-geoskill which has Brand Mention Correlation guidance.