seo-maps

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Maps Intelligence (March 2026)

地图智能工具（2026年3月）

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.

面向本地商家的地图平台分析工具。通过调用外部API评估商家在Google Maps、Bing Places、Apple Maps和OpenStreetMap上的展示情况。

与seo-local的边界划分： 本工具分析商家在地图平台上的表现（通过API）。seo-local则分析网站上的本地SEO信号（通过HTML抓取）。请勿重复seo-local的页面内分析。如需网站层面的检测，推荐使用

/seo local <url>

命令。

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+

命令	功能说明	可用层级
`/seo maps <url>`	完整地图展示情况审计（自动选择层级）	0+
`/seo maps grid <keyword> <location>`	地理网格排名扫描（默认7×7网格、1个关键词）	1+
`/seo maps reviews <business> <location>`	跨平台评论智能分析	1+
`/seo maps competitors <keyword> <location>`	竞争对手半径映射	0+
`/seo maps nap <business-name>`	跨平台NAP验证	0+
`/seo maps schema <business-name>`	基于数据生成LocalBusiness JSON-LD	0+
`/seo maps gbp <business> <location>`	GBP完整性审计	1+

Three-Tier Capability Detection

三级功能检测

Before any analysis, detect the available capability tier:

在执行任何分析前，先检测可用的功能层级：

Tier 0 (Free)

层级0（免费版）

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

检测条件： 无DataForSEO MCP工具权限。 功能： 通过Overpass API发现竞争对手、Geoapify POI搜索、Nominatim地理编码、静态GBP检查清单、Schema生成、跨平台NAP指导。 加载文件：

references/maps-free-apis.md

Tier 1 (DataForSEO)

层级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:

references/maps-api-endpoints.md

检测条件： 拥有

business_data_business_listings_search

MCP工具权限。 功能： 包含层级0的所有功能，新增地理网格排名跟踪、实时GBP档案审计、评论智能分析（速度、情感、分布）、GBP动态发布数据、问答数据、Tripadvisor/Trustpilot评论分析。 加载文件：

references/maps-api-endpoints.md

Tier 2 (DataForSEO + Google Maps Platform)

层级2（DataForSEO+Google Maps平台版）

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.

检测条件： 满足层级1条件，且环境中配置了Google Maps API密钥。 功能： 包含层级1的所有功能，新增Google Places详情、实时商家状态、AI驱动的地点摘要、图片分析。 注意： 根据Google服务条款，仅允许存储

place_id

。经纬度缓存最长为30天。

分析开始时，必须告知用户检测到的功能层级

Geo-Grid Rank Tracking (Tier 1+)

地理网格排名跟踪（层级1及以上）

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.

模拟从多个GPS坐标发起Google Maps搜索，展示不同地理区域的排名差异。需要DataForSEO权限。

加载文件：

references/maps-geo-grid.md

（包含算法、SoLV计算公式、热力图格式） 加载文件：

references/maps-api-endpoints.md

