local-falcon-tool

Local Falcon 工具

注意： LocalSEOData（localseodata-tool）现已提供 geogrid_scan 端点，可执行一次性排名扫描。快速审计和单次扫描请使用 LocalSEOData。Local Falcon 对趋势报告、定期活动、Falcon Guard 监控以及 AI 平台扫描（GAIO/ChatGPT/Gemini/Grok）仍然不可或缺。

你可以通过 MCP 直接访问 Local Falcon。本技能将说明何时使用各项操作，以及如何处理结果。

何时使用 Local Falcon 或其他工具

需求	使用 Local Falcon	改用
查看某个地理区域内的排名	✅ 地理网格扫描	—
查看某个特定地点的排名	✅ 可以，但有些大材小用	使用 SerpAPI 快速抽查
查看某个区域内竞争对手的排名	✅ 自动生成竞争对手报告	—
追踪排名趋势	✅ 趋势报告	—
监控 GBP 变更	✅ Falcon Guard	—
分析评价情感	✅ 评价分析	—
查询关键词搜索量	❌	Semrush、Ahrefs、DataForSEO
查询反向链接数据	❌	Ahrefs、Semrush
查询网站流量数据	❌	Google Analytics
执行网站技术审计	❌	Screaming Frog

运行任何扫描前

务必先检查现有报告。 扫描会消耗额度。请勿重复劳动。

Step 1: listAllLocalFalconLocations → Find the place ID
Step 2: listLocalFalconScanReports (filter by placeId + keyword) → Check if a recent scan exists
Step 3: Only run a NEW scan if no recent report exists or the user explicitly wants fresh data

核心工作流

运行新的排名扫描

适用情况： 用户想了解某家企业在某个地理区域内针对某个关键词的排名。

1. 查找企业： listAllLocalFalconLocations — 按名称或地址搜索
   • 如果未找到：searchForLocalFalconBusinessLocation → saveLocalFalconBusinessLocationToAccount
2. 与用户确认扫描参数：
   • 关键词（客户会搜索的词）
   • 网格大小（见下方网格表）
   • 半径（见下方半径表）
   • 平台：google、apple、gaio、chatgpt、gemini、grok、aimode
   • AI 分析：是/否（仅限 Google，建议开启）
3. 运行： runLocalFalconScan — 立即返回“submitted”
4. 轮询： listLocalFalconScanReports（按 placeId 筛选）— 每 30 秒检查一次
5. 获取： 使用字段掩码调用 getLocalFalconReport 进行分析
6. 解读： 使用 geogrid-analysis 技能诊断结果

建议用于分析的字段掩码： report_key,date,place_id,keyword,location,arp,atrp,solv,found_in,total_competitors,grid_size,radius,measurement,ai_analysis,image,heatmap

检查现有报告

适用情况： 用户询问当前或近期的排名，或你需要基准数据。

1. 使用筛选条件（placeId、keyword、日期范围）调用 listLocalFalconScanReports
2. 使用字段掩码：report_key,date,keyword,location.name,arp,atrp,solv,grid_size,platform
3. 如果同一关键词有多份报告：调用 getLocalFalconTrendReport 查看趋势

追踪排名趋势

适用情况： 用户想了解排名是在提升还是下降。

1. 调用 listLocalFalconTrendReports（按 placeId 和 keyword 筛选）
2. 调用 getLocalFalconTrendReport — 返回每个扫描日期的历史 ARP、ATRP、SoLV
3. 比较不同日期的指标，并与优化操作关联分析

关键提示： 只有在至少 2 次扫描的设置完全相同（相同的 placeId、关键词、网格大小、半径和坐标）时，才会生成趋势报告。如果扫描设置不同，则不会生成趋势报告。

运行活动（定期扫描）

适用情况： 用户想要自动定期扫描。

1. 调用 listLocalFalconCampaignReports — 先检查现有活动
2. 调用 createLocalFalconCampaign — 设置关键词、地点、频率和网格大小
3. 活动将按计划自动运行
4. 调用 getLocalFalconCampaignReport — 获取汇总结果

活动与单次扫描的区别： 活动会将数据汇总到一份报告中。单次扫描则会分别生成趋势、地点和关键词报告。持续监控请使用活动，单次分析请使用单次扫描。

竞争分析

适用场景： 用户想知道哪些竞争对手表现胜过自己。

1. 每次扫描都会自动生成竞争对手报告
2. getLocalFalconCompetitorReports — 列出可用报告
3. getLocalFalconCompetitorReport — 查看排名靠前的竞争对手及其 ARP、ATRP、SoLV、评论和评分
4. 使用 fieldmask：date,keyword,grid_size,radius,businesses.*.name,businesses.*.place_id,businesses.*.arp,businesses.*.atrp,businesses.*.solv,businesses.*.reviews,businesses.*.rating

监控 GBP 变更（Falcon Guard）

适用场景： 用户想保护自己的 GBP，防止未经授权的编辑。

1. listLocalFalconGuardReports — 查看当前监控的内容
2. addLocationsToFalconGuard — 将地点添加到监控中
3. getLocalFalconGuardReport — 查看变更历史和指标（针对通过 OAuth 连接的地点，包括电话、点击和路线查询）

评论分析

适用场景： 用户想获取 AI 驱动的评论洞察。

1. listLocalFalconReviewsAnalysisReports — 查看现有分析
2. getLocalFalconReviewsAnalysisReport — 查看完整的情感分析、主题和竞争对手对比

网格尺寸选择

业务类型	网格尺寸	半径	依据
咖啡店、美容院、餐厅	5×5 或 7×7	1-3 英里	顾客通常步行或驾车短距离前来
牙医、脊椎按摩师、单地点医疗机构	7×7 或 9×9	3-7 英里	覆盖全市范围
暖通空调、管道工、电工	9×9 或 11×11	7-15 英里	服务范围广
医院系统、连锁加盟店	13×13 或 15×15	10-20 英里	覆盖区域范围
乡村地区的企业	7×7 或 9×9	15-30 英里	覆盖范围大但分布稀疏

经验法则： 网格尺寸应覆盖实际服务范围。网格太小 = 结果看起来好得不真实；网格太大 = 结果看起来差得不真实。

积分注意事项

• 执行扫描前务必检查积分：viewLocalFalconAccountInformation
• 网格越大，消耗的积分越多
• Campaign 的消耗会按地点 × 关键词 × 频率叠加
• 每次扫描都会产生 AI 分析费用
• 如果已有结果，切勿重新运行扫描

下一步操作

获取的内容	下一步操作	技能
包含 ARP/ATRP/SoLV 的扫描结果	解读数据并诊断问题	geogrid-analysis
竞争对手报告数据	分析竞争对手采取了哪些不同做法	local-competitor-analysis
显示排名下降的趋势	使用决策树诊断原因	geogrid-analysis 诊断树
Guard 检测到 GBP 变更	检查并撤销未经授权的编辑	gbp-optimization
评论分析结果	根据洞察制定评论策略	review-management

默认下一步： 切勿直接向用户返回原始扫描数据。务必先通过 geogrid-analysis 进行解读。