A Claude Code skill that queries the DataForSEO API for SEO data — SERP results, keyword research, backlink analysis, domain analytics, content analysis, AI optimization, and more.
Ported from DataForSEO's official MCP server (TypeScript) into a single Python script with zero external dependencies (stdlib only, Python 3.10+). Covers 9 modules and 80 endpoints.
git clone https://github.com/codykingham/dataforseo-skill.git
cd dataforseo-skill
./install.shThis copies the skill into ~/.claude/skills/dataforseo/. Claude Code will pick it up automatically on the next session.
Set your DataForSEO API credentials as environment variables (e.g. in ~/.zshrc or ~/.bashrc):
export DATAFORSEO_USERNAME="your-login"
export DATAFORSEO_PASSWORD="your-api-password"Optional environment variables:
| Variable | Default | Description |
|---|---|---|
DATAFORSEO_FULL_RESPONSE |
false |
Return full API responses instead of AI-condensed |
DATAFORSEO_SIMPLE_FILTER |
false |
Use simplified filter syntax |
FIELD_CONFIG_PATH |
— | Path to a custom field config JSON for response filtering |
DEBUG |
false |
Enable debug logging to stderr |
Once installed, just ask Claude about SEO topics in natural language:
"What are the top-ranking pages for 'best coffee beans' in the US?"
"Show me the backlink profile for example.com"
"What's the search volume trend for 'ai agents' over the last 12 months?"
"Find competitor domains for nytimes.com"
Claude will automatically invoke the skill, pick the right endpoint, and return the results.
| Module | Endpoints | Description |
|---|---|---|
| SERP | 7 | Google/Bing/Yahoo organic SERP results and YouTube search |
| Keywords Data | 7 | Google Ads search volume, Google Trends, DataForSEO Trends |
| Backlinks | 20 | Backlink profiles, anchors, referring domains, competitors |
| DataForSEO Labs | 21 | Keyword research, competitor analysis, domain rankings |
| OnPage | 3 | Content parsing, instant page audits, Lighthouse scores |
| AI Optimization | 13 | LLM mentions tracking, AI search data, ChatGPT scraping |
| Business Data | 2 | Business listings search and filters |
| Domain Analytics | 4 | WHOIS data, technology stack detection |
| Content Analysis | 3 | Citation search, content summaries, phrase trends |
See the reference docs for detailed endpoint documentation.
Tests live at the repo root and don't get installed with the skill:
python -m pytest tests/ -vdataforseo-skill/
├── dataforseo/ # Installable skill (copied to ~/.claude/skills/)
│ ├── SKILL.md # Skill manifest with frontmatter
│ ├── scripts/
│ │ └── dataforseo.py # Single-file API client (stdlib only)
│ └── references/ # Endpoint documentation (10 files)
├── tests/ # Test suite (67 tests)
├── install.sh # One-command installer
└── README.md
MIT