# Seo Maps > Inteligencia de mapas para SEO local: rastreo de ranking en grilla geográfica, auditoría de GBP vía API, inteligencia de reseñas en Google/Tripadvisor/Trustpilot, verificación cruzada de NAP y mapeo de competidores por radio. Fuente: https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-maps Markdown: https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-maps.md Repositorio: https://github.com/AgriciDaniel/claude-seo Autor: AgriciDaniel Licencia: MIT Actualizado: el mes pasado Coste de contexto: 110 tok instalada, 2.9k tok al activarse, 3k tok con todos los archivos del bundle Bundle: 2 archivos, 12 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add AgriciDaniel/claude-seo --skill seo-maps --agent claude-code # Cursor npx -y skills add AgriciDaniel/claude-seo --skill seo-maps --agent cursor # Codex npx -y skills add AgriciDaniel/claude-seo --skill seo-maps --agent codex # Gemini CLI npx -y skills add AgriciDaniel/claude-seo --skill seo-maps --agent gemini # Windsurf npx -y skills add AgriciDaniel/claude-seo --skill seo-maps --agent windsurf # Cline npx -y skills add AgriciDaniel/claude-seo --skill seo-maps --agent cline ``` ## Qué hace - Detecta el tier de capacidad disponible (gratis con Overpass/Geoapify, DataForSEO, o DataForSEO + Google Maps) y lo comunica antes de analizar - Con DataForSEO, escanea un grid geográfico (7x7 por defecto) para medir el ranking del negocio en distintos puntos y calcula el Share of Local Visibility (SoLV) - Analiza velocidad y autenticidad de reseñas cruzando varias plataformas, y detecta patrones de reseñas falsas - Genera schema LocalBusiness listo a partir de los datos recolectados, sin marcar reseñas propias (Google las ignora) ## Cuándo usarla - El usuario pide 'maps', 'geo-grid', 'rank tracking', 'GBP audit' o 'competitor radius' ## Qué la activa - "Haz un rastreo de ranking en grilla para mi negocio local" - "Audita mi perfil de Google Business Profile" ## Antes de instalar - El tier gratuito usa Overpass/Geoapify/Nominatim; el rastreo de grilla y la auditoría completa de GBP requieren la extensión DataForSEO. ## Archivos - LICENSE.txt — 143 B - SKILL.md — 11 KB ## SKILL.md Reproducido tal cual desde AgriciDaniel/claude-seo bajo MIT. Esta sección es el documento original y está en inglés. # 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 ` for website-level checks. --- ## Quick Reference | Command | What it does | Tier | |---------|-------------|------| | `/seo maps ` | Full maps presence audit (auto-selects tier) | 0+ | | `/seo maps grid ` | Geo-grid rank scan (7x7, 1 keyword default) | 1+ | | `/seo maps reviews ` | Cross-platform review intelligence | 1+ | | `/seo maps competitors ` | Competitor radius mapping | 0+ | | `/seo maps nap ` | Cross-platform NAP verification | 0+ | | `/seo maps schema ` | Generate LocalBusiness JSON-LD from data | 0+ | | `/seo maps gbp ` | 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:** `../seo/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:** `../seo/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:** `../seo/references/maps-geo-grid.md` for algorithm, SoLV formula, heatmap format. **Load:** `../seo/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: `(top_3_count / total_points) * 100` 7. Render ASCII heatmap in output ### Cost Warning (REQUIRED) Before every geo-grid scan, display: ``` Geo-Grid Scan: [keyword] at [location] Grid: 7x7 (49 points) | Keywords: [N] | Est. cost: $[amount] DataForSEO credits will be consumed. Proceed? ``` --- ## GBP Profile Audit (Tier 1 preferred, Tier 0 manual) Audits the 25 fields that affect Google Business Profile quality and ranking. **Load:** `../seo/references/maps-gbp-checklist.md` for full checklist and scoring. > **AI & 2026 context (third-party reported):** **Ask Maps**, reported by AP News > as a Gemini conversational Maps feature launched 2026-03-12 (iOS/Android, > US + India). **AI Mode** (1B+ MAU, reported from Google I/O 2026 keynote coverage; not confirmed on a Google-owned source) > increasingly surfaces 1-2 business local AI interfaces in third-party terminology, and **agentic > booking/calling** for local services (home repair, beauty, pet care) rolls out > to all US users summer 2026 (Google can call businesses on the user's behalf). > New 2026 GBP API additions: review media URLs, recurring local-post scheduling, > review reply-state/moderation, and invitation Place ID. Source: > blog.google/products-and-platforms/products/search/search-io-2026/ · > developers.google.com/my-business/content/latest-updates ### Tier 1 Workflow 1. Fetch business profile via DataForSEO My Business Info API (keyword or CID) 2. Map API response fields to 25-field checklist 3. Score each field: Present + Optimized = 2pts, Present = 1pt, Missing = 0pts 4. Apply industry-specific weight multipliers 5. Normalize to 0-100 scale ### Tier 0 Workflow 1. Fetch the business website via WebFetch 2. Extract any visible GBP signals (Maps embed, place references, review widgets) 3. Apply static checklist based on detectable signals 4. Mark undetectable fields as "Unknown (requires DataForSEO for live data)" --- ## Review Intelligence (Tier 1+) Cross-platform review analysis: velocity, sentiment, rating distribution, fake detection. **Reference:** `../seo/references/local-seo-signals.md` for benchmarks (shared with seo-local). ### Workflow 1. Fetch Google reviews via DataForSEO Reviews API (sort by newest) 2. Calculate review velocity: reviews per month over last 6 months 3. Check 18-day rule (Sterling Sky): any 3-week gap = ranking risk 4. Analyze rating distribution: healthy = bell curve skewed to 5-star 5. Calculate owner response rate: responses / total reviews 6. Fetch Tripadvisor and Trustpilot reviews (if available) 7. Cross-platform comparison table ### Fake Review Detection Signals Flag reviews matching 2+ of these patterns: - Uniform timing (multiple reviews same day/hour) - Reviewer accounts with limited history or single review - Geographic inconsistencies (reviewer location vs business location) - Exclusively 5-star velocity spike (vs historical baseline) - Identical or near-identical text across reviews - Sudden volume spike without corresponding marketing activity --- ## Competitor Radius Mapping (Tier 0+) Identify and analyze competitors within a defined radius. ### Tier 0 (Overpass API) **Load:** `../seo/references/maps-free-apis.md` for query templates. 1. Geocode business address 2. Query Overpass API for businesses with same OSM tag within radius 3. Parse results: name, address, phone, website, distance from center 4. Sort by distance, present as competitor landscape table ### Tier 1 (DataForSEO) 1. Use Maps SERP API with business keyword + location 2. Extract top 20 competitors with full profile data 3. Compare: rating, review count, categories, photos, attributes 4. Calculate competitive density score: competitors per km^2 --- ## Cross-Platform NAP Verification (Tier 0+) Check business listing consistency across Google, Bing Places, Apple, and OSM. ### Workflow 1. Search for business name on each platform: - Google: infer from GBP data or Maps SERP result - Bing: `WebFetch https://www.bing.com/maps?q=BUSINESS+NAME+LOCATION` - Apple: manual check (no public API -- verify/claim Apple business listing presence; treat Apple Business launch/rename claims as TechRadar-sourced until confirmed by Apple primary) - OSM: Overpass or Nominatim search 2. Extract NAP (Name, Address, Phone) from each source 3. Compare for consistency: exact match, partial match, missing, or conflicting 4. Flag discrepancies as Critical (name mismatch), High (address mismatch), Medium (phone mismatch) 5. Recommend claiming unclaimed profiles --- ## Schema Generation (Tier 0+) Generate LocalBusiness JSON-LD markup from collected data. **Reference:** `../seo/references/local-schema-types.md` for industry subtypes (shared with seo-local). ### Workflow 1. Determine most specific schema subtype for the industry 2. Populate required properties: `@type`, `name`, `address`, `image` 3. Add recommended properties: `telephone`, `url`, `geo`, `openingHoursSpecification`, `priceRange` 4. Add strategic properties for multi-location: `branchOf`, `areaServed`, `sameAs` 5. Add `aggregateRating` if review data available 6. Output valid JSON-LD block ready for implementation **Do NOT generate self-serving review markup** -- Google ignores LocalBusiness review markup from the business itself. Only mark up third-party reviews visible on the page. --- ## Reference Files Load on-demand as needed (do NOT load all at startup): - `../seo/references/maps-api-endpoints.md`: DataForSEO endpoint details, params, costs - `../seo/references/maps-free-apis.md`: Overpass, Geoapify, Nominatim query templates - `../seo/references/maps-geo-grid.md`: Grid algorithm, SoLV formula, heatmap rendering - `../seo/references/maps-gbp-checklist.md`: 25-field GBP audit with industry weights - `../seo/references/local-seo-signals.md`: Ranking factors, review benchmarks (shared) - `../seo/references/local-schema-types.md`: LocalBusiness subtypes by industry (shared) --- ## Output Generate `MAPS-ANALYSIS-{domain}.md` with: 1. **Maps Health Score: XX/100** with dimension breakdown table 2. **Capability tier detected** (Tier 0 or Tier 1) with explanation of what's available 3. **Geo-grid heatmap** (Tier 1): ASCII grid with SoLV percentage and average rank 4. **GBP profile audit**: field-by-field scoring with industry-specific weights 5. **Review intelligence**: velocity chart, rating distribution, response rate, cross-platform comparison 6. **Competitor landscape**: count in radius, top 5 by rating/reviews, competitive density 7. **Cross-platform presence**: Google/Bing/Apple/OSM listing status 8. **Schema recommendation**: generated LocalBusiness JSON-LD (if missing or incomplete) 9. **Top 10 prioritized actions** (Critical > High > Medium > Low) 10. **Cost report**: DataForSEO credits consumed during analysis (Tier 1 only) 11. **Limitations disclaimer**: what could not be assessed at current tier --- ## Cross-Skill Delegation - Website on-page local signals: recommend `/seo local ` - Full AI search visibility: recommend `/seo geo ` - Schema validation and fixes: recommend `/seo schema ` - Live SERP and keyword data: recommend `/seo dataforseo [command]` --- ## Error Handling | Scenario | Action | |----------|--------| | DataForSEO MCP not available | Drop to Tier 0. Inform user: "DataForSEO not detected. Running free-tier analysis. For geo-grid tracking and review intelligence, install the DataForSEO extension." | | Business not found in Maps SERP | Try My Business Info with keyword. If still not found, report "Business not found in Google Maps for this location." | | Geocoding fails (Nominatim) | Ask user to provide coordinates or a more specific address. | | API rate limit hit | Report the limit. Suggest waiting or using standard (queued) method instead of live. | | No reviews found | Report zero review state. Recommend review generation strategy with 18-day cadence target. | | Multi-location detected | Ask user which location to analyze, or offer batch mode with per-location cost estimate. | ## Dónde encaja - Categoría: [SEO y GEO](https://skillsagentes.com/categorias/seo-geo.md) — Keywords, auditorías on-page, datos estructurados y visibilidad en respuestas de IA. - Creador: [AgriciDaniel](https://skillsagentes.com/creators/agricidaniel.md) — 31 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Seo Google](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-google.md): APIs SEO de Google: Search Console, PageSpeed Insights, CrUX con historial de 25 semanas, Indexing API y tráfico orgánico de GA4. Da datos reales de campo para Core Web Vitals, indexación, rendimiento de búsqueda y tráfico. - [Seo Flow](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-flow.md): Integración del framework FLOW: SEO basado en evidencia con el ciclo Find → Leverage → Optimize → Win. Expone 41 prompts de IA por etapa desde la base de conocimiento FLOW (CC BY 4.0). - [Seo](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo.md): Análisis SEO integral para cualquier sitio: auditorías completas, análisis de una página, SEO técnico (rastreo, indexación, CWV con INP), schema, E-E-A-T, imágenes, sitemaps y GEO para AI Overviews/ChatGPT/Perplexity. - [Seo Audit](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-audit.md): Auditoría SEO completa del sitio con delegación paralela a sub-agentes. Rastrea hasta 500 páginas, detecta el tipo de negocio, delega en hasta 15 especialistas (8 siempre + 7 condicionales) y genera un health score. - [Seo Cluster](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-cluster.md): Agrupación semántica de keywords basada en solapamiento real de SERP (no similitud de texto) para planear arquitectura de contenido. Diseña clusters hub-and-spoke con matriz de enlaces internos y genera una visualización interactiva. ## Skills relacionadas - [Seo Firecrawl](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-firecrawl.md): Rastreo, scraping y mapeo de sitio completo vía Firecrawl MCP. Úsalo para 'crawl site', 'map site', 'full crawl', 'find all pages', 'broken links' o 'JS rendering'. - [Seo Seranking](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-seranking.md): Analista de visibilidad en IA con SE Ranking (extensión). Sigue el Share-of-Voice en ChatGPT, Gemini, Perplexity, AI Overviews y AI Mode en una sola consulta. - [Seo Competitor Pages](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-competitor-pages.md): Genera páginas de comparación y alternativas optimizadas para SEO: layouts 'X vs Y', páginas 'alternativas a X', matrices de funciones, schema y optimización de conversión. - [Seo Ecommerce](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-ecommerce.md): Análisis de SEO para e-commerce: visibilidad en Google Shopping, inteligencia de marketplace de Amazon, validación de schema Product, análisis de precios de competidores y brechas de keywords entre orgánico y Shopping. - [Seo Images](https://skillsagentes.com/skills/agricidaniel/claude-seo/seo-images.md): Análisis de optimización de imágenes para SEO y rendimiento: alt text, tamaño de archivo, formato, imágenes responsive, lazy loading, prevención de CLS, ranking en SERP de imágenes y optimización de archivos. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)