Seo Maps
Run maps-platform local SEO intelligence—geo-grid ranks, GBP audits, reviews, NAP checks, and LocalBusiness schema—from API tiers without duplicating on-page seo-local work.
Overview
seo-maps is an agent skill most often used in Launch (also Grow analytics and Validate scope for local markets) that delivers API-driven maps-platform SEO—geo-grids, GBP audits, reviews, NAP, and LocalBusiness schema—wit
Install
npx skills add https://github.com/agricidaniel/claude-seo --skill seo-mapsWhat is this skill?
- Geo-grid rank tracking and Share of Local Voice (SoLV) style local visibility analysis
- GBP profile auditing and review intelligence across Google, Tripadvisor, and Trustpilot
- Cross-platform NAP verification across Google, Bing, Apple Maps, and OpenStreetMap
- Three-tier capability model: free (Overpass + Geoapify), DataForSEO, and DataForSEO + Google Maps API
- Explicit boundary: maps platforms via APIs; defer on-page local site analysis to seo-local
- Three-tier capability model (free, DataForSEO, DataForSEO + Google)
- Cross-platform NAP checks across four map ecosystems
- Review sources include Google, Tripadvisor, and Trustpilot
Adoption & trust: 1.6k installs on skills.sh; 8.5k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You cannot see how a location ranks across a geo-grid, whether listings agree on NAP, or how reviews and GBP health compare to nearby competitors without juggling multiple map APIs and tools.
Who is it for?
Indie operators of brick-and-mortar, service-area, or multi-location products preparing launch or growth local SEO with API-backed maps evidence.
Skip if: Purely online businesses with no local presence, or teams that only need on-page local SEO without map-platform APIs.
When should I use this skill?
User mentions maps, geo-grid, rank tracking, GBP audit, review velocity, competitor radius, maps analysis, local rank tracking, Share of Local Voice, or SoLV.
What do I get? / Deliverables
You get structured maps intelligence, competitor radius context, and schema-ready local business data, with a clear handoff to seo-local for on-site local SEO when needed.
- Geo-grid and local rank intelligence report
- GBP and review intelligence summary
- LocalBusiness schema generated from API-derived business data
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Launch/seo is the canonical shelf because the skill optimizes how a local business appears on Google Maps, Bing, Apple, and OSM for findability. Maps intelligence, Share of Local Voice, and schema from API data are launch-time SEO operations distinct from website HTML checks handled by seo-local.
Where it fits
Run a GBP audit and geo-grid before a location landing page goes live.
Track review velocity and SoLV monthly against radius-mapped competitors.
Map competitor density in a city before choosing franchise or service-area pricing.
Verify NAP consistency across Bing and Apple Maps prior to a directory blast.
How it compares
Maps-platform API intelligence—pair with seo-local for website HTML local signals instead of one skill doing both.
Common Questions / FAQ
Who is seo-maps for?
Solo builders and small teams accountable for local visibility on Google Maps and allied platforms who can use MCP/API tiers from free to DataForSEO plus Google.
When should I use seo-maps?
At Launch for geo-grid and GBP audits; during Grow when tracking review velocity and SoLV; at Validate when sizing a local market via competitor radius before committing spend.
Is seo-maps safe to install?
It implies external API and MCP usage—store keys securely and review the Security Audits panel on this Prism page before enabling paid connectors in production.
SKILL.md
READMESKILL.md - Seo Maps
MIT License - see repository root LICENSE file for complete terms. Copyright (c) 2026 AgriciDaniel https://github.com/AgriciDaniel/claude-seo --- name: seo-maps description: > Maps intelligence for local SEO — geo-grid rank tracking, GBP profile auditing via API, review intelligence across Google/Tripadvisor/Trustpilot, cross-platform NAP verification (Google/Bing/Apple/OSM), competitor radius mapping, and LocalBusiness schema generation from API data. Three-tier capability: free (Overpass + Geoapify), DataForSEO (full intelligence), DataForSEO + Google (maximum coverage). Use when user says "maps", "geo-grid", "rank tracking", "GBP audit", "review velocity", "competitor radius", "maps analysis", "local rank tracking", "Share of Local Voice", or "SoLV". user-invokable: true argument-hint: "[command] [url|keyword|location]" license: MIT compatibility: "DataForSEO MCP for Tier 1+, Google Maps API for Tier 2" metadata: author: AgriciDaniel version: "2.0.0" category: seo --- # Maps Intelligence (March 2026) Maps platform analysis for local businesses. Works with external APIs to assess how a business appears on Google Maps, Bing Places, Apple Maps, and OpenStreetMap. **Boundary with seo-local:** This skill analyzes the business on maps PLATFORMS (via APIs). seo-local analyzes local SEO signals on the WEBSITE (via HTML fetch). Do not duplicate seo-local on-page analysis. Recommend `/seo local <url>` for website-level checks. --- ## Quick Reference | Command | What it does | Tier | |---------|-------------|------| | `/seo maps <url>` | Full maps presence audit (auto-selects tier) | 0+ | | `/seo maps grid <keyword> <location>` | Geo-grid rank scan (7x7, 1 keyword default) | 1+ | | `/seo maps reviews <business> <location>` | Cross-platform review intelligence | 1+ | | `/seo maps competitors <keyword> <location>` | Competitor radius mapping | 0+ | | `/seo maps nap <business-name>` | Cross-platform NAP verification | 0+ | | `/seo maps schema <business-name>` | Generate LocalBusiness JSON-LD from data | 0+ | | `/seo maps gbp <business> <location>` | GBP completeness audit | 1+ | --- ## Three-Tier Capability Detection Before any analysis, detect the available capability tier: ### Tier 0 (Free) **Detection:** DataForSEO MCP tools NOT available. **Capabilities:** Overpass API competitor discovery, Geoapify POI search, Nominatim geocoding, static GBP checklist, schema generation, cross-platform NAP guidance. **Load:** `references/maps-free-apis.md` ### Tier 1 (DataForSEO) **Detection:** `business_data_business_listings_search` MCP tool IS available. **Capabilities:** Everything in Tier 0 PLUS geo-grid rank tracking, live GBP profile audit, review intelligence (velocity, sentiment, distribution), GBP post activity, Q&A data, Tripadvisor/Trustpilot reviews. **Load:** `references/maps-api-endpoints.md` ### Tier 2 (DataForSEO + Google Maps Platform) **Detection:** Tier 1 available AND Google Maps API key in environment. **Capabilities:** Everything in Tier 1 PLUS Google Places details, real-time business status, AI-powered place summaries, photo analysis. **Note:** Google ToS restricts storage to `place_id` only. Lat/lng cached 30 days max. **Always communicate the detected tier to the user** at the start of analysis. --- ## Geo-Grid Rank Tracking (Tier 1+) Simulates Google Maps searches from multiple GPS coordinates to show ranking variation across a geographic area. Requires DataForSEO. **Load:** `references/maps-geo-grid.md` for algorithm, SoLV formula, heatmap format. **Load:** `references/maps-api-endpoints.md` for Maps SERP endpoint details. ### Workflow 1. Geocode business address to get center lat/lng 2. Generate grid points (default: 7x7, 5km radius) using Haversine offset formula 3. **Display cost estimate and ask for confirmation before proceeding** 4. Fire DataForSEO Maps SERP API calls with `location_coordinate` per grid point 5. Find target business rank at each point 6. Calculate SoLV: