Installation
$npx skills add garrettjsmith/localseoskills --skill dataforseo-toolSummary
This skill enables an agent to query the DataForSEO API for high-volume SEO data operations — bulk keyword volumes, local pack presence across many keywords/locations, competitor GBP profiles, and reviews — when volume exceeds what other tools can handle efficiently. Trigger when the user needs 100+ keyword checks, SERP data across multiple locations, or programmatic access to Google Maps business data.
SKILL.MD
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 Need | Use DataForSEO | Use Instead |
|---|---|---|
| Keyword volume for 500+ terms at once | ✅ Best for bulk | Semrush (for smaller batches) |
| SERP results for many keyword+location combos | ✅ Best for scale | SerpAPI (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 index | Ahrefs (preferred) |
| Single keyword research | ❌ Overkill | Semrush |
| Single SERP check | ❌ Overkill | SerpAPI |
| 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 listkeywords_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 packserp/google/maps/live— Google Maps resultsserp/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)
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:
- Define grid of coordinates for the service area
- For each coordinate, run
serp/google/maps/livewith target keyword - Parse results to find target business position at each point
- Aggregate into ARP/SoLV-style metrics
- 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 Got | Next Action | Skill |
|---|---|---|
| Bulk keyword volumes | Group by service, map to pages, prioritize by volume × intent | local-keyword-research |
| SERP data showing local pack presence | Focus GBP optimization on keywords with local packs | gbp-optimization |
| Competitor GBP data | Analyze category usage, review benchmarks, service coverage | local-competitor-analysis |
| Competitor reviews extracted | Analyze for sentiment themes, common complaints/praise | review-management |
| Custom ranking data | Interpret using geogrid analysis framework | geogrid-analysis |
Default next step: DataForSEO gives you raw data. Always pair it with an analysis skill to turn data into decisions.