（包含Maps SERP端点详情）

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_coordinate
```
per grid point
Find target business rank at each point
Calculate SoLV:
```
(top_3_count / total_points) * 100
```
Render ASCII heatmap in output

对商家地址进行地理编码，获取中心经纬度
使用Haversine偏移公式生成网格点（默认：7×7网格，5公里半径）
执行前必须显示成本估算并请求用户确认
针对每个网格点，调用DataForSEO Maps SERP API，传入
```
location_coordinate
```
参数
查找目标商家在每个点的排名
计算SoLV：
```
(top_3_count / total_points) * 100
```
在输出中渲染ASCII热力图

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?

每次地理网格扫描前，必须显示：

地理网格扫描：[关键词] @ [地点]
网格：7×7（49个点） | 关键词数量：[N] | 预估成本：$[金额]
将消耗DataForSEO积分。是否继续？

GBP Profile Audit (Tier 1 preferred, Tier 0 manual)

GBP档案审计（优先层级1，层级0为手动模式）

Audits the 25 fields that affect Google Business Profile quality and ranking.

Load:

references/maps-gbp-checklist.md

for full checklist and scoring.

审计影响Google商家档案质量和排名的25个字段。

加载文件：

references/maps-gbp-checklist.md

（包含完整检查清单和评分规则）

Tier 1 Workflow

层级1工作流程

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

通过DataForSEO我的商家信息API（按关键词或CID）获取商家档案
将API响应字段映射到25字段检查清单
对每个字段评分：存在且优化=2分，仅存在=1分，缺失=0分
应用行业特定权重乘数
归一化至0-100分区间

Tier 0 Workflow

层级0工作流程

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)"

通过WebFetch获取商家网站
提取可见的GBP信号（地图嵌入、地点引用、评论组件）
基于可检测信号应用静态检查清单
将无法检测的字段标记为“未知（需DataForSEO获取实时数据）”

Review Intelligence (Tier 1+)

评论智能分析（层级1及以上）

Cross-platform review analysis: velocity, sentiment, rating distribution, fake detection.

Reference:

references/local-seo-signals.md

for benchmarks (shared with seo-local).

跨平台评论分析：速度、情感、评分分布、虚假评论检测。

参考文件：

references/local-seo-signals.md

（包含排名因素、评论基准，与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

通过DataForSEO评论API获取Google评论（按最新排序）
计算评论速度：过去6个月的月均评论数
检查18天规则（Sterling Sky）：任何3周空白期=排名风险
分析评分分布：健康状态为向5星倾斜的钟形曲线
计算商家回复率：回复数/总评论数
获取Tripadvisor和Trustpilot评论（如有）
生成跨平台对比表格

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

当评论符合以下2种及以上模式时标记：

发布时间统一（多条评论在同一天/同一小时发布）
评论者账号历史有限或仅发布过单条评论
地理位置不一致（评论者所在地与商家所在地不符）
突然出现大量5星评论（与历史基准不符）
评论内容完全相同或高度相似
评论量突然激增但无对应的营销活动

Competitor Radius Mapping (Tier 0+)

竞争对手半径映射（层级0及以上）

Identify and analyze competitors within a defined radius.

识别并分析指定半径范围内的竞争对手。

Tier 0 (Overpass API)

层级0（Overpass API）

Load:

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

加载文件：

references/maps-free-apis.md

（包含查询模板）

对商家地址进行地理编码
通过Overpass API查询相同OSM标签、半径范围内的商家
解析结果：名称、地址、电话、网站、与中心点的距离
按距离排序，生成竞争对手格局表格

Tier 1 (DataForSEO)

层级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

使用商家关键词+地点调用Maps SERP API
提取排名前20的竞争对手及其完整档案数据
对比：评分、评论数、分类、图片、属性
计算竞争密度得分：每平方公里内的竞争对手数量

Cross-Platform NAP Verification (Tier 0+)

跨平台NAP验证（层级0及以上）

Check business listing consistency across Google, Bing Places, Apple, and OSM.

检查商家在Google、Bing Places、Apple和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

在各平台搜索商家名称：
- Google：从GBP数据或Maps SERP结果推断
- Bing：调用
```
WebFetch https://www.bing.com/maps?q=BUSINESS+NAME+LOCATION
```
- Apple：手动检查（无公开API——推荐使用Apple Business Connect：businessconnect.apple.com）
- OSM：通过Overpass或Nominatim搜索
从各来源提取NAP（名称、地址、电话）信息
对比一致性：完全匹配、部分匹配、缺失或冲突
标记差异等级：严重（名称不匹配）、高（地址不匹配）、中（电话不匹配）
建议认领未被认领的商家档案

Schema Generation (Tier 0+)

Schema生成（层级0及以上）

Generate LocalBusiness JSON-LD markup from collected data.

Reference:

references/local-schema-types.md

for industry subtypes (shared with seo-local).

基于收集的数据生成LocalBusiness JSON-LD标记。

参考文件：

references/local-schema-types.md

（包含按行业划分的LocalBusiness子类型，与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
```
aggregateRating
```
if 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.

确定最符合行业的Schema子类型
填充必填属性：
```
@type
```
、
```
name
```
、
```
address
```
、
```
image
```

添加推荐属性：

telephone

、

url

、

geo

、

openingHoursSpecification

、

priceRange

添加针对多地点商家的策略属性：
```
branchOf
```
、
```
areaServed
```
、
```
sameAs
```
若有评论数据，添加
```
aggregateRating
```
属性
输出可直接部署的有效JSON-LD代码块

请勿生成自利性评论标记——Google会忽略商家自身添加的LocalBusiness评论标记。仅标记页面上可见的第三方评论。

Reference Files

参考文件

Load on-demand as needed (do NOT load all at startup):

```
references/maps-api-endpoints.md
```
: DataForSEO endpoint details, params, costs
```
references/maps-free-apis.md
```
: Overpass, Geoapify, Nominatim query templates
```
references/maps-geo-grid.md
```
: Grid algorithm, SoLV formula, heatmap rendering
```
references/maps-gbp-checklist.md
```
: 25-field GBP audit with industry weights
```
references/local-seo-signals.md
```
: Ranking factors, review benchmarks (shared)
```
references/local-schema-types.md
```
: LocalBusiness subtypes by industry (shared)

按需加载（启动时请勿全部加载）：

```
references/maps-api-endpoints.md
```
：DataForSEO端点详情、参数、成本
```
references/maps-free-apis.md
```
：Overpass、Geoapify、Nominatim查询模板
```
references/maps-geo-grid.md
```
：网格算法、SoLV计算公式、热力图渲染规则
```
references/maps-gbp-checklist.md
```
：25字段GBP审计清单及行业权重
```
references/local-seo-signals.md
```
：排名因素、评论基准（共享文件）
```
references/local-schema-types.md
```
：按行业划分的LocalBusiness子类型（共享文件）

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

生成

MAPS-ANALYSIS-{domain}.md

文件，包含以下内容：

地图健康评分：XX/100 及维度细分表格
检测到的功能层级（层级0或层级1）及可用功能说明
地理网格热力图（层级1）：ASCII网格，包含SoLV百分比和平均排名
GBP档案审计：按字段评分，应用行业特定权重
评论智能分析：速度图表、评分分布、回复率、跨平台对比
竞争对手格局：半径内数量、按评分/评论数排序的前5名、竞争密度
跨平台覆盖情况：Google/Bing/Apple/OSM商家列表状态
Schema建议：生成的LocalBusiness JSON-LD（若缺失或不完整）
十大优先行动项（严重>高>中>低）
成本报告：分析过程中消耗的DataForSEO积分（仅层级1）
局限性声明：当前层级无法评估的内容

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]
```

网站页面内本地信号：推荐使用
```
/seo local <url>
```
完整AI搜索可见性：推荐使用
```
/seo geo <url>
```
Schema验证与修复：推荐使用
```
/seo schema <url>
```
实时SERP与关键词数据：推荐使用
```
/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.

场景	处理动作
无DataForSEO MCP权限	降级至层级0。告知用户：“未检测到DataForSEO权限。将运行免费版分析。如需地理网格跟踪和评论智能分析，请安装DataForSEO扩展。”
地图SERP中未找到商家	尝试通过关键词调用我的商家信息API。若仍未找到，提示“该地点的Google Maps中未找到此商家。”
地理编码失败（Nominatim）	请求用户提供坐标或更具体的地址。
触发API速率限制	告知用户速率限制。建议等待或使用标准（队列）模式替代实时模式。
未找到评论	提示无评论状态。推荐遵循18天周期的评论生成策略。
检测到多地点商家	询问用户需分析的地点，或提供批量模式及单地点成本估算。