dataforseo-serp — Claude Code skill: SERP analysis
The dataforseo-serp Claude Code skill gathers search results and groups queries by the pages that rank for them. Run it to map keyword intent, spot competing pages, or find sources cited by AI Overviews.
no license 399 installs ★ 1,797 updated 2026-11-16
npx skills add Illyism/seo-skills --skill dataforseo-serp -a claude-codeWhat dataforseo-serp does
The skill retrieves Google results, search volume, and CPC through DataForSEO. It can also collect references from AI Overviews and citations in LLM answers. For keyword clusters, it compares the top-ten URLs for each query to decide which terms belong on one page and which need separate pages.
It writes project files such as keyword-clusters.json and a content map. DataForSEO can be connected through MCP tools or the REST API. REST access requires DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD; with neither connection available, web search is an option for lists under 10 queries, but CPC filters are skipped.
For lists of 10 queries or more, the skill stops and asks for DataForSEO credentials if the service is unavailable. It tracks API costs and stops when the supplied budget is exceeded, or at $5 when no budget was given.
What it helps with
- group queries by overlapping top-ten ranking URLs
- separate keywords that call for different page types
- find domains cited by AI Overviews and LLM answers
- map keyword clusters to existing project pages
Example prompts for the agent
- Cluster these keywords by overlapping Google results and save them to
seo/keyword-clusters.json. - Check which pages rank for these queries and create a content map.
- Find the sources cited by AI Overviews and ChatGPT answers on this topic.
How to install dataforseo-serp
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill dataforseo-serp -a claude-code2Manually: put the files in place
~/.claude/skills/dataforseo-serp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/dataforseo-serp/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill dataforseo-serp -a codex2Manually: put the files in place
.agents/skills/dataforseo-serp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill dataforseo-serp -a cursor2Manually: put the files in place
.cursor/skills/dataforseo-serp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Illyism/seo-skills seo/dataforseo-serp/SKILL.md2Manually: put the files in place
.github/skills/dataforseo-serp/SKILL.md1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill dataforseo-serp -a gemini-cli2Platform CLI
gemini skills install https://github.com/Illyism/seo-skills --path seo/dataforseo-serpManually: put the files in place
.devin/skills/dataforseo-serp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill dataforseo-serp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about dataforseo-serp
How do I install dataforseo-serp in Claude Code?
Run npx skills add Illyism/seo-skills --skill dataforseo-serp -a claude-code. The skill file is installed at ~/.claude/skills/dataforseo-serp/SKILL.md.
What does dataforseo-serp do?
It collects search results, keyword volume, and CPC, then clusters queries using shared URLs in the top ten. It can also identify references in AI Overviews and citations in LLM answers.
What does dataforseo-serp need to run?
Connect DataForSEO MCP tools or provide DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD for REST access. Web search is a fallback for lists under 10 queries.