seo-api

seo-api is a skill for Claude Code from amirjahfar1/automate-seo-with-claude. It costs 411 tokens per session (4,556 once invoked), scanned A, original, MIT.

A developer guide for integrating DataForSEO, an API that provides search, website, backlink, advertising, and related marketing data, into applications.

In plain words
What is it for?
It helps build cURL, Python, TypeScript, or MCP calls for keyword, search-results, backlink, on-page, AI-search, merchant, and business-data requests.
Why use it?
It maps the service’s many API areas to ready-to-use requests, reducing the effort of finding the right endpoint and authentication setup. It also explains that DataForSEO does not store projects or tracking data for you.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions Codex.

Part of the seo-skills plugin — 26 skills shipped together

Good fit It helps build cURL, Python, TypeScript, or MCP calls for keyword, search-results, backlink, on-page, AI-search, merchant, and business-data requests.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/amirjahfar1/automate-seo-with-claude/seo-api
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add amirjahfar1/automate-seo-with-claude --skill seo-api
Clone the repo
git clone --depth 1 https://github.com/amirjahfar1/automate-seo-with-claude

Made for: Claude Code.

Or install seo-skills, the plugin that ships this one along with the rest of its 26 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for seo-api

README.md
[![agentmods](https://agentmods.dev/badge/skills/amirjahfar1/automate-seo-with-claude/seo-api/github.svg)](https://agentmods.dev/skills/amirjahfar1/automate-seo-with-claude/seo-api)
Your own site
<a href="https://agentmods.dev/skills/amirjahfar1/automate-seo-with-claude/seo-api"><img src="https://agentmods.dev/badge/skills/amirjahfar1/automate-seo-with-claude/seo-api/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for seo-api

Your own site · 80×15
<a href="https://agentmods.dev/skills/amirjahfar1/automate-seo-with-claude/seo-api"><img src="https://agentmods.dev/badge/skills/amirjahfar1/automate-seo-with-claude/seo-api.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 411 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,556 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00411 $0.04556
Opus 5 $0.00205 $0.02278
Sonnet 5 $0.00082 $0.00911
Haiku 4.5 $0.00041 $0.00456

Measured 12d ago against content hash ff903bf9d3b4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

seo-api scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Code mode** — write `code/curl.sh`, `code/python.py`, `code/typescript.ts`, `code/mcp-calls.md`. Each file is complete and runnable, not a fragment. Include handling for `429` (backoff with jitter) and `402` (out of
skills/seo-api/SKILL.md · 187 lines

How it starts

The opening of the file, as written. The whole thing — 187 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Built on the DataForSEO MCP server (mcp__dataforseo__* tools) and the REST API at https://api.dataforseo.com/v3/*. Tool names are cross-checked against the connected server so reference data is never stale.

DataForSEO API Integration Architect

Help developers ship real integrations against the DataForSEO API. The deliverable is a code recipe — a ready-to-paste cURL / Python / TypeScript / MCP-tool-call sequence — for the goal the user describes. The skill knows the whole DataForSEO surface (Labs / SERP / Keywords Data / Backlinks / On-Page / AI Optimization / Merchant & Business Data), the pay-per-call cost model, the Basic-auth setup, and which mcp__dataforseo__* tool maps to which REST endpoint.

DataForSEO is stateless — it stores nothing on the user's behalf. There are no saved projects, no stored rank tracking, no project-attached audits. Anything that needs to persist between runs is built on a first-party companion (GSC for the own verified site, GA4 for own traffic) or the user's own local storage — never on DataForSEO. There is therefore no "create project / confirm mutation" flow in this skill: DataForSEO calls are read-shaped requests that change no account state.

Prerequisites

  • DataForSEO MCP server connected. The skill calls mcp__dataforseo__* tools. The server authenticates with HTTP Basic auth using DATAFORSEO_USERNAME / DATAFORSEO_PASSWORD env vars (no OAuth, no shared key). If /mcp doesn't list dataforseo, emit the install command and stop — see references/auth-and-keys.md.

    claude mcp add dataforseo \
      --env DATAFORSEO_USERNAME="$DATAFORSEO_USERNAME" \
      --env DATAFORSEO_PASSWORD="$DATAFORSEO_PASSWORD" \
      -- npx -y dataforseo-mcp-server
    
  • (For REST-direct recipes) DATAFORSEO_USERNAME / DATAFORSEO_PASSWORD available as env vars so the emitted code can build the Basic header (-u "$DATAFORSEO_USERNAME:$DATAFORSEO_PASSWORD").

  • (Optional) WebFetch for fetching deep guides at dataforseo.com/apis/* when the request needs prose beyond what the tool schemas carry.

  • User provides an integration goal in plain language (e.g., "build a rank tracker for client X", "pull backlink deltas for 50 domains into BigQuery weekly", "content-brief pipeline for a keyword"). The skill interviews only when the goal is ambiguous.

Read the full file on GitHub · 187 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 187 lines · 411 tokens per session scan A ff903bf9d3b4

Subscribe to this mod's changes

seo-api is a skill published in the GitHub repository amirjahfar1/automate-seo-with-claude (2 stars, last pushed 3mo ago), licensed MIT. It adds 411 tokens to every session and 4,556 once invoked, about $0.0021 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

seo-site-audit-pro

Flagship comprehensive SEO audit combining Ahrefs and GSC data in sequential waves with checkpoint saves. Use when user says "site audit pro", "full audit", "comprehensive audit", "audit with live data", "deep audit", "pro audit", "complete SEO audit", "run a full site audit", or "audit everything for this domain".…

lionkiii/claude-seo-skills · 90 tokens

seo-content

Content quality and E-E-A-T analysis with AI citation readiness assessment. Enhanced with live Ahrefs (actual keyword rankings, positions) and GSC (search query performance) data to validate static E-E-A-T analysis with real user behavior. Use when user says "content quality", "E-E-A-T", "content analysis"…

lionkiii/claude-seo-skills · 83 tokens

seo-core-web-vitals

Dedicated Core Web Vitals deep-dive: pull field data (CrUX / PageSpeed Insights), fall back to Lighthouse lab data, score LCP, INP, and CLS against Google's thresholds at the 75th percentile, and run per-metric diagnosis playbooks with concrete fixes. Use when user says "core web vitals", "CWV", "LCP", "INP", "CLS"…

lionkiii/claude-seo-skills · 99 tokens

seo-geo

Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences. GEO analysis enriched with Ahrefs Brand Radar AI visibility data when available. Includes brand mention signals, AI crawler accessibility, llms.txt compliance, passage-level citability scoring…

lionkiii/claude-seo-skills · 119 tokens

seo-lighthouse-audit

Run a Lighthouse audit against any URL via the local Lighthouse CLI or the PageSpeed Insights API fallback, parse category scores and failed audits, and map every failed audit ID to its official Chrome docs page plus a one-line fix. Use when user says "lighthouse", "lighthouse audit", "run lighthouse", "lighthouse…

lionkiii/claude-seo-skills · 78 tokens

seo-llms-txt

Generate, validate, or audit llms.txt files for AI search visibility. Crawls site structure, generates spec-compliant Markdown index for LLMs. Use when user says "llms.txt", "llm txt", "AI crawlers", "generate llms", "LLM file", "AI readability file".

lionkiii/claude-seo-skills · 72 tokens