Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AgricIDaniel/claude-seo/llms.txt

Use this file to discover all available pages before exploring further.

Claude SEO v2 shipped five new MCP extensions in Phase E of the release: Ahrefs (official @ahrefs/mcp backlink and organic data), SE Ranking (AI Share-of-Voice across all five major AI platforms), Profound (LLM citation time-series), Bing Webmaster Tools with IndexNow unified submission, and Unlighthouse (MIT-licensed multi-page Lighthouse runner). Each installs independently with a single script; none require the others to be present. Together they close the gaps left by the core plugin and the three v1 extensions: competitive backlink intelligence, AI visibility measurement, non-Google indexing speed, and site-wide Lighthouse coverage.

Ahrefs

The official @ahrefs/mcp server (first published April 2025) connects Claude SEO directly to Ahrefs’ backlink index and organic keyword data. It supports both local mode (credentials in ~/.claude/settings.json) and remote mode (Ahrefs-hosted endpoint). The seo-ahrefs skill pairs with the existing seo-backlinks skill for multi-source confidence weighting: when Ahrefs and the Moz/Bing/Common Crawl sources disagree on a metric, the skill trusts Ahrefs and notes the discrepancy in the report.

What it adds

CommandData
/seo ahrefs metrics <url>Domain Rating, URL Rating, referring domain count, organic traffic estimate
/seo ahrefs backlinks <url>Top referring domains, anchor distribution, follow/nofollow ratio
/seo ahrefs organic <url>Organic keywords, ranking distribution, traffic by country
/seo ahrefs content <topic>Content Explorer top results, social shares, referring domains

Install

1

Run the installer

./extensions/ahrefs/install.sh
2

Enter your Ahrefs API token at the prompt

The installer verifies Python 3 and Node 18+ are on $PATH, prompts for your Ahrefs API token (input is hidden), pre-warms @ahrefs/mcp@0.0.11 via npx --yes, copies the seo-ahrefs skill into ~/.claude/skills/, and atomically writes mcpServers.ahrefs into ~/.claude/settings.json with the token in the env block.
3

Restart Claude Code and verify

/seo ahrefs metrics https://example.com
Ahrefs charges per “unit”. Most read endpoints (domain metrics, backlink data) cost 1 unit each; bulk endpoints cost more. Get an API token at ahrefs.com/api. To rotate your token, re-run the installer — it overwrites only the AHREFS_API_TOKEN value and leaves the rest of settings.json intact.
To uninstall:
./extensions/ahrefs/uninstall.sh

SE Ranking

SE Ranking’s API covers traditional SEO data (SERP positions, backlinks, competitors) plus AI Share-of-Voice across all five AI platforms — ChatGPT, Gemini, Perplexity, AI Overviews, and AI Mode — in a single query. This is the broadest AI citation coverage of any vendor currently available: most tools cover one or two platforms; SE Ranking covers all five simultaneously. A single AI visibility query costs approximately 5 units (1 per platform).

What it adds

CommandPurpose
/seo seranking ai-visibility <brand>Share-of-Voice for a brand across ChatGPT, Gemini, Perplexity, AI Overviews, and AI Mode
/seo seranking serp <keyword>Top 100 organic positions + SERP features
/seo seranking backlinks <url>Backlink profile (free-tier alternative to Ahrefs / DataForSEO)
/seo seranking competitors <url>Top 10 organic competitors and shared-keyword gaps
The ai-visibility output fields:
  • chatgpt_sov — % of sampled prompts where the brand appears in the ChatGPT 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)
Each metric is reported as a percentage with a confidence note based on sample size.

Install

1

Run the installer

./extensions/seranking/install.sh
The installer prompts for your SE Ranking API key (hidden input), copies the seo-seranking skill into ~/.claude/skills/, and writes env.SERANKING_API_KEY into ~/.claude/settings.json with 0o600 permissions.
2

Get an API key

API keys are available at seranking.com/api. Pricing is unit-based.
3

Restart Claude Code and verify

/seo seranking ai-visibility "your brand"
To uninstall:
./extensions/seranking/uninstall.sh

Profound

Profound (tryprofound.com) is purpose-built for LLM brand-mention tracking as a time-series. Where SE Ranking samples AI platforms on demand for a snapshot, Profound continuously polls and publishes week-over-week and month-over-month trend data. This makes it the right tool when you need to know whether your AI citation rate is trending up or down — not just where it stands today. Profound covers ChatGPT and Perplexity natively with deep coverage; for Gemini, AI Overviews, and AI Mode, pair it with SE Ranking.

What it adds

CommandPurpose
/seo profound citations <brand>Current citation rate per LLM + 30-day trend
/seo profound prompts <brand>Top prompts that surface (or fail to surface) the brand
/seo profound competitors <brand>Brands cited alongside yours for the same prompts
/seo profound alerts <brand>Spike/drop alerts vs. the 7-day baseline

Install

1

Run the installer

