Seo Report

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 Markdown Report Skill

> Powered by: Reads the audit JSON produced by /seo audit, which is built from live DataForSEO API data. No additional API calls — pure formatting step.

Reads ~/.claude/skills/seo/output/-audit.json and produces a markdown report at ~/.claude/skills/seo/output/-report.md.

Structure

# SEO Audit Report — 
*Generated *

## Executive Summary

## Composite Score: /100

| Dimension | Score |
|-----------|-------|
| Keywords | /100 |
| Technical | /100 |
| Competitors | /100 |
| Content | /100 |
| Authority | /100 |

## Key Metrics

## Top 3 Actions This Week
1. **** —  (impact: high)
2. **** — ...
3. **** — ...

## Prioritized Issue List

## Top Keyword Opportunities

## Competitive Landscape

## Methodology
This report was generated using the dataforseo-claude skill pack, which
combines Claude Code's analysis with live data from DataForSEO's APIs.
All metrics reflect Google's organic search results in  at the
time of audit.

---
*Powered by DataForSEO + Claude Code*

Tone

• Direct and confident — clients are paying for clarity
• Numbers, not adjectives — say "12,400 monthly visits" not "significant traffic"
• Recommendations are specific actions, not categories
• ✅ "Rewrite the title tag on /pricing to lead with 'Pricing — [Brand]'"
• ❌ "Improve title tags"

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
• Source: zubair-trabzada/dataforseo-claude
• License: MIT

Install and usage instructions live in the source repository linked above.