Seo Competitors

Phase 0: Credential Preflight (REQUIRED — run BEFORE anything else)

Before running any of the steps below, always invoke the shared preflight check:

~/.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= ``

1. chmod 600 ~/.claude/skills/seo/.env
2. Run a verification call: ~/.claude/skills/seo/scripts/keyword_research.py volume "test"
3. If verification succeeds (real JSON returned): tell the user "✅ Credentials verified. Running your command now..." and proceed with the original request.
4. If status 40104 — Please verify your account: tell the user to verify their account at https://app.dataforseo.com/, then say "continue" to retry.
5. If any other auth error: ask them to double-check the API password (the long alphanumeric string from https://app.dataforseo.com/api-access — not their account login password).

Never echo credentials back to the user, never include them in tool output, and never commit them.

---

SEO Competitor Analysis Skill

> Powered by: DataForSEO API — Labs competitors_domain + Labs domain_intersection. > Cost: ~$0.05-0.08 per run.

Run

~/.claude/skills/seo/scripts/domain_overview.py competitors --target  --limit 20

For each of the top 5 competitors, also pull intersection (shared keywords):

~/.claude/skills/seo/scripts/domain_overview.py intersect --you  --competitor 

What to surface

Top 10 competitors table

| Rank | Domain | Common keywords | Their unique keywords | Est. traffic | Domain rank | |------|--------|----------------|-----------------------|--------------|-------------|

The DataForSEO competitors endpoint already ranks them by SERP overlap with your target — keep that order.

SERP overlap analysis

For the top 3 competitors:

• How many keywords does the target share with them? (intersect call)
• What's the average position gap? (you at #15, them at #4 = -11 gap)
• Any keywords where the target outranks the competitor? (rare wins to defend)

Strategic groupings

• Direct competitors — share 30%+ of keywords
• Adjacent competitors — share 10-30% (worth monitoring, not chasing)
• Aspirational — much higher domain rank, shared keywords ": {"shared": 234, "avg_gap": -8.4, "wins": 12}

}, "strategic_groups": { "direct": ["a.com", "b.com"], "adjacent": ["c.com"], "aspirational": ["d.com"] } }

## 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.