From claude-seo
Analyzes local SEO on maps platforms: geo-grid rank tracking, GBP audits via API, cross-platform reviews/NAP verification, competitor mapping, schema generation. Tiers by API access.
npx claudepluginhub agricidaniel/claude-seo --plugin claude-seoThis skill uses the workspace's default tool permissions.
Maps platform analysis for local businesses. Works with external APIs to assess
Guides strict Test-Driven Development (TDD): write failing tests first for features, bugfixes, refactors before any production code. Enforces red-green-refactor cycle.
Guides systematic root cause investigation for bugs, test failures, unexpected behavior, performance issues, and build failures before proposing fixes.
Guides A/B test setup with mandatory gates for hypothesis validation, metrics definition, sample size calculation, and execution readiness checks.
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.
| 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+ |
Before any analysis, detect the available capability tier:
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
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
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.
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.
location_coordinate per grid point(top_3_count / total_points) * 100Before 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?
Audits the 25 fields that affect Google Business Profile quality and ranking.
Load: references/maps-gbp-checklist.md for full checklist and scoring.
Cross-platform review analysis: velocity, sentiment, rating distribution, fake detection.
Reference: references/local-seo-signals.md for benchmarks (shared with seo-local).
Flag reviews matching 2+ of these patterns:
Identify and analyze competitors within a defined radius.
Load: references/maps-free-apis.md for query templates.
Check business listing consistency across Google, Bing Places, Apple, and OSM.
WebFetch https://www.bing.com/maps?q=BUSINESS+NAME+LOCATIONGenerate LocalBusiness JSON-LD markup from collected data.
Reference: references/local-schema-types.md for industry subtypes (shared with seo-local).
@type, name, address, imagetelephone, url, geo, openingHoursSpecification, priceRangebranchOf, areaServed, sameAsaggregateRating if review data availableDo 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.
Load on-demand as needed (do NOT load all at startup):
references/maps-api-endpoints.md: DataForSEO endpoint details, params, costsreferences/maps-free-apis.md: Overpass, Geoapify, Nominatim query templatesreferences/maps-geo-grid.md: Grid algorithm, SoLV formula, heatmap renderingreferences/maps-gbp-checklist.md: 25-field GBP audit with industry weightsreferences/local-seo-signals.md: Ranking factors, review benchmarks (shared)references/local-schema-types.md: LocalBusiness subtypes by industry (shared)Generate MAPS-ANALYSIS-{domain}.md with:
/seo local <url>/seo geo <url>/seo schema <url>/seo dataforseo [command]| 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. |