mcpField
S
seo-maps

seo-maps

github.com/agricidaniel营销与增长23.3k6.4k 次安装6 天前更新
代码仓库

关于 seo-maps

面向本地商家的地图平台分析技能，通过外部 API 评估企业在 Google Maps、Bing Places、Apple Maps 和 OpenStreetMap 的展示情况。它根据可用能力层级提供竞争对手、排名网格、评价、NAP 与商家资料分析。

主要功能

  1. 01评估多地图平台商家展示
  2. 02扫描地理网格排名
  3. 03分析评价速度与情绪
  4. 04绘制半径内竞争格局
  5. 05核对跨平台名称地址电话
  6. 06生成 LocalBusiness JSON-LD

适用场景

  1. 01检查多地图平台的商家信息一致性
  2. 02比较不同区域的地图排名
  3. 03审查 Google Business Profile 与评价
  4. 04为本地商家生成结构化数据

MCP 相关

该技能可检测 DataForSEO MCP 工具是否可用，并据此选择分析能力层级。DataForSEO 可提供地理网格排名、商家资料审计和评价分析等功能。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agricidaniel/claude-seo --skill seo-maps

安装后在 Claude Code 中输入/seo-maps确认已加载。

附带文件LICENSE.txt

详细介绍

地图情报（2026 年 3 月）

面向本地商家的地图平台分析。通过外部 API 评估商家在 Google 地图、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>地理网格排名扫描（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-LD0+
/seo maps gbp <business> <location>GBP 完整度审计1+

三层能力检测

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

层级 0（免费）

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

层级 1（DataForSEO）

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

层级 2（DataForSEO + Google Maps Platform）

**检测：**层级 1 可用，且环境中存在 Google Maps API 密钥。 **能力：**包含层级 1 的所有功能，外加 Google Places 详情、实时商家状态、AI 驱动的地点摘要、照片分析。 **注意：**Google 服务条款限制只能存储 place_id。纬度/经度最多缓存 30 天。

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

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

模拟从多个 GPS 坐标进行 Google 地图搜索，以展示某个地理区域内的排名变化。需要 DataForSEO。

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

工作流
  1. 对商家地址进行地理编码，获取中心点纬度/经度
  2. 使用 Haversine 偏移公式生成网格点（默认：7×7，半径 5 公里）
  3. 显示费用估算，并在继续前征求确认
  4. 针对每个网格点，使用 location_coordinate 发起 DataForSEO Maps SERP API 调用
  5. 查找目标商家在每个点的排名
  6. 计算 SoLV：(top_3_count / total_points) * 100
  7. 在输出中渲染 ASCII 热力图
  8. 保存网格，以便之后进行比较，并供 seo-cockpit 地图视图使用： {business-slug}-maps/geo-grid-{keyword-slug}-{YYYY-MM-DD}.json，包含 {"business", "keyword", "location", "date", "size", "radius_km", "solv", "ranks": [[...], ...]}，其中 ranks 按行优先从西北到东南排列；每个单元格的值为商家在该点的排名（整数），若未出现在结果中则为 null
费用警告（必需）

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

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 个字段。

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

AI 与 2026 年背景（第三方报道）： 据 AP News 报道，Ask Maps 是 Gemini 对话式地图功能，于 2026-03-12 上线（iOS/Android，美国 + 印度）。据 Google 在 I/O 2026 上表示，AI Mode（每月用户超过 10 亿）越来越多地以第三方术语呈现 1-2 个商家的本地 AI 界面；此外，I/O 2026 还宣布了面向本地服务（家庭维修、美容、宠物护理）的智能体预订/拨打电话功能，将于夏季在美国推出（Google 可代表用户致电商家）；承诺提供该功能前，请确认当前可用情况。 GBP API 于 2026 年新增：评论媒体 URL、定期安排本地帖子、评论回复状态/审核，以及邀请 Place ID。来源： blog.google/products-and-platforms/products/search/search-io-2026/ · developers.google.com/my-business/content/latest-updates

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 信号（Maps 嵌入、地点引用、评论小组件）
  3. 根据可检测到的信号应用静态清单
  4. 将无法检测的字段标记为“未知（需要 DataForSEO 提供实时数据）”

