Agent skill

Dataforseo Tool

by garrettjsmith in garrettjsmith/localseoskills

When the user needs bulk SERP data, local pack data at scale, keyword volumes for hundreds of terms at once, Google Maps business data programmatically, or is building custom local SEO…

MITAuto-check passedMarketing & SEO

Install Dataforseo Tool

skills CLI
$ npx skills add garrettjsmith/localseoskills --skill dataforseo-tool -a claude-code

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

GitHub CLI
$ gh skill install garrettjsmith/localseoskills dataforseo-tool --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/garrettjsmith/localseoskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dataforseo-tool .claude/skills/dataforseo-tool && 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
dataforseo-tool
GitHub stars
120
Token cost
~1.5k tokens
SKILL.md length
699 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

When the user needs bulk SERP data, local pack data at scale, keyword volumes for hundreds of terms at once, Google Maps business data programmatically, or is building custom local SEO…

  • Works in 5 steps: Define grid of coordinates for the… → For each coordinate, run… → Parse results to find target business… → …
  • Needs bulk SERP data
  • SKILL.md covers When to Use DataForSEO vs…, When DataForSEO Is the Right…, Core Workflows and Pricing Awareness, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dataforseo Tool is an agent skill from garrettjsmith/localseoskills. When the user needs bulk SERP data, local pack data at scale, keyword volumes for hundreds of terms at once, Google Maps business data programmatically, or is building custom local SEO tools/dashboards. Trigger on "bulk keyword data," "SERP data at scale," "DataForSEO," "Google Maps API data," "business data API," or when any other keyword/SERP tool would be too slow for the volume needed.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Local SEO. It works with Google Maps Platform and SerpApi. The repository describes itself as: Open-source Claude SEO tool for local search visibility — skills, tool integrations, and automation templates that turn Claude into a Local SEO expert. The licence is MIT.

When your agent uses it

  • Needs bulk SERP data
  • Local pack data at scale
  • Keyword volumes for hundreds of terms at once
  • Google Maps business data programmatically

Example prompts

  • “bulk keyword data,”
  • “SERP data at scale,”
  • “DataForSEO,”
  • “/dataforseo-tool”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Define grid of coordinates for the service area
  2. For each coordinate, run serp/google/maps/live with target keyword
  3. Parse results to find target business position at each point
  4. Aggregate into ARP/SoLV-style metrics
  5. Schedule to run weekly/monthly

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Dataforseo Tool loads about 1.5k tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 699 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
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 passed

The automated check found no risky patterns in SKILL.md.

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 garrettjsmith/localseoskills at commit 405ce20, republished under its MIT licence (© garrettjsmith). 699 words, ~1,483 tokens.

