mcpField
L
localseodata-tool

localseodata-tool

github.com/garrettjsmith营销与增长13665 次安装11 周前更新
代码仓库

关于 localseodata-tool

面向 LocalSEOSkills 的本地 SEO 数据源选择与操作指南,指导 Agent 使用 LocalSEOData 完成排名、评论、关键词及 AI 可见度分析,并说明何时改用其他工具。

主要功能

  1. 01本地排名与 SERP 查询
  2. 02评论和声誉分析
  3. 03关键词及竞争对手研究
  4. 04AI 搜索可见度分析
  5. 05按场景选择数据端点

适用场景

  1. 01为本地商家执行 SEO 审计
  2. 02研究本地关键词和竞争对手
  3. 03检查评论趋势与目录信息
  4. 04评估品牌在 AI 搜索中的表现

MCP 相关

该技能连接 LocalSEOData 的 MCP 服务,地址为 `https://mcp.localseodata.com/mcp`,并指导何时使用其端点。部分业务资料端点仍建议直接调用 REST API。

安装

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

$npx skills add https://github.com/garrettjsmith/localseoskills --skill localseodata-tool

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

详细介绍

LocalSEOData 工具

你可以通过 MCP 直接访问 LocalSEOData。它是 LocalSEOSkills 的默认数据源。将请求路由到其他工具之前,请先在此处查询。

MCP 服务: https://mcp.localseodata.com/mcp 文档: https://localseodata.com/docs

何时使用 LocalSEOData,何时使用其他工具

LocalSEOData 可在一个地方满足大多数本地 SEO 数据需求。只有在 LocalSEOData 确实无法完成任务时,才使用其他工具。

你的需求LocalSEOData改用
本地包排名✅ local_pack—
包含所有功能的完整 SERP✅ organic_serp—
Google Maps 结果✅ maps—
Local Finder 结果✅ local_finder—
地理网格排名扫描✅ geogrid_scanLocal Falcon:趋势、活动、Falcon Guard
商家资料数据✅ business_profile建议使用 REST API(即将支持 MCP)
Google 评论✅ google_reviews—
多平台评论✅ multi_platform_reviews—
评论增长趋势✅ review_velocity—
引用信息审计(NAP 一致性)✅ citation_audit—
完整本地 SEO 审计✅ local_audit—
声誉审计✅ reputation_audit—
资料健康检查✅ profile_health建议使用 REST API(即将支持 MCP)
页面 SEO 审计✅ page_audit全站爬取使用 Screaming Frog
竞争对手差距分析✅ competitor_gap—
关键词机会✅ keyword_opportunities—
关键词建议✅ keyword_suggestions—
相关关键词✅ related_keywords—
搜索量数据✅ search_volumekeyword_suggestions 也包含搜索量
关键词趋势✅ keyword_trends—
网站排名关键词✅ keywords_for_site—
反向链接摘要✅ backlink_summary深入分析反向链接使用 Ahrefs
反向链接差距分析✅ backlink_gap详细链接概况使用 Ahrefs
AI Overview 检测✅ ai_overview—
AI Mode 响应✅ ai_mode—
跨平台 AI 提及✅ ai_mentions—
AI 可见度评分✅ ai_visibility—
AI 引用次数最多的来源✅ ai_top_sources—
AI 引用次数最多的页面✅ ai_top_pages—
AI 关键词级数据✅ ai_keyword_data—
提示词的原始 AI/LLM 响应✅ ai_llm_response—
AI 抓取工具(从 AI 结果中提取)✅ ai_scraper—
AI 竞争对手对比✅ ai_compare—
Local Services Ads 数据✅ local_services_ads随时间跟踪市场情况使用 LSA Spy
竞争对手广告情报✅ competitor_ads—
按类别筛选商家信息✅ business_listings—
品牌提及✅ brand_mentions—
来自 GBP 的问答✅ qa(或 business_qa)—
本地权威度评分✅ local_authority—
随时间变化的排名趋势❌Local Falcon 趋势报告
GBP 变更监控❌Local Falcon(Falcon Guard)
定期扫描活动❌Local Falcon 活动
深入分析反向链接(锚文本、丢失的链接)❌Ahrefs
完整网站爬取(技术 SEO)❌Screaming Frog
实际流量/转化数据❌Google Analytics
实际点击/展示数据❌Google Search Console
随时间跟踪 LSA 市场情况❌LSA Spy

