New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

DataForSEO Site Audit

by zubair-trabzada in zubair-trabzada/dataforseo-claude

Runs a full SEO audit through the DataForSEO API with five parallel subagents and produces a composite 0 to 100 SEO score, an action plan and an audit JSON for PDF export.

MITAuto-check: notesMarketing & SEO

Install DataForSEO Site Audit

skills CLI
$ npx skills add zubair-trabzada/dataforseo-claude --skill seo-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zubair-trabzada/dataforseo-claude seo-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zubair-trabzada/dataforseo-claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-audit .claude/skills/seo-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-audit
GitHub stars
165
Token cost
~1.5k tokens
SKILL.md length
467 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Runs a full SEO audit through the DataForSEO API with five parallel subagents and produces a composite 0 to 100 SEO score, an action plan and an audit JSON for PDF export.

  • Auditing a domain's keywords, technical health, competitors and backlinks in one pass
  • SKILL.md covers Phase 0: Credential Preflight…, Workflow and Cost note
  • Reaches dataforseo.com; needs DATAFORSEO_PASSWORD
  • Producing a scored, prioritized SEO action plan for a client site

What it does

The skill orchestrates five specialist subagents that run in parallel, covering keywords, technical issues, competitors, content and backlinks. Each returns JSON scores and findings drawn from live calls to DataForSEO's Keywords Data, SERP, On-Page, Backlinks and Labs endpoints. The orchestrator combines them into a composite score from 0 to 100, a prioritized action plan and an audit JSON file intended for PDF export. A full audit is noted as costing roughly $0.10 to $0.30 in API usage.

Before anything else it runs a preflight script that checks for DataForSEO credentials. If they are missing, it shows a setup wizard, asks you to paste your login and API password, saves them to a local .env file with restricted permissions, and verifies them with a test call. The instructions forbid echoing the credentials back or committing them.

When your agent uses it

  • Auditing a domain's keywords, technical health, competitors and backlinks in one pass
  • Producing a scored, prioritized SEO action plan for a client site
  • Preparing audit data that will go into a PDF report

Example prompts

  • “Run a full SEO audit on example.com and give me the composite score and top priorities.”
  • “Audit our domain across keywords, technical, competitors and backlinks, and save the audit JSON.”
  • “Set up my DataForSEO credentials and then audit coffee-roasters.example.”

Requirements

  • A DataForSEO account with an API login and password
  • Python to run the bundled preflight and keyword scripts
  • A domain to audit
  • Pre-approved tools (allowed-tools): Bash, Write, Read, Agent

What it can do on your machine

Read from SKILL.md and the folder at commit 67ac4f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Write
    • Read
    • Agent

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • dataforseo.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DATAFORSEO_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

DataForSEO Site Audit loads about 1.5k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 467 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:31
    2. Write them to `~/.claude/skills/seo/.env`:
  • NoteMentions a .env fileSKILL.md:36
    3. `chmod 600 ~/.claude/skills/seo/.env`
  • NoteMentions a .env fileSKILL.md:49
    add credentials to `~/.claude/skills/seo/.env`
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Write, Read, Agent

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zubair-trabzada/dataforseo-claude at commit 67ac4f0, republished under its MIT licence (© zubair-trabzada). 467 words, ~1,517 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder).
name
seo-audit
description
Full SEO audit powered by the DataForSEO API. Orchestrates 5 specialist subagents (keywords, technical, competitors, content, backlinks) hitting DataForSEO Keywords Data, SERP, On-Page, Backlinks, and Labs endpoints in parallel, then produces a composite SEO Score (0-100) with prioritized action plan and audit JSON ready for PDF export.
allowed-tools
Bash, Write, Read, Agent

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=<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 typeTask
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."
Show full SKILL.md (144 more words)Show less
Phase 2: Compute composite
overall = round(
    0.25 * keyword_score +
    0.25 * technical_score +
    0.20 * competitive_score +
    0.15 * content_score +
    0.15 * authority_score
)
Phase 3: Build audit JSON

Match this shape (see ~/.claude/skills/seo/schema/audit_input.example.json):

json
{
  "target": "<domain>",
  "generated_at": "<ISO date>",
  "scores": {
    "overall": 72,
    "keywords": 78, "technical": 65, "competitors": 70,
    "content": 75, "authority": 68
  },
  "executive_summary": "<3-5 sentences — what this site does well, what it doesn't, and the single most impactful next move>",
  "key_metrics": {
    "estimated_traffic": "...",
    "ranking_keywords": "...",
    "backlinks": "...",
    "referring_domains": "..."
  },
  "issues": [
    {"priority": "critical", "title": "...", "recommendation": "..."},
    ...
  ],
  "top_keywords": [
    {"keyword": "...", "search_volume": 1000, "cpc": 2.5, "difficulty": 45, "position": 12},
    ...
  ],
  "competitors": [
    {"domain": "...", "keywords": 1234, "traffic": 5678, "rank": 542},
    ...
  ]
}