Download SKILL.mdSave it as .claude/skills/dataforseo-tool/SKILL.md (or your agent's skills folder).
name
dataforseo-tool
description
When the user needs bulk SERP data, local pack data at scale, keyword volumes for hundreds of terms at once, Google Maps business data programmatically, or is building custom local SEO tools/dashboards. Trigger on "bulk keyword data," "SERP data at scale," "DataForSEO," "Google Maps API data," "business data API," or when any other keyword/SERP tool would be too slow for the volume needed.
metadata.version
1.0.0
metadata.author
Garrett Smith

DataForSEO Tool

Note: LocalSEOData (localseodata-tool) is built on DataForSEO and provides a simplified, pre-assembled layer for most local SEO data needs. Use LocalSEOData as default. DataForSEO is still the right choice for massive bulk operations (1000+ queries) or custom pipeline builds that need raw API access.

DataForSEO has an official MCP server. When connected, use it for bulk SEO data operations — SERP results, keyword volumes, business data, and backlinks at scale. This is your bulk data and custom tooling API.

When to Use DataForSEO vs Other Tools

You NeedUse DataForSEOUse Instead
Keyword volume for 500+ terms at once✅ Best for bulkSemrush (for smaller batches)
SERP results for many keyword+location combos✅ Best for scaleSerpAPI (for individual queries)
Google Maps business data programmatically✅—
Google reviews for a business via API✅—
Local pack monitoring at scale (custom build)✅Local Falcon (turnkey solution)
Backlink data⚠️ Has it, smaller indexAhrefs (preferred)
Single keyword research❌ OverkillSemrush
Single SERP check❌ OverkillSerpAPI
Citation audit❌BrightLocal
Geogrid ranking visualization❌Local Falcon

When DataForSEO Is the Right Choice

DataForSEO is the right tool when:

  • Volume: You need data for 100+ keywords, 50+ locations, or 20+ competitors at once
  • Custom builds: You're building a dashboard, tool, or automated system
  • Programmatic access: You need structured data for processing, not human reading
  • Cost efficiency at scale: Pay-per-task pricing beats subscription tools for bulk operations

DataForSEO is NOT the right tool when:

  • You need one quick answer (use SerpAPI or Semrush)
  • You need a turnkey product with visualizations (use Local Falcon, BrightLocal)
  • You need editorial link analysis (use Ahrefs)

Core Workflows

Bulk Local Keyword Volume

When: Have a large keyword list and need volume data for all of them.

Endpoints:

  • keywords_data/google_ads/search_volume — volume, CPC, competition for keyword list
  • keywords_data/google_ads/keywords_for_site — keywords a domain gets traffic for

Use case: You've generated 200 service+city keyword combinations from local-keyword-research. Instead of checking each one in Semrush, batch them through DataForSEO.

What you get: Volume, CPC, competition level, monthly trends for each keyword.

Bulk SERP Data

When: Need to check local pack presence across many keywords or locations.

Endpoints:

  • serp/google/organic/live — full SERP with local pack
  • serp/google/maps/live — Google Maps results
  • serp/google/local_finder/live — local finder specifically

Use case: Check 50 keywords across 10 cities to see which trigger local packs and who appears in them. That's 500 SERP checks — impossible manually, trivial via DataForSEO.

What to extract:

  • Does a local pack appear? (local intent confirmation)
  • Who's in the local pack? (competitor identification)
  • Are ads present? (commercial value)
  • AI Overview present? (content optimization signal)
Show full SKILL.md (282 more words)Show less
Google Business Data

When: Need GBP information about competitors or a market programmatically.

Endpoints:

  • business_data/google/my_business_info — GBP details (name, address, categories, hours, photos, etc.)
  • business_data/google/reviews — Google reviews with text, rating, date

Use case:

  • Pull GBP data for top 20 competitors in a market to compare categories, review counts, ratings
  • Extract reviews for sentiment analysis
  • Monitor competitor GBP changes over time
Custom Local Rank Monitoring

When: Building a custom ranking tool or dashboard instead of using Local Falcon.

Approach:

  1. Define grid of coordinates for the service area
  2. For each coordinate, run serp/google/maps/live with target keyword
  3. Parse results to find target business position at each point
  4. Aggregate into ARP/SoLV-style metrics
  5. Schedule to run weekly/monthly

When to build custom vs use Local Falcon:

  • Local Falcon: Turnkey, visual, campaign management, client-shareable reports
  • DataForSEO custom: Full control, custom metrics, integrates into your own systems, cheaper at very high volume

Pricing Awareness

  • Pay-per-task model — each API call costs credits
  • SERP tasks: ~$0.002-0.005 per result
  • Keyword data: ~$0.05 per batch of keywords
  • Business data: ~$0.005 per result
  • Always estimate total cost before running bulk operations
  • Use async endpoints for large batches (submit tasks, poll for results)

What to Do Next

What You GotNext ActionSkill
Bulk keyword volumesGroup by service, map to pages, prioritize by volume × intentlocal-keyword-research
SERP data showing local pack presenceFocus GBP optimization on keywords with local packsgbp-optimization
Competitor GBP dataAnalyze category usage, review benchmarks, service coveragelocal-competitor-analysis
Competitor reviews extractedAnalyze for sentiment themes, common complaints/praisereview-management
Custom ranking dataInterpret using geogrid analysis frameworkgeogrid-analysis

Default next step: DataForSEO gives you raw data. Always pair it with an analysis skill to turn data into decisions.

© garrettjsmith, 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/dataforseo-tool of garrettjsmith/localseoskills.

Open the folder on GitHubat commit 405ce20

Compare with similar skills

Dataforseo Tool 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 Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dataforseo Tool this skillgarrettjsmith/localseoskills120—~1.5kAutomated safety check: PassMIT
Google Mapscablate/mcp-google-map469—~909Automated safety check: PassMIT
Google Maps Local SEOcablate/mcp-google-map469—~633Automated safety check: PassMIT
Google Maps Travel Planningcablate/mcp-google-map469—~710Automated safety check: PassMIT
Maps Intelligence for Local SEOAgriciDaniel/claude-seo19k1 repos~3.1kAutomated safety check: PassMIT
Local SEO Manageralirezarezvani/claude-skills28k—~3.3kAutomated safety check: PassMIT

Similar skills

  • Google Maps

    cablate/mcp-google-map

    Search places, resolve addresses, compare routes, inspect neighborhoods, and retrieve geographic or environmental facts through the standalone @cablate/mcp-google-map CLI.

    469 GitHub stars~909 tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • Google Maps Local SEO

    cablate/mcp-google-map

    Analyze Google Business Profile visibility, geographic grid rankings, local search keywords, and nearby competitors through the standalone Google Maps CLI.

    469 GitHub stars~633 tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • Google Maps Travel Planning

    cablate/mcp-google-map

    Build evidence-backed day trips, multi-day itineraries, and efficient stop sequences with Google Maps data through the standalone CLI.

    469 GitHub stars~710 tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • Maps Intelligence for Local SEO

    AgriciDaniel/claude-seo

    Audits how a local business appears across Google Maps, Bing Places, Apple Maps, and OpenStreetMap, with geo-grid rank tracking.

    19k GitHub starsUsed in 1 repo~3.1k tokens
    Marketing & SEOAuto-check passed
  • Local SEO Manager

    alirezarezvani/claude-skills

    Manage local SEO for service-area businesses — appliance repair, HVAC, plumbing, cleaning, and any business that serves customers at their location.

    28k GitHub stars~3.3k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Nap Consistency

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a local business website for local SEO.

    74k GitHub stars~613 tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

More from garrettjsmith/localseoskills

All 38 skills in this repo
  • Gbp API Automation

    garrettjsmith/localseoskills

    When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems.

    120 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Gbp Posts

    garrettjsmith/localseoskills

    When the user wants to create, schedule, or optimize Google Business Profile posts.

    120 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Content Briefs

    garrettjsmith/localseoskills

    Generate complete semantic content briefs for local SEO content — location pages, service pages, blog posts, FAQ content, and pillar pages.

    120 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Brief

    garrettjsmith/localseoskills

    Manages persistent work state (briefs) for local SEO engagements.

    120 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Local Content Strategy

    garrettjsmith/localseoskills

    Build a complete local content strategy from keyword research output.

    120 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Falcon Tool

    garrettjsmith/localseoskills

    When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews.

    120 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Dataforseo Tool

What does Dataforseo Tool do?

When the user needs bulk SERP data, local pack data at scale, keyword volumes for hundreds of terms at once, Google Maps business data programmatically, or is building custom local SEO…. Dataforseo Tool is an agent skill from garrettjsmith/localseoskills. When the user needs bulk SERP data, local pack data at scale, keyword volumes for hundreds of terms at once, Google Maps business data programmatically, or is building custom local SEO tools/dashboards.

When should I use Dataforseo Tool?

Dataforseo Tool fits situations like: needs bulk SERP data; local pack data at scale; keyword volumes for hundreds of terms at once; google Maps business data programmatically.

How do I install Dataforseo Tool in Claude Code?

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

How do I install Dataforseo Tool in Codex?

Run `npx skills add garrettjsmith/localseoskills --skill dataforseo-tool -a codex`. Or copy the skill folder (skills/dataforseo-tool in garrettjsmith/localseoskills) into .agents/skills/dataforseo-tool in your project. Codex loads it when a task matches its description.

Can I use Dataforseo Tool 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 garrettjsmith/localseoskills --skill dataforseo-tool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dataforseo-tool, .gemini/skills/dataforseo-tool, .github/skills/dataforseo-tool and .opencode/skills/dataforseo-tool in your project.

What does Dataforseo Tool need to run?

SKILL.md names no scripts, command-line tools or credentials: Dataforseo Tool is instructions for the agent only.

Does Dataforseo Tool access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dataforseo Tool safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dataforseo Tool use?

Dataforseo Tool 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 Tool use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 Tool?

Skills that share tags, products or a category with Dataforseo Tool: Google Maps (cablate/mcp-google-map, 469 stars), Google Maps Local SEO (cablate/mcp-google-map, 469 stars), Google Maps Travel Planning (cablate/mcp-google-map, 469 stars) and Maps Intelligence for Local SEO (AgriciDaniel/claude-seo, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dataforseo Tool?

garrettjsmith (a GitHub user) maintains it in garrettjsmith/localseoskills, which has 120 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on August 15, 2026.

Source: garrettjsmith/localseoskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.