$npx -y skills add AgriciDaniel/claude-seo --skill seo-dataforseoLive SEO data via DataForSEO MCP server: SERP analysis, keyword research (volume, difficulty, intent, trends), backlink profiles, on-page analysis, competitor and content analysis, business listings, AI visibility (LLM mention tracking), and domain analytics. Requires DataForSEO
| 1 | # DataForSEO: Live SEO Data (Extension) |
| 2 | |
| 3 | Live search data via the DataForSEO MCP server. Provides real-time SERP results |
| 4 | (organic + images), keyword metrics, backlink profiles, on-page analysis, content |
| 5 | analysis, business listings, AI visibility checking, and LLM mention tracking |
| 6 | across 9 API modules with 79+ MCP tools. |
| 7 | |
| 8 | ## Prerequisites |
| 9 | |
| 10 | This skill requires the DataForSEO extension to be installed: |
| 11 | ```bash |
| 12 | ./extensions/dataforseo/install.sh |
| 13 | ``` |
| 14 | |
| 15 | **Check availability:** Before using any DataForSEO tool, verify the MCP server |
| 16 | is connected by checking if `serp_organic_live_advanced` or any DataForSEO tool |
| 17 | is available. If tools are not available, inform the user the extension is not |
| 18 | installed and provide install instructions. |
| 19 | |
| 20 | ## API Credit Awareness |
| 21 | |
| 22 | DataForSEO charges per API call. Be efficient: |
| 23 | - Prefer bulk endpoints over multiple single calls |
| 24 | - Use default parameters (US, English) unless user specifies otherwise |
| 25 | - Cache results mentally within a session; don't re-fetch the same data |
| 26 | - Warn user before running expensive operations (full backlink crawls, large keyword lists) |
| 27 | |
| 28 | ## Cost Guardrails |
| 29 | |
| 30 | **Before every DataForSEO MCP call**, run cost estimation: |
| 31 | ``` |
| 32 | claude-seo run dataforseo_costs.py check <endpoint> [--count N] |
| 33 | ``` |
| 34 | |
| 35 | - If `"status": "approved"` → proceed with the API call |
| 36 | - If `"status": "needs_approval"` → show the cost estimate to the user and ask for confirmation before proceeding |
| 37 | - If `"status": "blocked"` → inform the user that the daily budget limit would be exceeded; do NOT proceed |
| 38 | |
| 39 | **After each API call completes**, log the cost: |
| 40 | ``` |
| 41 | claude-seo run dataforseo_costs.py log <endpoint> <actual_cost> |
| 42 | ``` |
| 43 | |
| 44 | **User commands for cost management:** |
| 45 | - `/seo dataforseo costs today` → show today's spending breakdown |
| 46 | - `/seo dataforseo costs summary` → show 7-day spending history |
| 47 | - `/seo dataforseo costs config --mode threshold --threshold 0.50` → configure approval mode |
| 48 | |
| 49 | Load `references/cost-tiers.md` for the full pricing table, budget presets, and cost reduction tips. |
| 50 | |
| 51 | ## Quick Reference |
| 52 | |
| 53 | | Command | What it does | |
| 54 | |---------|-------------| |
| 55 | | `/seo dataforseo serp <keyword>` | Google organic SERP results | |
| 56 | | `/seo dataforseo serp-images <keyword>` | Google Images SERP results | |
| 57 | | `/seo dataforseo serp-youtube <keyword>` | YouTube search results | |
| 58 | | `/seo dataforseo youtube <video_id>` | YouTube video deep analysis | |
| 59 | | `/seo dataforseo keywords <seed>` | Keyword ideas and suggestions | |
| 60 | | `/seo dataforseo volume <keywords>` | Search volume for keywords | |
| 61 | | `/seo dataforseo difficulty <keywords>` | Keyword difficulty scores | |
| 62 | | `/seo dataforseo intent <keywords>` | Search intent classification | |
| 63 | | `/seo dataforseo trends <keyword>` | Google Trends data | |
| 64 | | `/seo dataforseo backlinks <domain>` | Full backlink profile | |
| 65 | | `/seo dataforseo competitors <domain>` | Competitor domain analysis | |
| 66 | | `/seo dataforseo ranked <domain>` | Ranked keywords for domain | |
| 67 | | `/seo dataforseo intersection <domains>` | Keyword/backlink overlap | |
| 68 | | `/seo dataforseo traffic <domains>` | Bulk traffic estimation | |
| 69 | | `/seo dataforseo subdomains <domain>` | Subdomains with ranking data | |
| 70 | | `/seo dataforseo top-searches <domain>` | Top queries mentioning domain | |
| 71 | | `/seo dataforseo onpage <url>` | On-page analysis (Lighthouse + parsing) | |
| 72 | | `/seo dataforseo tech <domain>` | Technology stack detection | |
| 73 | | `/seo dataforseo whois <domain>` | WHOIS registration data | |
| 74 | | `/seo dataforseo content <keyword/url>` | Content analysis and trends | |
| 75 | | `/seo dataforseo listings <keyword>` | Business listings search | |
| 76 | | `/seo dataforseo ai-scrape <query>` | ChatGPT web scraper for GEO | |
| 77 | | `/seo dataforseo ai-mentions <keyword>` | LLM mention tracking for GEO | |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ## SERP Analysis |
| 82 | |
| 83 | ### `/seo dataforseo serp <keyword>` |
| 84 | |
| 85 | Fetch live Google organic search results. |
| 86 | |
| 87 | **MCP tools:** `serp_organic_live_advanced` |
| 88 | |
| 89 | **Default parameters:** location_code=2840 (US), language_code=en, device=desktop, depth=100 |
| 90 | |
| 91 | **Also supports:** The `serp_organic_live_advanced` tool supports Google, Bing, and Yahoo via the `se` parameter. Specify "bing" or "yahoo" to switch search engines. |
| 92 | |
| 93 | **Output:** Rank, URL, title, description, domain, featured snippets, AI overview references, People Also Ask. |
| 94 | |
| 95 | ### `/seo dataforseo serp-youtube <keyword>` |
| 96 | |
| 97 | Fetch YouTube search results. Valuable for GEO. YouTube mentions correl |