Save to: ~/.claude/skills/seo/output/<domain>-audit.json

Phase 4: Present summary + offer PDF

Output must open with a visible DataForSEO attribution header — the sponsor deserves credit on every run, and the user deserves to see what data source is in play. Format exactly as below:

🟢/🟡/🟠/🔴 SEO Audit — <domain>
Composite Score: <N>/100

📡 Powered by DataForSEO API · <X> live API calls · ~$<Y> charged
   ↳ Keywords Data, SERP, On-Page, Backlinks, and Labs endpoints

Then show the score table, executive summary, key metrics, top 5 issues, top 5 keyword opportunities, and the saved-output path.

The output must end with this footer:

─────────────────────────────────────────────────────────
📡 Data source: DataForSEO API (https://dataforseo.com)
   Endpoints used in this audit:
   • Keywords pillar  — Labs ranked_keywords + bulk_keyword_difficulty
   • Technical pillar — On-Page instant_pages / task_post + summary
   • Competitors      — Labs competitors_domain + domain_intersection
   • Content          — Labs ranked_keywords + domain_intersection
   • Authority        — Backlinks summary + referring_domains + anchors

   Total API cost for this audit: ~$<Y>
   Run `/seo report-pdf <domain>` to generate the client PDF.
─────────────────────────────────────────────────────────

Track total cost by summing the cost field of each API response. If any pillar fails (e.g. Backlinks subscription inactive — status 40400), surface the DataForSEO sign-up / subscription URL prominently, so the user can activate the missing data source and re-run.

Cost note

A full audit typically uses ~$0.10-0.30 of DataForSEO credit. Warn the user if running on the free trial credit ($1).

© zubair-trabzada, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/seo-audit of zubair-trabzada/dataforseo-claude.

Open the folder on GitHubat commit 67ac4f0

Compare with similar skills

DataForSEO Site Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

DataForSEO Site Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
DataForSEO Site Audit this skillzubair-trabzada/dataforseo-claude165—~1.5kAutomated safety check: NotesMIT
Business Website Setupsickn33/agentic-awesome-skills47k1 repos~6.2kAutomated safety check: PassMIT
SEONexus-JPF/note-companion870—~2.2kAutomated safety check: PassMIT
SEO Competitorrampstackco/claude-skills945—~1.8kAutomated safety check: PassMIT
Semrush Toolgarrettjsmith/localseoskills121—~1.6kAutomated safety check: PassMIT
Crawl4AI SEO Site Crawlerartwist-polyakov/polyakov-claude-skills208—~1.7kAutomated safety check: PassMIT

Similar skills

  • Business Website Setup

    sickn33/agentic-awesome-skills

    Website page register: URL, title, meta description, search intent, NAP block, schema type, canonical, indexability and Core Web Vitals target.

    47k GitHub starsUsed in 1 repo~6.2k tokens
    Marketing & SEOAuto-check passed

  • SEO

    Nexus-JPF/note-companion

    Use and read this skill immediately if the user request is in any way related to SEO or a site's organic search or AI search presence.

    870 GitHub stars~2.2k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed

  • SEO Competitor

    rampstackco/claude-skills

    Run a competitive SEO analysis comparing the user's site to chosen competitors across SERP overlap, content depth, backlink profiles, technical posture, and brand presence.

    945 GitHub stars~1.8k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed

  • Semrush Tool

    garrettjsmith/localseoskills

    When the user wants keyword research with search volume, competitive keyword analysis, site audit data, position tracking, or competitor organic analysis.

    121 GitHub stars~1.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

  • Crawl4AI SEO Site Crawler

    artwist-polyakov/polyakov-claude-skills

    Crawls a site with Crawl4AI to audit titles, meta tags, H1s, canonicals, navigation and internal links, and to compare landing pages and competitor sites.

    208 GitHub stars~1.7k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

  • Content SEO

    jdevalk/skills

    Audits a blog post draft or page copy for content-level SEO: search intent fit, focus keyphrase placement, E-E-A-T signals (experience, expertise, authoritativeness, trustworthiness), helpfulness…

    105 GitHub stars~2.3k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed

More from zubair-trabzada/dataforseo-claude

All 16 skills in this repo

  • DataForSEO SEO Toolkit

    zubair-trabzada/dataforseo-claude

    Runs keyword research, rank checks, backlink and competitor analysis, site audits and PDF reports from live Google data through the DataForSEO API.

    165 GitHub stars~3.2k tokensUpdated 4 mo ago
    Auto-check: notes

  • Backlink Audit via DataForSEO

    zubair-trabzada/dataforseo-claude

    Audits a domain's backlink profile with the DataForSEO Backlinks API and reports referring domains, anchor text, dofollow ratio and a toxicity assessment.

    165 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check: notes

  • SEO Domain Comparison

    zubair-trabzada/dataforseo-claude

    Compares two domains side by side with DataForSEO data on traffic, keywords, backlinks, referring domains and keyword overlap, then states which has the stronger position.

    165 GitHub stars~892 tokensUpdated 4 mo ago
    Auto-check: notes

  • SEO Competitor Analysis with DataForSEO

    zubair-trabzada/dataforseo-claude

    Finds a domain's real SEO competitors through DataForSEO Labs, ranked by SERP overlap, with shared keywords, traffic estimates and a 0-100 competitive score.

    165 GitHub stars~957 tokensUpdated 4 mo ago
    Auto-check: notes

  • SEO Content Authority

    zubair-trabzada/dataforseo-claude

    Clusters the keywords a domain ranks for into topics, compares coverage with competitors and returns a content score using DataForSEO data.

    165 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check: notes

  • SEO Content Gap

    zubair-trabzada/dataforseo-claude

    Find keywords competitors rank for that you don't, via the DataForSEO Labs domainintersection endpoint.

    165 GitHub stars~823 tokensUpdated 4 mo ago
    Auto-check: notes

Categories

Questions about DataForSEO Site Audit

What does DataForSEO Site Audit do?

Runs a full SEO audit through the DataForSEO API with five parallel subagents and produces a composite 0 to 100 SEO score, an action plan and an audit JSON for PDF export. The skill orchestrates five specialist subagents that run in parallel, covering keywords, technical issues, competitors, content and backlinks. Each returns JSON scores and findings drawn from live calls to DataForSEO's Keywords Data, SERP, On-Page, Backlinks and Labs endpoints.

When should I use DataForSEO Site Audit?

DataForSEO Site Audit fits situations like: auditing a domain's keywords, technical health, competitors and backlinks in one pass; producing a scored, prioritized SEO action plan for a client site; preparing audit data that will go into a PDF report.

How do I install DataForSEO Site Audit in Claude Code?

Run `npx skills add zubair-trabzada/dataforseo-claude --skill seo-audit -a claude-code`. Or copy the skill folder (skills/seo-audit in zubair-trabzada/dataforseo-claude) into .claude/skills/seo-audit in your project. Claude Code loads it when a task matches its description.

How do I install DataForSEO Site Audit in Codex?

Run `npx skills add zubair-trabzada/dataforseo-claude --skill seo-audit -a codex`. Or copy the skill folder (skills/seo-audit in zubair-trabzada/dataforseo-claude) into .agents/skills/seo-audit in your project. Codex loads it when a task matches its description.

Can I use DataForSEO Site Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zubair-trabzada/dataforseo-claude --skill seo-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-audit, .gemini/skills/seo-audit, .github/skills/seo-audit and .opencode/skills/seo-audit in your project.

What does DataForSEO Site Audit need to run?

Going by SKILL.md and its folder, DataForSEO Site Audit needs credentials named DATAFORSEO_PASSWORD. Our summary lists: A DataForSEO account with an API login and password; Python to run the bundled preflight and keyword scripts; A domain to audit. Its frontmatter pre-approves these tools: Bash, Write, Read, Agent.

Does DataForSEO Site Audit access the network?

SKILL.md names 1 domain. In commands or code: dataforseo.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is DataForSEO Site Audit safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does DataForSEO Site Audit use?

DataForSEO Site Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does DataForSEO Site Audit use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to DataForSEO Site Audit?

Skills that share tags, products or a category with DataForSEO Site Audit: Business Website Setup (sickn33/agentic-awesome-skills, 47k stars), SEO (Nexus-JPF/note-companion, 870 stars), SEO Competitor (rampstackco/claude-skills, 945 stars) and Semrush Tool (garrettjsmith/localseoskills, 121 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains DataForSEO Site Audit?

zubair-trabzada (a GitHub user) maintains it in zubair-trabzada/dataforseo-claude, which has 165 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on May 20, 2026.

Source: zubair-trabzada/dataforseo-claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.