位置解析

许多端点都需要位置字符串。所需格式因端点类型而异:

端点组格式示例
SERP(organic_serp、local_pack、local_services_ads)location_search 返回的规范格式"Syracuse, NY,New York,United States"
Maps、Local Finderlocation_search 返回的规范格式"Syracuse, NY,New York,United States"
Business(profile、health、reviews、qa、listings)城市,州缩写"Buffalo, NY"
Reviews(multi_platform、velocity、reputation_audit)城市,州缩写"Buffalo, NY"
Competitor(competitor_gap、competitor_ads)城市,州缩写"Buffalo, NY"
Citation audit完整地址 + 电话(不是 location 参数)address: "123 Main St, Buffalo, NY 14201"
Keyword 端点(美国)城市,州全名"Syracuse, New York"
Keyword 端点(加拿大)城市,省份缩写"Port Colborne, ON"
AI 端点(keyword-data、visibility、mentions)城市,州全名"Syracuse, New York"
Local audit、local authority城市,州缩写"Buffalo, NY"
Geogrid scan城市,州缩写"Buffalo, NY"
Business listings城市,州缩写"Buffalo, NY"
Brand mentions仅企业名称(不含位置)business_name: "Ace Plumbing"

注意: API 现在会自动规范化美国州和加拿大省份的缩写(例如,将“NY”规范化为“New York”,将“ON”规范化为“Ontario”)。所有端点都应支持 "Buffalo, NY" 和 "Buffalo, New York"。

  • 首先使用 location_search 解析准确的位置名称(免费,0 积分,使用 GET 而非 POST)
  • 对于 Maps/Local Finder:准确使用 location_search 返回的规范 name 字段(逗号后不加空格)
  • 对于 keyword/AI 端点:使用“城市,州”的格式即可(缩写会在服务端展开)

核心工作流

完整的本地 SEO 审计(一次调用)

适用情况: 用户说“审计这家企业”“检查我的本地 SEO”或“我的排名有什么问题”。

使用: local_audit

business_name: "Ace Plumbing"
location: "Buffalo, NY"

一次调用即可返回本地包排名、有机排名、资料完整度、评论增长速度和竞争对手。50 积分。

这可以替代手动组合 3-4 种不同工具的数据。

Geogrid 排名扫描

适用情况: 用户想查看企业在某个地理区域内的排名情况。

使用: geogrid_scan

business: "Ace Plumbing"
keyword: "plumber near me"
location: "Buffalo, NY"
grid_size: "7x7"    # 5x5 (default), 7x7, or 9x9
radius_miles: 3     # default 3

这是一个异步操作 — 工具会轮询,直到结果就绪。返回排名网格、平均排名和覆盖率统计数据。

积分成本: 5x5 = 50 积分,7x7 = 98 积分,9x9 = 162 积分。(公式:网格点数 × 2。)

解读方法: 加载 geogrid-analysis 策略技能。

与 Local Falcon 相比的局限:

  • 没有趋势报告(无法比较不同时间的扫描结果)
  • 没有活动(没有定期自动扫描)
  • 没有 Falcon Guard(没有 GBP 变更监控)
  • 没有 AI 平台扫描(GAIO、ChatGPT、Gemini — 请改用 ai_visibility 端点)

一次性扫描和审计请使用 LocalSEOData geogrid。持续监控请使用 Local Falcon。

企业资料拉取

适用情况: 需要 GBP 数据用于审计、优化或报告。

使用: business_profile

business_name: "Ace Plumbing"
location: "Buffalo, NY"

返回:名称、评分、评论、地址、电话、网站、营业时间、类别、属性、照片数量、描述、验证状态。2 积分。

注意: 对于 business_profile 和 profile_health,请直接使用 REST API。这些端点的 MCP 支持正在开发中。

评论情报

适用场景: 用户需要评论数据、情感分析或增长速度追踪。

根据需求选择多个端点:

