seo-maps

Trigger phrases

Phrases that activate this skill when typed to Claude Code:

• geo-grid
• rank tracking
• GBP audit
• maps analysis
• Share of Local Voice

What it does

seo-maps is a Claude Code skill from AgriciDaniel’s claude-seo repo. It analyzes how a business appears on maps platforms (Google Maps, Bing Places, Apple Maps, OpenStreetMap) rather than analyzing the website — that is the scope of seo-local. The skill operates on a three-tier capability model: Tier 0 (free, always available) uses Overpass API for competitor discovery, Geoapify for POI search, and Nominatim for geocoding; Tier 1 (DataForSEO MCP) adds live geo-grid rank tracking, GBP profile audit via API, and review intelligence across Google/Tripadvisor/Trustpilot; Tier 2 (DataForSEO + Google Maps Platform API key) adds real-time business status and AI-powered place summaries.

The geo-grid feature simulates Google Maps searches from a 7x7 grid of GPS coordinates around a business location, calculates Share of Local Voice (SoLV = percentage of grid points where the business appears in the top 3), and renders an ASCII heatmap showing where the business is visible and where competitors dominate.

When to use it

Reach for it when:

• You want to understand the geographic footprint of a business’s Google Maps visibility — not just “do you rank” but “where do you rank across the service area”
• You need a cross-platform NAP comparison (Google vs Bing vs Apple vs OpenStreetMap) to find listing inconsistencies
• You want review velocity data — how many reviews per month, whether the 18-day rule is being met, and fake review pattern detection

When not to reach for it:

• You want to analyze the business website for on-page local signals — use seo-local for that; these two skills have a deliberate boundary
• Tier 1 or higher is needed and DataForSEO is not installed — Tier 0 provides competitor discovery and NAP guidance but no geo-grid, GBP API data, or review intelligence

Install

Copy the seo-maps SKILL.md into .claude/skills/seo-maps/ along with the scripts/ directory.

Trigger phrases: “maps”, “geo-grid”, “rank tracking”, “GBP audit”, “review velocity”, “competitor radius”, “maps analysis”, “local rank tracking”, “Share of Local Voice”, “SoLV”.

Commands: /seo maps <url> (full audit, auto-tier), /seo maps grid <keyword> <location> (geo-grid), /seo maps reviews <business> <location> (review intelligence), /seo maps competitors <keyword> <location>, /seo maps nap <business-name>, /seo maps schema <business-name>.

What a session looks like

A typical session has three phases:

1. Tier detection and communication. The skill checks DataForSEO MCP and Google Maps API key availability, reports which tier is active, and explains what is available at this tier before running any command. This prevents users from expecting geo-grid results and getting only Tier 0 outputs.
2. Geo-grid scan (Tier 1+). The business address is geocoded, a 7x7 grid of GPS coordinates is generated using the Haversine formula, and the skill displays a cost estimate and asks for confirmation before firing 49 DataForSEO Maps SERP calls. Results show rank at each grid point and the SoLV percentage with ASCII heatmap.
3. GBP audit, review intelligence, and schema generation. GBP completeness is scored across 25 fields with industry-specific weighting. Review velocity is calculated across the last 6 months with the 18-day rule check. Fake review patterns (uniform timing, single-review accounts, geographic inconsistencies) are flagged. LocalBusiness JSON-LD is generated from the collected data if the current schema is missing or incomplete.

Receipts

Works well: The geo-grid SoLV metric is the most honest representation of a local business’s map visibility — a business can rank #1 in its immediate neighborhood but be invisible a kilometer away where most of its customers actually live. The heatmap makes this visible in a way that single-point rank tracking cannot.

Backfires: Geo-grid scans consume DataForSEO credits — 49 grid points per keyword scan. For multi-keyword campaigns the costs add up quickly, and the mandatory cost estimate + confirmation step is there for good reason. Budget awareness before starting is critical.

Pattern that works: Run geo-grid for one primary keyword first, look at the heatmap to identify which grid quadrants have weak coverage, then investigate what the top-ranking competitors in those zones are doing differently (category, reviews, proximity optimization).

Source and attribution

Originally written by AgriciDaniel. The canonical SKILL.md and supporting files live in the seo-maps folder of the claude-seo repository.

License: MIT. Install, adapt, and redistribute with attribution preserved.

This page documents the skill from a practitioner’s perspective. For the formal spec and updates, defer to the source repo.