Mmcp.market

seo-maps skill

by AgriciDaniel·AgriciDaniel/claude-seo·18k stars·MIT

Maps intelligence for local SEO: geo-grid rank tracking, GBP profile auditing via API, review intelligence across Google/Tripadvisor/Trustpilot, cross-platform NAP verification, competitor radius mapping, and LocalBusiness schema generation. Three tiers: free (Overpass + Geoapify), DataForSEO, and DataForSEO + Google. Use when user says "maps", "geo-grid", "rank tracking", "GBP audit", "review velocity", "competitor radius", or "SoLV".

A100/100content scan

Is the seo-maps skill safe?

Clean: nothing in its files matched our rules. We read 2 files in the folder on 2026-09-28.

No findings.

Install the seo-maps skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description. 

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git /tmp/claude-seo
mkdir -p ~/.claude/skills
cp -r /tmp/claude-seo/skills/seo-maps ~/.claude/skills/seo-maps
available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

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

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: businessdatabusinesslistingssearch 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: (top3count / totalpoints) 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
  1. Extract NAP (Name, Address, Phone) from each source
  2. Compare for consistency: exact match, partial match, missing, or conflicting
  3. Flag discrepancies as Critical (name mismatch), High (address mismatch), Medium (phone mismatch)
  4. Recommend claiming unclaimed profiles

Schema Generation (Tier 0+)

More skills from AgriciDaniel/claude-seo

  • AseoComprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews/ChatGPT/Perplexity. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed. Use this hub only when the SEO domain is clear and the requested workflow is not; otherwise use the exact retained leaf or command.
  • Aseo-agenticAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).
  • Aseo-ahrefsAhrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/mcp@0.0.11 server. Pairs with seo-backlinks for multi-source confidence weighting.
  • Aseo-auditRun a full-site SEO audit and return a scored, prioritized report. Use only for site-wide checks; use seo-page for one URL or seo-technical for a technical-only review.
  • Aseo-backlinksAnalyze a site's backlink profile, anchors, toxic signals, competitors, gaps, and disavow candidates. Use only when links or referring domains are the requested focus.
  • Aseo-bingBing Webmaster Tools + IndexNow extension. Microsoft Copilot citations are fed by the Bing index; this skill makes Bing visibility, link data, and IndexNow URL submission first-class.
  • Aseo-clusterCluster keywords by SERP overlap and design hub-and-spoke content architecture with internal links. Use for planning only; use the blog-cluster command to execute article production.
  • Aseo-competitor-pagesGenerate SEO-optimized competitor comparison and alternatives pages. Covers "X vs Y" layouts, "alternatives to X" pages, feature matrices, schema markup, and conversion optimization. Use when user says "comparison page", "vs page", "alternatives page", "competitor comparison", "X vs Y", "versus", "compare competitors", or "alternative to".
  • Aseo-contentEvaluate page content for usefulness, E-E-A-T, readability, thinness, and AI citation readiness, plus last-mile draft cleanup (AI-typical phrasing and invisible Unicode watermark characters). Use for content-only analysis, not full-page technical checks.
  • Aseo-content-briefGenerate competitive SEO content briefs with per-section word counts, competitor scoring, keyword density guidance, and page-type templates. Supports both new page briefs and improve-existing-page briefs. Use when user says "content brief", "write a brief", "content outline", "blog brief", "service page brief", "brief for", "writing brief", "content plan", or "outline for".
  • Aseo-dataforseoLive SEO data via DataForSEO MCP server: SERP analysis, keyword research (volume, difficulty, intent, trends), backlink profiles, on-page analysis, competitor and content analysis, business listings, AI visibility (LLM mention tracking), and domain analytics. Requires DataForSEO extension installed. Use when user says "dataforseo", "live SERP", "keyword volume", "backlink data", "AI visibility check", or "real search data".
  • Aseo-dataforseoLive SEO data via DataForSEO MCP server: SERP analysis, keyword research (volume, difficulty, intent, trends), backlink profiles, on-page analysis, competitor and content analysis, business listings, AI visibility (LLM mention tracking), and domain analytics. Requires DataForSEO extension installed. Use when user says "dataforseo", "live SERP", "keyword volume", "backlink data", "AI visibility check", or "real search data".

All agent skills → · MCP servers