需求端点积分
查看近期评论google_reviews每 10 条评论 1 积分
跨平台评论multi_platform_reviews6
随时间变化的评论增长速度review_velocity6
全面声誉审计reputation_audit30

review_velocity 对持续服务的客户最有用——可显示每月评论数、评分趋势、回复率和情感主题。

reputation_audit 是功能最全面的工具——提供声誉评分、情感分析、回复率和建议。可用于新客户入驻或季度评审。

引用审计

适用场景: 用户想要检查各目录中的 NAP 一致性。

使用: citation_audit

business_name: "Ace Plumbing"
address: "123 Main St, Buffalo, NY 14201"
phone: "(716) 555-1234"

检查 20 个主要目录(Yelp、BBB、Facebook、YellowPages 等)。返回一致性评分和各目录的详细信息。50 积分。

注意: NAP 比较需要提供全部三个字段(名称、地址、电话)。

关键词研究

适用场景: 用户需要关键词创意、搜索量或竞争对手关键词数据。

需求端点积分备注
商家的关键词创意keyword_opportunities4最佳起点
根据种子关键词获取建议keyword_suggestions2—
特定关键词的搜索量search_volume1改用 keyword_suggestions(包含搜索量)
相关关键词related_keywords2—
某个域名的排名关键词keywords_for_site3改用 keyword_suggestions
随时间变化的关键词趋势keyword_trends1—

从 keyword_opportunities 开始——它会根据商家类别和位置查找关键词,并显示难度、当前排名和搜索量。这是制定策略的最佳起点。

当用户有特定的种子关键词并希望获取不同变体时,使用 keyword_suggestions。

竞争对手分析

适用场景: 用户想要了解竞争格局。

使用: competitor_gap

business_name: "Ace Plumbing"
location: "Buffalo, NY"
keyword: "plumber"
competitors: 5

返回与竞争对手相比的排名差距、评论数量差异和评分优势。10 积分。

广告情报: competitor_ads 可显示竞争对手域名的 Google Ads 广告系列。2 积分。

反向链接差距: backlink_gap 可将你的域名与最多 5 个竞争对手进行比较,以寻找链接机会。10 积分。

AI 可见度

适用场景: 用户询问 AI 搜索可见度、AI Overviews、ChatGPT 提及或 GEO。

需求端点积分
Google 是否显示 AI Overview?ai_overview1
Google AI Mode 会说什么?ai_mode2
AI 在哪里提及此关键词?ai_mentions5
AI 模型引用了哪些网站?ai_top_sources5
AI 模型引用了哪些页面?ai_top_pages5
某个域名在 AI 中的可见度如何?ai_visibility10
关键词级别的 AI 数据ai_keyword_data1
提示词的原始 LLM 响应ai_llm_response8
从 AI 搜索结果中提取数据ai_scraper3

先使用 ai_overview 检查该关键词是否有 AIO,然后使用 ai_visibility 对多个关键词进行域名级评分。

ai_llm_response 可让你直接向 LLM 发送提示词并查看响应。适用于检查 ChatGPT/Gemini 对某个商家的评价。

prompt: "Best plumber in Buffalo NY"
platform: "chat_gpt"    # Options: chat_gpt, claude, gemini, perplexity

ai_keyword_data 返回关键词的 AI 专属指标(使用 keywords 数组,而非单数形式)。

keywords: ["plumber buffalo", "emergency plumber buffalo ny"]
location: "Buffalo, New York"

ai_compare 可比较不同域名的 AI 可见度。需要提供 domains(包含 2–5 个域名的数组)和 keywords(包含 1–10 个关键词的数组)。对于规模较小的商家,返回的数据可能较少。

SERP 数据

适用场景: 用户想查看 Google 针对某项搜索显示的内容。

需求端点积分
完整 SERP(自然搜索结果 + 本地结果 + 广告 + PAA + AIO)organic_serp1
仅本地结果包local_pack1
Google 地图结果maps1
本地查找器结果local_finder1
本地服务广告local_services_ads1

organic_serp 最完整,可通过一次调用返回页面上的所有内容。

页面审计

适用场景: 用户想检查特定 URL 是否存在 SEO 问题。

