SEO Agency Killer for Claude Code — powered by the DataForSEO API.
Replace the data layer of an SEO agency with one command.
Real Google data. No scraping. No browsing. No guesswork.
---
## What you get
**One command in. Real Google data out.** Type `/seo audit example.com` and Claude
fires five specialist subagents in parallel — each one pulls live data from
DataForSEO's APIs (keywords, SERPs, backlinks, on-page, domain analytics) — and
returns a composite SEO Score (0-100) with a prioritized action plan and a
client-ready PDF.
| Capability | Command |
|---|---|
| **Find local SEO clients** (ranked by closeability) | `/seo prospect ` |
| **Draft cold email** from audit findings | `/seo email ` |
| Full audit (composite score + PDF) | `/seo audit ` |
| 60-second snapshot | `/seo quick ` |
| Keyword research | `/seo keywords ` |
| Technical site crawl | `/seo technical ` |
| Competitor map | `/seo competitors ` |
| Content topical authority | `/seo content ` |
| Backlink profile + toxicity | `/seo backlinks ` |
| On-demand rank check | `/seo rankings kw1 kw2 ...` |
| Content gap vs competitors | `/seo content-gap ` |
| Head-to-head comparison | `/seo compare ` |
| Multi-domain watchlist | `/seo watchlist add/list/check` |
| Markdown report | `/seo report ` |
| PDF report | `/seo report-pdf ` |
---
## Install
### One-command install (macOS / Linux)
```bash
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/dataforseo-claude/main/install.sh | bash
```
That's it. The installer creates an isolated Python venv, installs the 15
skills, the 5 subagents, the shared DataForSEO client, and a starter `.env`.
### Then add your DataForSEO credentials
1. Sign up at **[https://l.dataforseo.com/4epETnH](https://l.dataforseo.com/4epETnH)** — free trial includes $1 credit (enough for ~10 full audits).
2. Open `~/.claude/skills/seo/.env` and fill in:
```
DATAFORSEO_LOGIN=your_login_email
DATAFORSEO_PASSWORD=your_api_password
```
Done. Open Claude Code and try `/seo quick example.com`.
---
## Quick examples
```bash
# Find 30 local SEO clients ranked by closeability
/seo prospect "plumbers" "San Francisco CA"
# Audit the top prospect + draft the cold email
/seo audit acmeplumbing.com
/seo email acmeplumbing.com
# 60-second snapshot
/seo quick stripe.com
# Full audit with PDF
/seo audit stripe.com
/seo report-pdf stripe.com
# Keyword research
/seo keywords "ai seo tool"
# Find what your competitor ranks for that you don't
/seo content-gap mysite.com biggercompetitor.com
# Track rankings for a list of target keywords
/seo rankings mysite.com "seo audit" "keyword research" "site speed"
```
---
## What's inside
```
~/.claude/
├── skills/
│ ├── seo/ Main orchestrator + scripts + venv
│ │ ├── SKILL.md
│ │ ├── scripts/
│ │ │ ├── dataforseo_client.py Shared API client
│ │ │ ├── keyword_research.py Keywords Data + Labs
│ │ │ ├── serp_check.py SERP API rank checks
│ │ │ ├── backlinks.py Backlinks API
│ │ │ ├── on_page_audit.py On-Page API site crawls
│ │ │ ├── domain_overview.py Labs domain analytics
│ │ │ └── generate_pdf_report.py PDF generator (ReportLab)
│ │ └── .env Your credentials
│ ├── seo-audit/ Composite score orchestrator
│ ├── seo-quick/ 60-second snapshot
│ ├── seo-keywords/ Keyword research
│ ├── seo-technical/ Technical audit
│ ├── seo-competitors/ Competitor analysis
│ ├── seo-content/ Topical authority
│ ├── seo-backlinks/ Backlink profile
│ ├── seo-rankings/ On-demand SERP checks
│ ├── seo-content-gap/ Gap vs competitors
│ ├── seo-compare/ Head-to-head
│ ├── seo-watchlist/ Multi-domain tracking
│ ├── seo-report/ Markdown deliverable
│ └── seo-report-pdf/ PDF deliverable
└── agents/
├── seo-keywords.md Subagent (parallel audit)
├── seo-technical.md
├── seo-competitors.md
├── seo-content.md
└── seo-backlinks.md
```
---
## Requirements
- macOS or Linux (Windows via Git Bash works but isn't actively tested)
- Python 3.8+
- [Claude Code CLI](https://docs.claude.com/en/docs/claude-code)
- [DataForSEO account](https://l.dataforseo.com/4epETnH)
---
## License
MIT — see [LICENSE](LICENSE).