评论情报（Tier 1+）

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

参考： ../seo/references/local-seo-signals.md，查看基准数据（与 seo-local 共用）。

工作流
  1. 通过 DataForSEO Reviews API 获取 Google 评论（按最新排序）
  2. 计算评论增长速度：过去 6 个月的月均评论数
  3. 检查评论间隔：长时间没有新评论会带来排名风险（Sterling Sky 的 2025 年案例显示，18 天没有评论后排名下降；这并非固定阈值）
  4. 分析评分分布：健康的分布呈钟形曲线，且偏向 5 星
  5. 计算商家回复率：回复数 / 评论总数
  6. 获取 Tripadvisor 和 Trustpilot 评论（如有）
  7. 制作跨平台对比表
虚假评论检测信号

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

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

竞争对手范围映射（Tier 0+）

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

Tier 0（Overpass API）

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

  1. 对商家地址进行地理编码
  2. 查询 Overpass API，查找范围内具有相同 OSM 标签的商家
  3. 解析结果：名称、地址、电话、网站、与中心点的距离
  4. 按距离排序，并以竞争格局表格呈现
Tier 1（DataForSEO）
  1. 使用 Maps SERP API 和商家关键词 + 地点
  2. 提取排名前 20 的竞争对手及其完整资料
  3. 对比：评分、评论数、类别、照片、属性
  4. 计算竞争密度得分：每平方公里的竞争对手数量

跨平台 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 —— 验证/认领 Apple 企业列表是否存在；在 Apple 确认之前，将有关 Apple Business 发布/更名的说法视为来源于 TechRadar）
    • OSM：使用 Overpass 或 Nominatim 搜索
  2. 从各个来源提取 NAP（名称、地址、电话）
  3. 比较一致性：完全匹配、部分匹配、缺失或冲突
  4. 将差异标记为 Critical（名称不匹配）、High（地址不匹配）、Medium（电话不匹配）
  5. 建议认领尚未认领的资料

Schema 生成（Tier 0+）

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

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

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

不要生成自我推广的评价标记——Google 会忽略企业自身的 LocalBusiness 评价标记。只标记页面上可见的第三方评价。

参考文件

按需加载（启动时不要全部加载）：

  • ../seo/references/maps-api-endpoints.md：DataForSEO 端点详情、参数、费用
  • ../seo/references/maps-free-apis.md：Overpass、Geoapify、Nominatim 查询模板
  • ../seo/references/maps-geo-grid.md：网格算法、SoLV 公式、热力图渲染
  • ../seo/references/maps-gbp-checklist.md：包含行业权重的 25 项 GBP 审核清单
  • ../seo/references/local-seo-signals.md：排名因素、评价基准（共用）
  • ../seo/references/local-schema-types.md：各行业的 LocalBusiness 子类型（共用）
  • ../seo/references/local-schema-multilocation.md：多地点 Schema 模式（共用）

输出

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

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

跨技能委派

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

错误处理

场景操作
DataForSEO MCP 不可用降至 Tier 0。告知用户：“未检测到 DataForSEO。正在运行免费版分析。如需地理网格跟踪和评论情报，请安装 DataForSEO 扩展。”
在 Maps SERP 中找不到商家使用关键字尝试 My Business Info。如果仍未找到，则报告“在此位置的 Google 地图中找不到该商家。”
地理编码失败（Nominatim）请用户提供坐标或更具体的地址。
达到 API 速率限制报告该限制。建议等待，或改用标准（排队）方法，而非实时方法。
未找到评论报告评论数为零。建议制定评论生成策略并保持稳定频率（间隔不要超过约 2 到 3 周）。
检测到多个位置询问用户要分析哪个位置，或提供批处理模式并估算每个位置的费用。

评论

支持 Markdown