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 <niche> <city> |
| Draft cold email from audit findings | /seo email <domain> |
| Full audit (composite score + PDF) | /seo audit <domain> |
| 60-second snapshot | /seo quick <domain> |
| Keyword research | /seo keywords <seed> |
| Technical site crawl | /seo technical <domain> |
| Competitor map | /seo competitors <domain> |
| Content topical authority | /seo content <domain> |
| Backlink profile + toxicity | /seo backlinks <domain> |
| On-demand rank check | /seo rankings <domain> kw1 kw2 ... |
| Content gap vs competitors | /seo content-gap <you> <competitor> |
| Head-to-head comparison | /seo compare <d1> <d2> |
| Multi-domain watchlist | /seo watchlist add/list/check |
| Markdown report | /seo report <domain> |
| PDF report | /seo report-pdf <domain> |
Install
One-command install (macOS / Linux)
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
- Sign up at https://l.dataforseo.com/4epETnH — free trial includes $1 credit (enough for ~10 full audits).
- 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
# 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
License
MIT — see LICENSE.