# dataforseo-serp

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 399 installs · ★ 1797 repo stars
- Author: illyism
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Illyism/seo-skills/tree/HEAD/seo/dataforseo-serp/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/dataforseo-serp

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill dataforseo-serp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/dataforseo-serp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/dataforseo-serp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill dataforseo-serp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/dataforseo-serp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill dataforseo-serp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/dataforseo-serp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Illyism/seo-skills seo/dataforseo-serp/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/dataforseo-serp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill dataforseo-serp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Illyism/seo-skills --path seo/dataforseo-serp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/dataforseo-serp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill dataforseo-serp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Illyism/seo-skills/tree/HEAD/seo/dataforseo-serp/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [seo-dataforseo](https://affpapa.org/en/nevibecode/skills/seo-dataforseo.md) — skill · 7200 installs
- [DataForSEO MCP](https://affpapa.org/en/nevibecode/mcp/dataforseo-mcp.md) — MCP server
- [target-serp](https://affpapa.org/en/nevibecode/skills/target-serp.md) — skill · 2000 installs
- [serp-analysis](https://affpapa.org/en/nevibecode/skills/aaron-he-zhu-serp-analysis.md) — skill · 1600 installs
- [serp-features](https://affpapa.org/en/nevibecode/skills/serp-features.md) — skill · 1100 installs
- [finding-content-gaps-from-google-serp](https://affpapa.org/en/nevibecode/skills/finding-content-gaps-from-google-serp.md) — skill · 911 installs

From the same set: [illyism/seo-skills](https://affpapa.org/en/nevibecode/by/illyism/seo-skills.md) — 29 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
