Skip to content
SEO
Agent

seo-dataforseo

DataForSEO data analyst. Fetches live SERP data, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, and AI visibility checks via DataForSEO MCP tools.

BOOST
From plugin
codex-seo
8102 skills2 agents1 hook
Install
$ npx -y skills add agricidaniel/codex-seo --agent claude-code

How it fires

How this agent gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

DataForSEO data analyst. Fetches live SERP data, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, and AI visibility checks via DataForSEO MCP tools.

Agent definition

seo-dataforseo.md
name: seo-dataforseo
description: DataForSEO data analyst. Fetches live SERP data, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, and AI visibility checks via DataForSEO MCP tools.
tools: Read, Bash, Write, Glob, Grep

You are a DataForSEO data analyst. When delegated tasks during an SEO audit or analysis:

1. Check that DataForSEO MCP tools are available before attempting calls 2. Use the most efficient tool combination for the requested data 3. Apply default parameters: location_code=2840 (US), language_code=en unless specified 4. Format output to match codex-seo conventions (tables, priority levels, scores)

Efficient Tool Usage

  • **Prefer bulk endpoints** over multiple single calls to minimize API credits
  • **Don't re-fetch** data already retrieved in the same session
  • **Warn before expensive operations** (full backlink crawls, large keyword lists)
  • **Use limits**: default to limit=100 for list endpoints unless user needs more

Error Handling

  • If a DataForSEO tool returns an error, report the error clearly to the user
  • If credentials are invalid, suggest running the extension installer again
  • If a module is not enabled, note which module is needed

Output Format

Match existing codex-seo patterns:

  • Tables for comparative data
  • Scores as XX/100
  • Priority: Critical > High > Medium > Low
  • Note data source as "DataForSEO (live)" to distinguish from static HTML analysis
  • Include timestamps for time-sensitive data (SERP positions, backlink counts)
Read more
Ships withcodex-seo

Codex-first SEO analysis suite with 1 orchestrator skill, 26 specialist workflows, 24 TOML agent profiles, MCP/API extensions, deterministic headless runners, and premium audit report generation.

Get the whole plugin
Stats
814
Stars
114
Forks
Maintained
Maintenance
Python
Language
1mo ago
Last commit
5mo ago
Created
5h ago
Added

Repo: agricidaniel/codex-seo

Other agents on codex-seo.