seo-maps

A local-SEO skill that analyzes how a business appears on maps platforms including Google Maps, Bing Places, Apple Maps, and OpenStreetMap by working with external APIs. Its capabilities span geo-grid rank tracking, Google Business Profile (GBP) auditing, cross-platform review intelligence across Google, Tripadvisor, and Trustpilot, NAP (name, address, phone) verification, competitor radius mapping, and LocalBusiness schema generation from API data. It triggers on terms such as "maps", "geo-grid", "rank tracking", "GBP audit", "review velocity", "competitor radius", "Share of Local Voice", and "SoLV". A clear boundary separates it from seo-local: this skill analyzes the business on maps PLATFORMS via APIs, while seo-local analyzes website-level local SEO signals.

The skill detects one of three capability tiers before any analysis and always communicates the detected tier. Tier 0 (free) uses Overpass, Geoapify, and Nominatim for competitor discovery, POI search, geocoding, a static GBP checklist, schema generation, and NAP guidance. Tier 1 adds DataForSEO when its MCP tools are available, unlocking geo-grid rank tracking, live GBP profile audits, review intelligence (velocity, sentiment, distribution), GBP posts, Q&A, and Tripadvisor/Trustpilot reviews. Tier 2 adds the Google Maps Platform when an API key is present, enabling Places details, real-time status, AI place summaries, and photo analysis, subject to Google ToS storage limits. Reference documents are loaded on demand per capability and workflow.

Several workflows are spelled out. Geo-grid rank tracking geocodes the business, generates grid points (default 7x7, 5km radius) with a Haversine offset, requires a cost estimate and confirmation, fires DataForSEO Maps SERP calls per point, computes Share of Local Voice as (top_3_count / total_points) * 100, and renders an ASCII heatmap. The GBP audit scores 25 profile fields with weighting and 0-100 normalization. Review intelligence computes velocity, applies the 18-day rule, analyzes rating distribution and owner response rate, and flags likely fake reviews using multiple signals. Competitor radius mapping, cross-platform NAP verification with severity-graded discrepancies, and LocalBusiness JSON-LD generation round out the toolset, with mandatory cost warnings before consuming DataForSEO credits.