seo-maps

地图智能分析（2026 年 3 月）

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

**与 seo-local 的边界：**此技能通过 API 分析商家在地图平台上的情况。seo-local 通过获取 HTML 分析网站上的本地 SEO 信号。请勿重复 seo-local 的页面分析。网站级检查请推荐 /seo local <url>。

---

快速参考

命令	功能	层级
/seo maps <url>	全面的地图呈现情况审计（自动选择层级）	0+
/seo maps grid <keyword> <location>	地理网格排名扫描（7x7，默认 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+

---

三层能力检测

开始任何分析之前，检测可用的能力层级：

层级 0（免费）

**检测：**DataForSEO MCP 工具不可用，且 Apify MCP 工具不可用。 **能力：**通过 Overpass API 发现竞争对手、通过 Geoapify 搜索 POI、通过 Nominatim 进行地理编码、静态 GBP 检查清单、生成 schema、跨平台 NAP 指导。 加载：references/maps-free-apis.md

层级 0.5（Apify）

**检测：**DataForSEO MCP 工具不可用，但 Apify MCP 工具可用（名称中包含 apify 的任何工具）。 **能力：**包含层级 0 的所有能力，另有实时 Google Maps 商家数据、包含日期和文本的真实评论数据，以及 Yelp／TripAdvisor 跨平台呈现情况验证。 使用的 Actors：

• apify/google-maps-scraper — 商家名称、地址、电话、评分、评论数、营业时间、类别、坐标
• apify/google-maps-reviews-scraper — 评论文本、评分、日期、作者（支持评论速度和情感分析）
• apify/yelp-scraper — 用于跨平台 NAP 验证的 Yelp 商家信息 NAP 和评论

**与层级 1 相比的限制：**无法进行地理网格排名跟踪（每个坐标都需要 DataForSEO Maps SERP API）。无法计算 GBP 完整度评分。层级 0.5 支持竞争对手映射、评论情报分析和 NAP 验证，但不支持排名跟踪。

💡 Apify 未连接 — 正在使用层级 0（仅免费 API）。连接 Apify MCP 连接器，即可解锁实时 Google Maps 数据、评论速度分析和跨平台 NAP 验证，无需订阅 DataForSEO。

层级 1（DataForSEO）

检测：business_data_business_listings_search MCP 工具可用。 **能力：**包含层级 0 的所有能力，另有地理网格排名跟踪、实时 GBP 资料审计、评论情报分析（速度、情感、分布）、GBP 帖子活动、问答数据、Tripadvisor／Trustpilot 评论。 加载：references/maps-api-endpoints.md

层级 2（DataForSEO + Google Maps Platform）

**检测：**层级 1 可用，且环境中存在 Google Maps API 密钥。 **能力：**包含层级 1 的所有能力，另有 Google Places 详情、实时商家状态、AI 生成的地点摘要、照片分析。 **注意：**Google ToS 规定只能存储 place_id。纬度／经度最多缓存 30 天。

始终在分析开始时告知用户检测到的层级。

---

地理网格排名跟踪（层级 1+）

模拟从多个 GPS 坐标发起的 Google Maps 搜索，展示排名在某个地理区域内的变化情况。需要 DataForSEO。

加载：references/maps-geo-grid.md，了解算法、SoLV 公式和热力图格式。 加载：references/maps-api-endpoints.md，了解 Maps SERP 端点详情。

工作流

1. 对商家地址进行地理编码，获取中心点的纬度/经度
2. 使用 Haversine 偏移公式生成网格点（默认：7x7，半径 5km）
3. 显示费用估算，并在继续前征求确认
4. 针对每个网格点调用 DataForSEO Maps SERP API，并使用 location_coordinate
5. 查找目标商家在每个点的排名
6. 计算 SoLV：(top_3_count / total_points) * 100
7. 在输出中呈现 ASCII 热力图

费用警告（必需）

每次进行地理网格扫描前，显示：

Geo-Grid Scan: [keyword] at [location]
Grid: 7x7 (49 points) | Keywords: [N] | Est. cost: $[amount]
DataForSEO credits will be consumed. Proceed?

---

GBP 资料审核（优先使用 Tier 1，Tier 0 手动进行）

审核影响 Google Business Profile 质量和排名的 25 个字段。

加载： references/maps-gbp-checklist.md，查看完整清单和评分标准。

Tier 1 工作流

1. 通过 DataForSEO My Business Info API 获取商家资料（使用关键词或 CID）
2. 将 API 响应字段映射到 25 项字段清单
3. 为每个字段评分：已填写且已优化 = 2 分，已填写 = 1 分，缺失 = 0 分
4. 应用特定行业的权重乘数
5. 标准化为 0-100 分

Tier 0 工作流

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

---

评论情报（Tier 1+）

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

参考： references/local-seo-signals.md 中的基准（与 seo-local 共用）。

工作流

1. 通过 DataForSEO Reviews API 获取 Google 评论（按最新排序）
2. 计算评论速度：过去 6 个月内每月的评论数
3. 检查 18 天规则（Sterling Sky）：任何 3 周的间隔都意味着排名风险
4. 分析评分分布：健康分布应呈向 5 星倾斜的钟形曲线
5. 计算商家回复率：回复数 / 评论总数
6. 获取 Tripadvisor 和 Trustpilot 评论（如有）
7. 创建跨平台对比表

虚假评论检测信号

标记符合以下 2 项或更多模式的评论：

• 时间一致（多条评论发布于同一天/同一小时）
• 评论者账号历史记录有限或仅发布过一条评论
• 地理位置不一致（评论者所在位置与商家位置不符）
• 仅 5 星评论的速度激增（相较于历史基线）
• 多条评论的文本相同或近乎相同
• 评论量突然激增，但没有相应的营销活动

---

竞争对手半径绘图（Tier 0+）

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

Tier 0（Overpass API）

加载： references/maps-free-apis.md，查看查询模板。

1. 对商家地址进行地理编码
2. 查询 Overpass API，查找半径内具有相同 OSM 标签的商家
3. 解析结果：名称、地址、电话、网站、距中心点的距离
4. 按距离排序，并以竞争格局表格呈现

Tier 1（DataForSEO）

1. 使用 Maps SERP API，并提供商家关键词和位置
2. 提取前 20 个竞争对手的完整资料数据
3. 对比：评分、评论数、类别、照片、属性
4. 计算竞争密度评分：每 km^2 的竞争对手数

---

跨平台 NAP 核验（Tier 0+）

检查商家在 Google、Bing Places、Apple 和 OSM 上的商家信息一致性。

工作流

1. 在每个平台上搜索商家名称：
   • Google：根据 GBP 数据或 Maps SERP 结果推断
   • Bing：WebFetch https://www.bing.com/maps?q=BUSINESS+NAME+LOCATION
   • Apple：手动检查（没有公共 API——建议通过 businessconnect.apple.com 使用 Apple Business Connect）
   • OSM：使用 Overpass 或 Nominatim 搜索
2. 从每个来源提取 NAP（名称、地址、电话）
3. 对比一致性：完全匹配、部分匹配、缺失或冲突
4. 将差异标记为严重（名称不匹配）、高（地址不匹配）、中（电话不匹配）
5. 建议认领尚未认领的资料

---

架构生成（Tier 0+）

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

参考： references/local-schema-types.md，了解各行业子类型（与 seo-local 共用）。

工作流

1. 确定该行业最具体的架构子类型
2. 填充必需属性：@type、name、address、image
3. 添加建议属性：telephone、url、geo、openingHoursSpecification、priceRange
4. 为多地点业务添加战略属性：branchOf、areaServed、sameAs
5. 如果有评论数据，则添加 aggregateRating
6. 输出可直接用于实现的有效 JSON-LD 代码块

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

---

参考文件

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

• 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 子类型（共用）

---

输出

生成 MAPS-ANALYSIS-{domain}.md，包含：

1. 地图健康评分：XX/100，附维度明细表
2. 检测到的能力层级（Tier 0 或 Tier 1），并说明可用功能
3. 地理网格热力图（Tier 1）：ASCII 网格，显示 SoLV 百分比和平均排名
4. GBP 资料审核：逐字段评分，并采用行业专属权重
5. 评论情报：评论增长图表、评分分布、回复率、跨平台比较
6. 竞争对手概况：半径范围内的数量、评分/评论数排名前 5 的商家、竞争密度
7. 跨平台展示情况：Google/Bing/Apple/OSM 列表状态
8. 架构建议：生成 LocalBusiness JSON-LD（如果缺失或不完整）
9. 优先级最高的 10 项操作（Critical > High > Medium > Low）
10. 费用报告：分析期间消耗的 DataForSEO 积分（仅 Tier 1）
11. 限制免责声明：说明当前层级下无法评估的内容

---

跨技能委派

• 网站页面上的本地信号：建议使用 /seo local <url>
• 完整的 AI 搜索可见性分析：建议使用 /seo geo <url>
• 架构验证和修复：建议使用 /seo schema <url>
• 实时 SERP 和关键词数据：建议使用 /seo dataforseo [command]

---

错误处理

场景	操作
DataForSEO MCP 不可用	降级至 Tier 0。告知用户：“未检测到 DataForSEO。正在运行免费层级分析。如需地理网格跟踪和评论情报，请安装 DataForSEO 扩展。”
在 Maps SERP 中找不到商家	使用关键词尝试查询 My Business Info。如果仍未找到，则报告“在此位置的 Google Maps 中未找到该商家。”
地理编码失败（Nominatim）	请用户提供坐标或更具体的地址。
达到 API 速率限制	报告该限制。建议等待，或使用标准（排队）方式代替实时方式。
未找到评论	报告评论数为零。建议采用以 18 天为目标间隔的评论获取策略。
检测到多地点业务	询问用户要分析哪个地点，或提供批量模式并估算每个地点的费用。