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.
The DataForSEO extension connects Claude SEO to the official DataForSEO MCP server, unlocking 23 commands across 9 API modules: SERP analysis, keyword research, backlink profiles, on-page and technical analysis, competitor intelligence, content analysis, business listings, and AI visibility checking including live LLM mention tracking. Once installed, the core skills (/seo audit, /seo content, /seo geo, and others) detect DataForSEO availability automatically and upgrade their output to use real data instead of static analysis.
Prerequisites
- Claude SEO installed
- Node.js 20+
- A DataForSEO account with API credentials (new accounts include a free trial balance)
Installation
Clone the repo and navigate to it
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
Run the installer
Unix / macOS / Linux
Windows PowerShell
./extensions/dataforseo/install.sh
.\extensions\dataforseo\install.ps1
Enter your credentials at the prompt
The installer prompts for your DataForSEO username and password (input is hidden). It then installs the seo-dataforseo skill and agent files, configures the dataforseo-mcp-server entry in ~/.claude/settings.json, and pre-downloads the npm package so the first MCP call doesn’t spend time downloading.
Restart Claude Code
MCP servers load at session start. Restart Claude Code to activate the new server.
To verify the installation, run /seo dataforseo serp site:example.com in a new Claude Code session. If the MCP is not connected, the skill will output the exact install command.
Commands by module
SERP Analysis
| Command | Description |
|---|
/seo dataforseo serp <keyword> | Google organic SERP results (also supports Bing/Yahoo via se parameter) |
/seo dataforseo serp-images <keyword> | Google Images SERP results |
/seo dataforseo serp-youtube <keyword> | YouTube search results |
/seo dataforseo youtube <video_id> | YouTube video deep analysis (info, comments, subtitles) |
Keyword Research
| Command | Description |
|---|
/seo dataforseo keywords <seed> | Keyword ideas, suggestions, and related terms |
/seo dataforseo volume <keywords> | Search volume for a keyword list |
/seo dataforseo difficulty <keywords> | Keyword difficulty scores (0–100) |
/seo dataforseo intent <keywords> | Search intent classification (informational / navigational / commercial / transactional) |
/seo dataforseo trends <keyword> | Google Trends data over time |
Domain & Competitor Analysis
| Command | Description |
|---|
/seo dataforseo backlinks <domain> | Full backlink profile with spam scores |
/seo dataforseo competitors <domain> | Competing domains and traffic estimates |
/seo dataforseo ranked <domain> | Keywords a domain ranks for |
/seo dataforseo intersection <domains> | Keyword and backlink overlap across 2–20 domains |
/seo dataforseo traffic <domains> | Bulk traffic estimation |
/seo dataforseo subdomains <domain> | Subdomains with ranking data |
/seo dataforseo top-searches <domain> | Top queries mentioning a domain |
Technical / On-Page
| Command | Description |
|---|
/seo dataforseo onpage <url> | On-page analysis (Lighthouse + content parsing) |
/seo dataforseo tech <domain> | Technology stack detection |
/seo dataforseo whois <domain> | WHOIS registration data |
Content & Business Data
| Command | Description |
|---|
/seo dataforseo content <keyword/url> | Content analysis, phrase trends, and quality scoring |
/seo dataforseo listings <keyword> | Business listings search for local competitive analysis |
AI Visibility / GEO
| Command | Description |
|---|
/seo dataforseo ai-scrape <query> | ChatGPT web scraper — see which sources ChatGPT cites for a query |
/seo dataforseo ai-mentions <keyword> | LLM mention tracking across AI platforms |
All 9 API modules
| Module | Purpose | Commands |
|---|
| SERP | Live search engine results | serp, serp-images, serp-youtube, youtube |
| KEYWORDS_DATA | Search volume, trends | volume, trends |
| DATAFORSEO_LABS | Keyword research, competitor analysis | keywords, difficulty, intent, competitors, ranked, subdomains, top-searches, intersection, traffic |
| BACKLINKS | Link profiles and domain authority | backlinks |
| ONPAGE | Page analysis via Lighthouse | onpage |
| DOMAIN_ANALYTICS | Tech detection, WHOIS | tech, whois |
| BUSINESS_DATA | Business listings | listings |
| CONTENT_ANALYSIS | Content quality and phrase trends | content |
| AI_OPTIMIZATION | ChatGPT scraper, LLM mentions | ai-scrape, ai-mentions |
Cost guardrails
DataForSEO charges per API call. The extension ships with a field-config.json that trims API responses to SEO-relevant fields, reducing response size by approximately 75% and saving tokens on each call. Before every call the skill runs a cost estimation check; if an operation would exceed the configured daily budget it asks for confirmation before proceeding.
# Check today's spending
/seo dataforseo costs today
# Show 7-day spending history
/seo dataforseo costs summary
# Set a per-day approval threshold (example: $0.50)
/seo dataforseo costs config --mode threshold --threshold 0.50
| Endpoint type | Approximate cost |
|---|
| SERP (organic) | ~0.001–0.003 per request |
| Keyword research | ~0.0005–0.002 per keyword |
| Backlinks | ~0.002–0.01 per request |
| On-page / Lighthouse | ~0.01–0.05 per page |
| AI optimization | ~$0.01 per request |
New DataForSEO accounts include a free trial balance. See dataforseo.com/pricing for current rates. The intersection command with site: or filetype: operators on image SERP calls incurs a 5× cost multiplier — the skill will warn you before running those. Integration with core skills
When the DataForSEO extension is active, these core skills automatically pull live data:
/seo audit — real SERP, backlink, and on-page data instead of static estimates/seo technical — live on-page analysis and Lighthouse scores via DataForSEO/seo content — actual keyword volume, difficulty, and intent data/seo geo — ChatGPT scraper results and LLM mention tracking for AI visibility/seo plan — real competitor and keyword data for strategic planning
Uninstall
./extensions/dataforseo/uninstall.sh # macOS / Linux
.\extensions\dataforseo\uninstall.ps1 # Windows
~/.claude/settings.json.
Troubleshooting
| Symptom | Cause | Fix |
|---|
MCP server not connecting | Stale credentials or first-run cache miss | Run npx -y dataforseo-mcp-server to warm cache; re-run installer to reset credentials |
401 Unauthorized | Wrong username or password | Check ~/.claude/settings.json for the DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD env values |
402 Payment Required | Account out of credits | Add credits at app.dataforseo.com |
429 Rate Limited | Per-second quota hit | Wait a moment and retry; prefer bulk endpoints over repeated single calls |
| Module unavailable | ENABLED_MODULES missing a module | Re-run the installer — it writes all 9 modules to settings.json |
