seo-audit

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: [email protected]
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=<login>
   DATAFORSEO_PASSWORD=<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 (real JSON returned): tell the user "✅ Credentials verified. Running your command now..." and proceed with the original request.
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 (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 Audit Orchestrator

Powered by: DataForSEO API — every metric below comes from live calls to DataForSEO Keywords Data, SERP, On-Page, Backlinks, and Labs endpoints. Cost: ~$0.10-0.30 per full audit · Setup: add credentials to ~/.claude/skills/seo/.env

Workflow

Phase 1: Spawn 5 subagents in parallel

Use the Agent tool to launch all five in a single message:

Subagent type	Task
seo-keywords	"Run keyword analysis for <domain>. Return JSON with keyword_score (0-100), top_opportunities (top 20 by volume/difficulty ratio), and intent_breakdown."
seo-technical	"Run technical audit for <domain> (max 100 pages). Return JSON with technical_score (0-100), critical_issues, high_issues, and crawl_summary."
seo-competitors	"Find top 10 competitors for <domain>. Return JSON with competitive_score (0-100), competitors list, and serp_overlap."
seo-content	"Analyze content topical authority for <domain>. Return JSON with content_score (0-100), strong_topics, weak_topics, missing_topics."
seo-backlinks	"Audit backlink profile for <domain>. Return JSON with authority_score (0-100), backlink_summary, top_referrers, anchor_distribution, toxicity_flags."