whitespark-tool

Whitespark 工具

**注意：**Local SEO Data（localseodata-tool）现在通过 citation_audit 执行引文审计。请默认使用 Local SEO Data 获取引文数据。对于引文建设、排名跟踪和评价生成活动（Reputation Builder），Whitespark 仍是首选工具。

Whitespark 没有 MCP 服务。它的两款产品现在提供 REST API——Local Rank Tracker 和 Local Ranking Grids（geogrids），两者目前都处于 Beta 阶段——因此 Agent 可以直接获取这两款产品的排名和网格数据。它的引文产品没有 API，仍通过控制面板或托管服务提供；因此，对于引文，Agent 的职责是指导用户在 Whitespark 中采取哪些操作，并解读用户提供的数据。请参阅下文的 Whitespark API 部分。

何时使用 Whitespark 而非其他工具

需求	使用 Whitespark	改用
引文差距分析（竞争对手与您）	✅ Local Citation Finder	BrightLocal（也支持此功能，且有 MCP）
托管式引文建设（全程代办）	✅ 服务质量最佳	BrightLocal（也提供此服务）
评价生成活动（电子邮件/SMS）	✅ Reputation Builder	—
评价监控	✅	BrightLocal（有 MCP，可能更适合 Agent 直接访问）
本地排名跟踪	✅	Local SEO Data、Local Falcon（其 geogrid 对本地搜索更具优势）
引文准确性审计	⚠️ 可以执行	BrightLocal（NAP 准确性评分更好）
关键词研究	❌	Local SEO Data、Semrush、Ahrefs
反向链接分析	❌	Local SEO Data、Ahrefs
技术审计	❌	Screaming Frog
地理网格排名	✅	Local SEO Data、Local Falcon

Whitespark 与 BrightLocal 对比

这两者的功能重叠很多。以下是选择时机的参考：

功能	Whitespark	BrightLocal
引文建设质量	✅ 质量更高（人工审核）	不错，但自动化程度更高
引文差距查找	✅ 更全面	✅ 同样不错
NAP 准确性评分	基础	✅ 评分系统更好
是否提供 MCP 服务	❌ 否	✅ 是
评价生成	✅ Reputation Builder	✅ 也提供此功能
白标报告	基础	✅ 报告功能更好
行业声誉	✅ 引文专家	✅ 一体化本地 SEO
定价	按服务收费	订阅制

**建议：**如果 MCP 连接能力很重要（Agent 可以直接获取数据），请使用 BrightLocal。如果优先考虑引文建设质量，且用户愿意使用控制面板，那么 Whitespark 的托管服务非常出色。

核心工作流

引文差距分析

**适用场景：**用户想找出竞争对手已收录、但自己尚未收录的目录。

在 Whitespark 中的操作：

1. 使用 Local Citation Finder 查询目标企业及 2–3 家竞争对手
2. 比较所有企业的引文来源
3. 找出收录竞争对手、但未收录用户的目录

Agent 可以做什么：

• 指导用户选择要查询的竞争对手
• 解读用户分享的引文差距报告
• 排定优先目标目录的顺序

引文优先级框架：

1. 第 1 级（必备）：Google、Apple、Bing、Yelp、Facebook、数据聚合商
2. 第 2 级（重要）：行业专属目录（Healthgrades、Avvo、Angi 等）
3. 第 3 级（有益）：本地目录、商会、BBB
4. 第 4 级（优先级低）：综合网络目录、小众网站

托管式引文建设

**适用场景：**已发现引文差距，且用户希望获得建设方面的帮助。

Whitespark 提供的服务：

• 人工向目录提交信息（质量高于自动化工具）
• 验证商家信息是否已上线且准确
• 提供持续维护选项

告知用户以下事项：

1. 提供准确的 NAP 信息（必须与 GBP 一致）
2. 提供企业描述、类别和照片
3. 指定差距分析中发现的目标目录
4. 大多数目录的处理时间为 2–4 周
5. 6–8 周后重新审计，确认所有信息均已上线且准确

评论生成（口碑提升）

适用场景： 用户需要系统地增加 Google 评论。

口碑提升的工作方式：

• 导入客户名单（邮箱或电话号码）
• 通过电子邮件或短信自动发送评论邀请
• 引导满意的客户前往 Google 评论页面
• 跟踪哪些客户收到了邀请、哪些客户留下了评论

Agent 应提供的指导：

1. 时机：服务完成后 1-3 天发送评论邀请
2. 内容：保持简短、亲切，并附上 Google 评论页面的直接链接
3. 数量：稳定持续地发送（每周 5-10 条）优于一次性发送 50 条
4. 筛选：不要向已知的不满意客户发送邀请（避免收到负面评论）
5. 合规：不要以奖励诱导评论，也不要设置门槛（根据评分筛选评论）

不同业务类型的评论增速目标：