使用: page_audit

url: "https://aceplumbing.com/services/drain-cleaning"

检查 50 多项因素:标题、元数据、标题层级、图片、Core Web Vitals、Schema、移动设备友好性。4 个积分。

若要抓取整个网站的多个页面,请改用 Screaming Frog。

本地权威分数

适用场景: 用户想要一个代表本地搜索权威度的单一分数。

使用: local_authority

business_name: "Ace Plumbing"
location: "Buffalo, NY"
keyword: "plumber"

返回 0-100 分,并提供各项指标的细分(排名、评价、资料完整度、引文)和百分位排名。10 个积分。

非常适合用于客户报告和跟踪长期改进情况。


积分费用参考

所有费用均于 2026 年 4 月 10 日根据源代码(credits.ts)核实。

端点积分
ping0
location_search0(GET)
local_pack1
organic_serp1
local_services_ads1
local_finder1
maps1
ai_overview1
keyword_trends1
qa / business_qa1
search_volume每 50 个关键词 1 个(请使用 keyword_suggestions)
ai_keyword_data每 50 个关键词 1 个
google_reviews每 10 条评价 1 个
business_profile2
profile_health2
ai_mode2
keyword_suggestions2
related_keywords2
competitor_ads2
ai_scraper3
keywords_for_site3(请使用 keyword_suggestions)
brand_mentions3
page_audit4
keyword_opportunities4
backlink_summary5(反向链接请使用 Ahrefs)
ai_mentions5
ai_top_sources5
ai_top_pages5
multi_platform_reviews6
review_velocity6
ai_llm_response8
ai_compare10
ai_visibility10
backlink_gap10
business_listings每 50 条结果 10 个
competitor_gap10
local_authority10
reputation_audit30
citation_audit50
local_audit50
geogrid_scan(5x5)50
geogrid_scan(7x7)98
geogrid_scan(9x9)162

端点说明

端点说明
search_volume可通过 REST API 使用。keyword_suggestions 也会返回搜索量数据,可作为替代方案
keywords_for_site可通过 REST API 使用
backlink_summaryREST 路径为 /v1/backlinks/summary(而非 /v1/links/backlink-summary)
ai_compare需要 keywords(数组),而非 keyword(字符串)。对于小型企业,返回的数据可能较少
business/reviews可用,也可使用别名 google_reviews
citation_auditREST 路径为 /v1/audit/citation(也可使用 /v1/audit/citation-consistency),而非 /v1/citations/consistency
local_audit使用异步任务处理(提交 + 轮询)。MCP 工具会自动处理轮询

REST API 与 MCP: 对于商家资料端点(business_profile、profile_health),建议使用 REST API。MCP 可能会向这些端点添加无效的 keyword 参数。复合端点(local_audit、review_velocity、citation_audit、reputation_audit)既可通过 REST,也可通过 MCP 使用。


组合端点以支持常见工作流

新客户入驻
  1. local_audit — 全面概况(50 个积分)
  2. business_profile — GBP 详情(2 个积分,建议使用 REST API)
  3. citation_audit — NAP 一致性(50 个积分)
  4. review_velocity — 评价健康状况(6 个积分)
  5. keyword_opportunities — 关键词策略(4 个积分)
  6. competitor_gap — 竞争格局(10 个积分) 总计:完成一次全面的新客户评估需要 122 个积分。
月度报告数据拉取
  1. local_pack 用于目标关键词 — 排名检查(每次 1 个积分)
  2. review_velocity — 每月评价趋势(6 个积分)
  3. local_authority — 权威度评分跟踪(10 个积分)
  4. ai_overview 用于目标关键词 — AI 可见度检查(每次 1 个积分)
快速排名检查
  1. local_pack — 查看哪些商家进入了本地 3 强(1 个积分) 完成。
潜在客户开发 / 销售调研
  1. business_profile — 获取其 GBP 数据(2 个积分,建议使用 REST API)
  2. profile_health — 查找可用于推介的差距(2 个积分,建议使用 REST API)
  3. google_reviews — 评价情况(1 个积分) 总计:5 个积分即可准备好推介内容。

评论

支持 Markdown