seo

SEO Agency Killer — Claude Code Skill (April 2026)

Philosophy: One command in, real Google data out. No browsing, no scraping, no guesswork — every metric below comes straight from DataForSEO's live APIs.

---

Phase 0: First-Run Setup Check (MANDATORY — run before ANY command)

Before doing anything with a /seo ... request, run this check. Do not skip it, even if the user just wants a quick command.

Step 1 — Read the credentials file:

cat ~/.claude/skills/seo/.env 2>/dev/null

Step 2 — Decide if credentials are configured:

The .env is NOT configured if any of these are true:

• The file doesn't exist
• DATAFORSEO_LOGIN is missing or contains the literal string your_login_email_here
• DATAFORSEO_PASSWORD is missing or contains the literal string your_api_password_here

Step 3a — If credentials ARE configured: continue to the requested command, no message needed.

Step 3b — If credentials are NOT configured: STOP. Do not run the requested command. Instead, paste exactly this setup wizard to the user:

🔧 DataForSEO API Setup Required

This skill needs DataForSEO API credentials to fetch real Google SEO data.
One-time setup, takes 60 seconds:

  Step 1 — Sign up free (includes $1 trial credit, ~10 full audits):
           https://l.dataforseo.com/4epETnH

  Step 2 — After verifying your email, open API Access:
           https://app.dataforseo.com/api-access

  Step 3 — Copy your API Login (your email) and API Password
           (the long alphanumeric string under "API password")

  Step 4 — Paste both back to me in this exact format:

           login: [email protected]
           password: 1adc9025dc1a3e86

I'll save them securely to ~/.claude/skills/seo/.env (chmod 600) and run
your original command immediately after.

Then WAIT for the user's reply with credentials.

Step 4 — When the user pastes credentials:

1. Parse login: and password: from their message (handle Login:, Password:, email-only, or just two lines as well — be lenient)
2. Write them to ~/.claude/skills/seo/.env using this format: