seo-maps
installsforks
How to install seo-maps?
agricidaniel/claude-seo/seo-maps
$npx -y skills add AgriciDaniel/claude-seo --skill seo-mapsMaps 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
SKILL.md
| 1 | # Maps Intelligence (March 2026) |
| 2 | |
| 3 | Maps platform analysis for local businesses. Works with external APIs to assess |
| 4 | how a business appears on Google Maps, Bing Places, Apple Maps, and OpenStreetMap. |
| 5 | |
| 6 | **Boundary with seo-local:** This skill analyzes the business on maps PLATFORMS |
| 7 | (via APIs). seo-local analyzes local SEO signals on the WEBSITE (via HTML fetch). |
| 8 | Do not duplicate seo-local on-page analysis. Recommend `/seo local <url>` for |
| 9 | website-level checks. |
| 10 | |
| 11 | --- |
| 12 | |
| 13 | ## Quick Reference |
| 14 | |
| 15 | | Command | What it does | Tier | |
| 16 | |---------|-------------|------| |
| 17 | | `/seo maps <url>` | Full maps presence audit (auto-selects tier) | 0+ | |
| 18 | | `/seo maps grid <keyword> <location>` | Geo-grid rank scan (7x7, 1 keyword default) | 1+ | |
| 19 | | `/seo maps reviews <business> <location>` | Cross-platform review intelligence | 1+ | |
| 20 | | `/seo maps competitors <keyword> <location>` | Competitor radius mapping | 0+ | |
| 21 | | `/seo maps nap <business-name>` | Cross-platform NAP verification | 0+ | |
| 22 | | `/seo maps schema <business-name>` | Generate LocalBusiness JSON-LD from data | 0+ | |
| 23 | | `/seo maps gbp <business> <location>` | GBP completeness audit | 1+ | |
| 24 | |
| 25 | --- |
| 26 | |
| 27 | ## Three-Tier Capability Detection |
| 28 | |
| 29 | Before any analysis, detect the available capability tier: |
| 30 | |
| 31 | ### Tier 0 (Free) |
| 32 | **Detection:** DataForSEO MCP tools NOT available. |
| 33 | **Capabilities:** Overpass API competitor discovery, Geoapify POI search, Nominatim geocoding, static GBP checklist, schema generation, cross-platform NAP guidance. |
| 34 | **Load:** `../seo/references/maps-free-apis.md` |
| 35 | |
| 36 | ### Tier 1 (DataForSEO) |
| 37 | **Detection:** `business_data_business_listings_search` MCP tool IS available. |
| 38 | **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. |
| 39 | **Load:** `../seo/references/maps-api-endpoints.md` |
| 40 | |
| 41 | ### Tier 2 (DataForSEO + Google Maps Platform) |
| 42 | **Detection:** Tier 1 available AND Google Maps API key in environment. |
| 43 | **Capabilities:** Everything in Tier 1 PLUS Google Places details, real-time business status, AI-powered place summaries, photo analysis. |
| 44 | **Note:** Google ToS restricts storage to `place_id` only. Lat/lng cached 30 days max. |
| 45 | |
| 46 | **Always communicate the detected tier to the user** at the start of analysis. |
| 47 | |
| 48 | --- |
| 49 | |
| 50 | ## Geo-Grid Rank Tracking (Tier 1+) |
| 51 | |
| 52 | Simulates Google Maps searches from multiple GPS coordinates to show ranking |
| 53 | variation across a geographic area. Requires DataForSEO. |
| 54 | |
| 55 | **Load:** `../seo/references/maps-geo-grid.md` for algorithm, SoLV formula, heatmap format. |
| 56 | **Load:** `../seo/references/maps-api-endpoints.md` for Maps SERP endpoint details. |
| 57 | |
| 58 | ### Workflow |
| 59 | |
| 60 | 1. Geocode business address to get center lat/lng |
| 61 | 2. Generate grid points (default: 7x7, 5km radius) using Haversine offset formula |
| 62 | 3. **Display cost estimate and ask for confirmation before proceeding** |
| 63 | 4. Fire DataForSEO Maps SERP API calls with `location_coordinate` per grid point |
| 64 | 5. Find target business rank at each point |
| 65 | 6. Calculate SoLV: `(top_3_count / total_points) * 100` |
| 66 | 7. Render ASCII heatmap in output |
| 67 | |
| 68 | ### Cost Warning (REQUIRED) |
| 69 | |
| 70 | Before every geo-grid scan, display: |
| 71 | ``` |
| 72 | Geo-Grid Scan: [keyword] at [location] |
| 73 | Grid: 7x7 (49 points) | Keywords: [N] | Est. cost: $[amount] |
| 74 | DataForSEO credits will be consumed. Proceed? |
| 75 | ``` |
| 76 | |
| 77 | --- |
| 78 | |
| 79 | ## GBP Profile Audit (Tier 1 preferred, Tier 0 manual) |
| 80 | |
| 81 | Audits the 25 fields that affect Google Business Profile quality and ranking. |
| 82 | |
| 83 | **Load:** `../seo/references/maps-gbp-checklist.md` for full checklist and scoring. |
| 84 | |
| 85 | > **AI & 2026 context (third-party reported):** **Ask Maps**, reported by AP News |
| 86 | > as a Gemini conversational Maps feature launched 2026-03-12 (iOS/Android, |
| 87 | > US + India). **AI Mode** (1B+ MAU, reported from Google I/O 2026 keynote coverage; not confirmed on a Google-owned source) |
| 88 | > increasingly surfaces 1-2 business local AI interfaces in third-party terminology, and **agentic |
| 89 | > booking/calling** for local services (home repair, beauty, pet care) rolls out |
| 90 | > to all US users summer 2026 (Google can call businesses on the user's behalf). |
| 91 | > New 2026 GBP API additions: review media URLs, recurring local-post scheduling, |
| 92 | > review reply-state/moderation, and invitation Place ID. Source: |
| 93 | > blog.google/products-and-platforms/products/search/searc |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
