seo-maps
Skill0 starsChanged 5 months agoMITView on GitHub
Maps intelligence for local SEO — geo-grid rank tracking, GBP profile auditing via API, review intelligence across Google/Tripadvisor/Trustpilot, cross-platform NAP verification (Google/Bing/Apple/OSM), competitor radius mapping, and LocalBusiness schema generation from API data. Three-tier capability: free (Overpass + Geoapify), DataForSEO (full intelligence), DataForSEO + Google (maximum coverage). Use when user says "maps", "geo-grid", "rank tracking", "GBP audit", "review velocity", "competitor radius", "maps analysis", "local rank tracking", "Share of Local Voice", or "SoLV".
20 other projects use a version of this, 15 of them edited.
Adopted by
Most recently taken up by
- gaznil/seo-skills-by-gazniledited, first seen Nov 16, 2026
- gaznilmuzammil12-prog/seo-skills-by-gazniledited, first seen Nov 16, 2026
- joaoguirunas/team-osedited, first seen Nov 15, 2026
- alpit-patel/seo-aeo-geo-kitedited, first seen Nov 8, 2026
- zhtyyx/codex-seoedited, first seen Nov 1, 2026
- susantedit/claude-skillsedited, first seen Oct 20, 2026
Used with
Projects with it also use seo-agentic, blog-brand and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
AgriciDanielSkillseo-agentic
Audit 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. Use when the user asks whether AI agents can use or browse the site, or about llms.txt or WebMCP. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).
Also in 4 projects that use this
gaznilmuzammil12-progSkillblog-brand
Establish durable brand and voice context for cross-skill consumption. Generates BRAND.md (audience, positioning, do/don't editorial rules, taboo phrases, competitor differentiation) and VOICE.md (existing persona JSON re-expressed as readable prose), both written to the project root. When present, all blog sub-skills auto-load these files before writing or reviewing. Pairs with blog-persona, which manages the structured persona JSON. Use when user says "blog brand", "create brand context", "brand voice doc", "BRAND.md", "VOICE.md", "establish editorial brand", "brand guidelines for blog".
Also in 3 projects that use this
gaznilmuzammil12-progSkillblog-cannibalization
Detect keyword cannibalization across blog posts by extracting primary keywords from titles and headings, clustering semantically similar targets, and flagging posts competing for the same search intent. Supports local-only mode (grep-based) and DataForSEO API mode (Page Intersection endpoint at ~$0.01/call). Outputs severity-scored report with merge or differentiate recommendations. Use when user says "cannibalization", "keyword overlap", "competing pages", "duplicate keywords", "cannibalize".
Also in 3 projects that use this
megastepSkillblog-calendar
Generate editorial calendars for blogs with topic clusters, publishing schedules, content decay detection, freshness update plans, seasonal opportunities, content mix formula, template integration, and distribution scheduling. Plans monthly or quarterly calendars optimized for SEO topic authority and AI citation freshness requirements (30-day update cycles). Use when user says "editorial calendar", "content calendar", "blog calendar", "publishing schedule", "blog plan", "content plan", "what should I write".
Also in 3 projects that use this
megastepSkillblog-chart
Generate dark-mode-compatible inline SVG data visualization charts for blog posts. Supports horizontal bar, grouped bar, donut, line, lollipop, area, and radar charts with automatic platform detection (HTML vs JSX/MDX). Enforces chart type diversity, accessible markup (role=img, aria-label), source attribution, and transparent backgrounds. Use when user says "blog chart", "generate chart", "data visualization", "svg chart", "blog graph", "visualize data", or when the blog-write workflow identifies chart-worthy data points (3+ comparable metrics, trends, before/after data).
Also in 3 projects that use this
- +6 more from gaznilmuzammil12-prog
- +1 more from megastep
Other versions20 projects use a version of this.
Word for word · 4
- agrivisionai/claude-skills★ 1100% same
- mahiunfiltered/claude-code-skills★ 1100% same
- bbeliso/belisodw-★ 0100% same
- Biznomad/claude-skills★ 0100% same
Edited · 15
- AgriciDaniel/claude-seo★ 30k76% same
- zhtyyx/codex-seo★ 15279% same
- joaoguirunas/team-os★ 687% same
- avalonreset/legends-seo-dungeon★ 487% same
- alpit-patel/seo-aeo-geo-kit★ 278% same
- ahmedaminsa/aljazeera360-mcp-server★ 089% same
- gaznil/seo-skills-by-gaznil★ 089% same
- gaznilmuzammil12-prog/seo-skills-by-gaznil★ 089% same
- Solnest-AI/solnest-seo-aeo★ 082% same
- susantedit/claude-skills★ 089% same
5 more not listed
Wrote their own version · 1
- david-corroy/skills-seo-geo★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository73 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ab-testingSkill
- ad-creativeSkill
- adsSkill
- ai-seoSkill
- analyticsSkill
- asoSkill
- churn-preventionSkill
- cold-emailSkill
- co-marketingSkill
- community-marketingSkill
- competitor-profilingSkill
- competitorsSkill
- content-strategySkill
- copy-editingSkill
- copywritingSkill
- croSkill
- customer-researchSkill
- directory-submissionsSkill
- emailsSkill
- free-toolsSkill
- imageSkill
- launchSkill
- lead-magnetsSkill
- marketing-ideasSkill
- marketing-loopsSkill
- marketing-planSkill
- marketing-psychologySkill
- offersSkill
- onboardingSkill
- paywallsSkill
- popupsSkill
- pricingSkill
- product-marketingSkill
- programmatic-seoSkill
- prospectingSkill
- public-relationsSkill
- referralsSkill
- revopsSkill
- sales-enablementSkill
- schemaSkill
- seo-auditSkill
- signupSkill
- site-architectureSkill
- smsSkill
- socialSkill
- videoSkill
- cyber-neoSkill
- seo-auditSkill
- seo-backlinksSkill
- seo-clusterSkill
- seo-competitor-pagesSkill
- seo-content-briefSkill
- seo-contentSkill
- seo-dataforseoSkill
- seo-driftSkill
- seo-ecommerceSkill
- seo-flowSkill
- seo-geoSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
10 rules. 6 are common, 0 are distinctive, and 4 are very specific to this project.
6
Common
Most of the 15 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 30
Do not duplicate seo-local on-page analysis.
- Common: line 51
Before any analysis, detect the available capability tier:
- Common: line 92
Before every geo-grid scan, display:
- Common: line 134
Check 18-day rule (Sterling Sky): any 3-week gap = ranking risk
- Common: line 167
Use Maps SERP API with business keyword + location
- Common: line 176
Check business listing consistency across Google, Bing Places, Apple, and OSM.
- Common: line 180
Search for business name on each platform:
- Very specific: line 202
Add recommended properties: telephone, url, geo, openingHoursSpecification, priceRange
- Very specific: line 203
Add strategic properties for multi-location: branchOf, areaServed, sameAs
- Very specific: line 204
Add aggregateRating if review data available
“Common” is measured: kept by at least 6 in 10 of the 15 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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 <url> for
website-level checks.
Quick Reference
| 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+ |
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
- Geocode business address to get center lat/lng
- Generate grid points (default: 7x7, 5km radius) using Haversine offset formula
- Display cost estimate and ask for confirmation before proceeding
- Fire DataForSEO Maps SERP API calls with
location_coordinateper grid point - Find target business rank at each point
- Calculate SoLV:
(top_3_count / total_points) * 100 - 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.
Tier 1 Workflow
- Fetch business profile via DataForSEO My Business Info API (keyword or CID)
- Map API response fields to 25-field checklist
- Score each field: Present + Optimized = 2pts, Present = 1pt, Missing = 0pts
- Apply industry-specific weight multipliers
- Normalize to 0-100 scale
Tier 0 Workflow
- Fetch the business website via WebFetch
- Extract any visible GBP signals (Maps embed, place references, review widgets)
- Apply static checklist based on detectable signals
- 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
- Fetch Google reviews via DataForSEO Reviews API (sort by newest)
- Calculate review velocity: reviews per month over last 6 months
- Check 18-day rule (Sterling Sky): any 3-week gap = ranking risk
- Analyze rating distribution: healthy = bell curve skewed to 5-star
- Calculate owner response rate: responses / total reviews
- Fetch Tripadvisor and Trustpilot reviews (if available)
- 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.
- Geocode business address
- Query Overpass API for businesses with same OSM tag within radius
- Parse results: name, address, phone, website, distance from center
- Sort by distance, present as competitor landscape table
Tier 1 (DataForSEO)
- Use Maps SERP API with business keyword + location
- Extract top 20 competitors with full profile data
- Compare: rating, review count, categories, photos, attributes
- 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
- 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 -- recommend Apple Business Connect at businessconnect.apple.com)
- OSM: Overpass or Nominatim search
- Extract NAP (Name, Address, Phone) from each source
- Compare for consistency: exact match, partial match, missing, or conflicting
- Flag discrepancies as Critical (name mismatch), High (address mismatch), Medium (phone mismatch)
- 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
- Determine most specific schema subtype for the industry
- Populate required properties:
@type,name,address,image - Add recommended properties:
telephone,url,geo,openingHoursSpecification,priceRange - Add strategic properties for multi-location:
branchOf,areaServed,sameAs - Add
aggregateRatingif review data available - 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:
- Maps Health Score: XX/100 with dimension breakdown table
- Capability tier detected (Tier 0 or Tier 1) with explanation of what's available
- Geo-grid heatmap (Tier 1): ASCII grid with SoLV percentage and average rank
- GBP profile audit: field-by-field scoring with industry-specific weights
- Review intelligence: velocity chart, rating distribution, response rate, cross-platform comparison
- Competitor landscape: count in radius, top 5 by rating/reviews, competitive density
- Cross-platform presence: Google/Bing/Apple/OSM listing status
- Schema recommendation: generated LocalBusiness JSON-LD (if missing or incomplete)
- Top 10 prioritized actions (Critical > High > Medium > Low)
- Cost report: DataForSEO credits consumed during analysis (Tier 1 only)
- Limitations disclaimer: what could not be assessed at current tier
Cross-Skill Delegation
- Website on-page local signals: recommend
/seo local <url> - Full AI search visibility: recommend
/seo geo <url> - Schema validation and fixes: recommend
/seo schema <url> - 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. |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

