# Seo Prospect > Find local-business SEO prospects in a single command. Searches Google for " ", filters out aggregators (Yelp, Yellow Pages, Angi), enriches each remaining domain with DataForSEO Labs domain overview, On-Page technical audit, and Backlinks summary in parallel, then ranks the businesses by a closeability score (0-100) — highest scores are the easiest to land as SEO clients. - **Type:** Skill - **Install:** `agentstack add skill-zubair-trabzada-dataforseo-claude-seo-prospect` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [zubair-trabzada](https://agentstack.voostack.com/s/zubair-trabzada) - **Installs:** 0 - **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [zubair-trabzada](https://github.com/zubair-trabzada) - **Source:** https://github.com/zubair-trabzada/dataforseo-claude/tree/main/skills/seo-prospect ## Install ```sh agentstack add skill-zubair-trabzada-dataforseo-claude-seo-prospect ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About ## Phase 0: Credential Preflight (REQUIRED — run BEFORE anything else) Before running any of the steps below, **always** invoke the shared preflight check: ```bash ~/.claude/skills/seo/scripts/preflight.sh ``` **If exit code is 0:** credentials are configured — proceed with the rest of this skill silently. **If exit code is 2:** the script prints the DataForSEO setup wizard to stdout. STOP, display that wizard to the user verbatim, and **wait for them to paste credentials** in this format: ``` login: their_email@example.com password: their_api_password_here ``` When they reply: 1. Parse `login:` and `password:` from their message. 2. Write them to `~/.claude/skills/seo/.env`: ``` DATAFORSEO_LOGIN= DATAFORSEO_PASSWORD= ``` 3. `chmod 600 ~/.claude/skills/seo/.env` 4. Run a verification call: `~/.claude/skills/seo/scripts/keyword_research.py volume "test"` 5. If verification succeeds: tell the user "✅ Credentials verified. Running your command now..." and proceed. 6. If status `40104 — Please verify your account`: tell the user to verify their account at https://app.dataforseo.com/, then say "continue" to retry. 7. If any other auth error: ask them to double-check the API password from https://app.dataforseo.com/api-access. **Never** echo credentials back to the user, never include them in tool output, and never commit them. --- # SEO Prospect Finder Skill > **Powered by:** [DataForSEO API](https://dataforseo.com) — every prospect on the list comes from 4 live endpoints fired in parallel: > SERP `google/organic/live/advanced`, Labs `domain_rank_overview`, On-Page `instant_pages`, Backlinks `summary`. > **Cost:** ~$0.20-0.50 per 30-prospect run. ## Inputs The user gives you a niche and a city. Example invocations: - `/seo prospect "plumbers" "San Francisco CA"` - `/seo prospect HVAC "Oakland CA"` - `/seo prospect "moving companies" "Austin TX"` If the city includes a state code, pass it through. If only a city name is given, ask the user to confirm the state (DataForSEO needs the location string to disambiguate). ## Run ```bash ~/.claude/skills/seo/scripts/prospect_finder.py find \ --niche "" \ --city "" \ --limit 30 \ --out ~/.claude/skills/seo/output/--prospects.json ``` The script: 1. Hits Google SERP API for `" "` to depth 50 2. Filters out aggregators (Yelp, Yellow Pages, Angi, HomeAdvisor, BBB, Maps, social networks, news/forum sites) 3. For each remaining domain (in parallel): - Pulls **domain_rank_overview** → estimated traffic + ranking keyword count - Pulls **On-Page instant audit** → critical technical issues on homepage - Pulls **Backlinks summary** → referring-domain count + authority rank 4. Computes a **closeability score (0-100)** weighting: - Position (peaks on page 2-3 — they care but aren't winning) - Visible technical issues (more = clearer pitch) - Domain size (small enough to land, big enough to pay) - Keyword footprint (some footprint = they care about SEO) ## Output format Open with the DataForSEO attribution header: ``` 🎯 SEO Prospect Search — in 📡 Powered by DataForSEO API · live calls · ~$ charged ↳ SERP, Labs, On-Page, and Backlinks endpoints Found non-aggregator businesses. Scored by closeability: ``` Then a ranked table of the top 15 prospects: ``` Rank | Domain | Pos | Closeability | Traffic/mo | Issues | Backlinks -----|----------------------|-----|--------------|------------|--------|---------- 1 | acmeplumbing.com | 14 | 87/100 | 240 | 5 | 23 2 | bayareaplumbers.com | 22 | 82/100 | 180 | 4 | 41 ... ``` After the table, surface the **top 3 prospects with a one-paragraph pitch each**: ``` 🥇 Top pick: acmeplumbing.com Why it's a great target: • Ranks #14 for " " — page 2, will respond to a pitch that says "let's move you to page 1" • Specific issues found: missing meta descriptions, no H1 on the homepage, duplicate title tags across service pages • Only 23 referring domains — small, hungry, likely no SEO agency on retainer • Estimated 240 monthly visits — they have revenue but room to grow Next step: run /seo audit acmeplumbing.com to generate the full PDF, then /seo email acmeplumbing.com to draft the cold email. ``` ## Footer End with this footer: ``` ───────────────────────────────────────────────────────── 📡 Data source: DataForSEO API (https://dataforseo.com) Endpoints fired in this prospect search: • SERP google/organic/live/advanced → candidate discovery • Labs domain_rank_overview → traffic + keyword footprint • On-Page instant_pages → technical issue surface • Backlinks summary → authority + size signal Saved: ~/.claude/skills/seo/output/.json Next: /seo audit to deep-dive on any single prospect. ───────────────────────────────────────────────────────── ``` ## When NOT to use this skill - The user has a specific business they want to audit → use `/seo audit` directly - The user already has a prospect list → skip prospecting, go straight to `/seo audit` - The niche isn't local-business shaped (e.g. SaaS, B2B enterprise) → tell them this skill is local-only ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [zubair-trabzada](https://github.com/zubair-trabzada) - **Source:** [zubair-trabzada/dataforseo-claude](https://github.com/zubair-trabzada/dataforseo-claude) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-zubair-trabzada-dataforseo-claude-seo-prospect - Seller: https://agentstack.voostack.com/s/zubair-trabzada - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.