业务类型	每月评论目标	原因
餐厅	15-30	交易量大
医疗机构	8-15	患者数量适中
家庭服务	5-10	交易频率较低
法律服务	3-5	客户较少，且较难提出请求
B2B 服务	2-4	数量少，但价值高

本地排名跟踪

适用场景： 用户使用 Whitespark 的排名跟踪工具。

Whitespark 的排名跟踪工具按点位跟踪（单个位置），而不是使用地理网格。

Agent 应了解的内容：

• 它显示某个关键词在一个点位的排名，而非地理覆盖范围
• 对本地商家而言，Local Falcon 地理网格更实用
• 除了地理网格，本地排名跟踪也适合用于跟踪自然搜索关键词

Whitespark API

Whitespark 的两款产品提供 REST API。两者目前均为测试版——端点和响应结构可能会发生变化——且都不是 MCP 服务，因此调用需直接进行或通过自定义集成完成，而非通过 Agent 连接器。没有引用 API；引用创建和审核仍需在控制面板或托管服务中完成。

对于引用数据，默认使用 LocalSEOData (citation_audit)。若要获取超出地理网格 API 所提供范围的地理网格详情，可使用 LocalSEOData (geogrid_scan) 或 Local Falcon。

Local Ranking Grids（地理网格）API

参考文档：https://lrg.whitespark.ca/api-docs

此 API 专为报告集成打造，可提取网格摘要并将网格图片嵌入报告或控制面板。它不提供底层网格数据点。

身份验证： 在 Authorization 标头中使用 Bearer 令牌。在应用内通过个人资料下拉菜单 → API Access 生成令牌。

端点：

• GET /grids — 分页列出你的排名网格及摘要指标：可见度得分、平均排名和评论得分。使用 page（默认值为 1）和 per_page（默认值为 50，最大值为 100）进行分页。响应包含 data 和 meta 对象（current_page、last_page、per_page、total）。
• GET /grid/{grid_id}/download-screenshot/{mode} — 返回网格最近的截图；mode 可设为 with-metrics 或 without-metrics。grid_id 是网格 URL 中的 UUID。若不存在截图，则返回 404。可通过 <img> 嵌入。在 API access 页面启用 Automatic screenshots，以便每次扫描完成后刷新此 URL。

API 不提供的功能（仅限控制面板）： 网格中的单个数据点、竞争对手的数据点、创建网格，以及修改网格或扫描计划。

适用场景： 嵌入始终保持最新的地理网格图片，并在月度报告或业务组合汇总中提取可见度得分／平均排名／评论得分。如需逐点排名或竞争对手网格，请使用 geogrid_scan（LocalSEOData）或 Local Falcon。

Local Rank Tracker API

参考：https://whitespark-api.apidocumentation.com/rank-tracker-api-reference

Beta（v1.0.0，OpenAPI 3.0.0），提供独立的线上和测试基础 URL。**身份验证：**通过请求头传递 API key。

分为三组资源：

• campaigns — 列出并读取排名跟踪活动（活动是存放某个商家的跟踪关键词和位置的容器）
• campaign — 操作单个活动
• rankings — 获取跟踪关键词的排名结果

底层跟踪器覆盖 Google 和 Bing 的 Local Pack、Maps 和自然搜索结果，支持桌面端和移动端，最多跟踪 100 个排名位置，并提供地理定位和加权 Visibility Score。请在上方的 API 参考中确认具体路径、参数和响应架构——Beta 文档是权威来源，其中的“Download OpenAPI Document”链接提供完整架构。关于 Beta 的问题请发送邮件至 [email protected]。

**适用场景：**将自然搜索和 Local Pack 关键词排名及 Visibility Score 自动导入定期报告，并与地理网格数据一同呈现。**以下情况不适用：**地理覆盖范围比单点排名更重要时——这类需求应使用网格 API 和 geogrid_scan。

后续操作

发现的问题	后续操作	技能
发现引文缺口	补充缺失的引文，从 Tier 1 开始	local-citations
已创建引文，等待数据传播	等待期间进行其他优化（4-8 周）	gbp-optimization、review-management
正在开展评价生成活动	监控增长速度；如果响应率较低，则调整沟通内容	review-management
需要在报告中加入引文数据	纳入审计或月度报告	client-deliverables、local-reporting
需要可通过 MCP 访问的引文数据	改用 BrightLocal	brightlocal-tool
需要在报告中加入网格图示或汇总指标	通过 Local Ranking Grids API 获取	local-reporting、client-deliverables
需要在报告中加入关键词排名或 Visibility Score	通过 Local Rank Tracker API 获取	local-reporting

**默认后续步骤：**Whitespark 的优势在于托管引文服务。如果需要自动化、可供 Agent 访问的引文数据，请使用 BrightLocal。如果需要高质量的引文建设，请使用 Whitespark 的托管服务。