./extensions/profound/install.sh
The installer stores PROFOUND_API_KEY in ~/.claude/settings.json with 0o600 permissions.
2

Restart Claude Code and verify

/seo profound citations "your brand"
To uninstall:
./extensions/profound/uninstall.sh

SE Ranking vs. Profound: when to use which

Use ProfoundUse SE Ranking
Trend analysis — week-over-week brand mention driftSingle-shot Share-of-Voice measurement
ChatGPT + Perplexity deep coverageAll 5 platforms in one call
Spike/drop alerts when citation rate changesCompetitor keyword gap analysis
Long-term benchmark trackingQuick AI visibility check before a campaign
The two tools are complementary, not redundant. Install both for full AI visibility coverage; if budget-constrained, start with SE Ranking for breadth and add Profound when you need trend data.

Bing Webmaster + IndexNow

The Bing Webmaster extension adds three capabilities: Bing Webmaster Tools API access (inbound links, crawl stats, search keywords, competitor link comparison), IndexNow unified URL submission (a single POST that notifies Bing, Yandex, Seznam, and Naver simultaneously), and Microsoft Copilot citation eligibility — because Copilot pulls citations from the Bing index, pages not in Bing cannot be cited.
Google rejects IndexNow (confirmed by Gary Illyes across multiple Search Off The Record episodes in 2024–2025). This extension is specifically for Bing, Yandex, Seznam, and Naver indexing and Microsoft Copilot AI citation, not Google.

What it adds

CommandWhat it does
/seo bing links <url>Inbound links from Bing Webmaster Tools
/seo bing compare <urlA> <urlB>Competitor link comparison via Bing
/seo bing submit <url>Submit a single URL via IndexNow
/seo bing submit-batch <file>Batch-submit a file of URLs via IndexNow
/seo bing verify-indexnowVerify the IndexNow key file is correctly published

Install

1

Run the installer

./extensions/bing-webmaster/install.sh
You will be prompted for:
  • Bing Webmaster Tools API key — get one at bing.com/webmasters/api
  • IndexNow host key — any random 32+ character string
  • IndexNow keyLocation URL — the URL where you will serve the key file
Either group can be left blank if you only want one of the two capabilities.
2

Set up the IndexNow key file

IndexNow requires a key file served at your site root. Generate a key, save it as a .txt file, and publish it:
# Generate a key
openssl rand -hex 32

# Save the key to a file named <key>.txt at your site root
# The file body must be the key string itself
# Example: https://example.com/abc123def456.txt
3

Verify the key file

/seo bing verify-indexnow
This fetches your keyLocation URL and confirms the body matches your key — the most common onboarding mistake is a mismatch here.
4

Submit new URLs

/seo bing submit https://example.com/new-page
IndexNow gets a page into Bing within minutes versus Bing’s organic crawl, which can take days. For new content launches this is a meaningful indexing speed advantage for Copilot citation eligibility.
To uninstall:
./extensions/bing-webmaster/uninstall.sh

Unlighthouse

Unlighthouse is an MIT-licensed multi-page Lighthouse runner that crawls a site and runs Lighthouse against every URL, producing a single aggregate report. It requires no API key, no credentials, and no network egress beyond crawling the target site. It is the right tool when PageSpeed Insights’ free quota (25k requests per day) isn’t enough for a large site, or when you want offline CI-integrated Lighthouse measurement after every deploy.
Unlighthouse runs Lighthouse lab tests locally. For trustworthy Core Web Vitals measurement on production traffic, prefer PageSpeed Insights and CrUX (which use real Chrome user data). Use Unlighthouse for site-wide coverage and regression checking, not as a substitute for field data.

What it adds

CommandEffect
/seo unlighthouse <url>Mobile audit across up to 200 routes, JSON + HTML report
/seo unlighthouse <url> --device desktopDesktop form factor
/seo unlighthouse <url> --max-routes 50 --output-dir ./reportsCap route count and persist the report
Aggregate output fields from ci-result.json:
  • score.performance — median across all audited routes
  • score.accessibility, score.bestPractices, score.seo
  • Per-route breakdown available in the output directory

Install

1

Run the installer

./extensions/unlighthouse/install.sh
The installer verifies Python 3 and Node 18+, pre-warms unlighthouse@0.13.5 via npx --yes, and copies the seo-unlighthouse skill into ~/.claude/skills/. No settings.json changes are needed — Unlighthouse requires no API credentials.
2

Restart Claude Code and run a test audit

/seo unlighthouse https://example.com --max-routes 5
To uninstall:
./extensions/unlighthouse/uninstall.sh

Unlighthouse vs. PageSpeed Insights

Use UnlighthouseUse PageSpeed Insights
Site has hundreds of pages and you want every one auditedSingle-URL focused audit
Offline or restricted environmentField data from real Chrome users (CrUX)
CI-driven regression check after a deployQuick one-off check
No API quota concernPSI quota is fine for small sites
Free, no account neededFree, Google account optional

Build docs developers (and LLMs) love