CLI
python3 /home/workspace/Skills/seo-data/scripts/seo.py <command> [options]
Auth
Requires DATAFORSEO_USERNAME and DATAFORSEO_PASSWORD in Zo secrets.
Commands
| Command | Description | ~Cost |
|---|---|---|
serp <query> |
Google SERP top results | $0.0006/query |
keywords <seed> |
Search volume + difficulty for keywords | ~$0.10/100kw |
keyword-ideas <seed> |
Related keyword suggestions | ~$0.05/request |
backlinks <domain> |
Backlink profile summary | ~$0.50/domain |
domain <domain> |
Domain overview (traffic, tech, rankings) | ~$0.025/request |
competitors <domain> |
Competitor domains by keyword overlap | ~$0.05/request |
trends <keyword> |
Google Trends data | ~$0.001/query |
audit <url> |
On-page SEO audit | ~$0.01/page |
balance |
Check remaining credit balance | Free |
Options
| Flag | Description |
|---|---|
--location <code> |
Location code (default: 2840 = US). Use --location 2826 for UK, etc. |
--language <code> |
Language code (default: en) |
--depth <n> |
SERP depth (default: 10, max: 100) |
--limit <n> |
Max results to return (default: 20) |
--output <file> |
Save full JSON to file |
Examples
# Check what ranks for a keyword
python3 scripts/seo.py serp "best project management software"
# Get keyword ideas around a seed term
python3 scripts/seo.py keyword-ideas "project management tools"
# Backlink profile for a competitor
python3 scripts/seo.py backlinks "competitor-domain.com"
# Domain overview
python3 scripts/seo.py domain "example.com"
# Find competitors
python3 scripts/seo.py competitors "example.com"
# Check balance
python3 scripts/seo.py balance
Cost Tracking
Every command prints the estimated cost to stderr. Use balance to check remaining credits. The $50 initial deposit goes a long way at these per-request prices.
Notes
- This skill uses Live endpoints for instant results.
- Location codes: https://docs.dataforseo.com/v3/serp/google/locations
- Some endpoints return data from DataForSEO's own crawl index (backlinks, domain analytics), not live Google results.