claude-seo 项目内置的seo-local技能（定义于 skills/seo-local/SKILL.md，配套 agents/seo-local.md 本地 SEO 子代理）是一套可交给 Claude Code 直接执行的本地搜索优化审计方案。它围绕 Google Business Profile（GBP）信号、NAP 一致性、引文健康度、评论信号、本地 Schema 标记、位置页质量、多地点 SEO 与行业垂直化建议展开六维加权评分，并内置了 2026 年本地搜索与 AI 搜索的最新研究基准。读完本文，你将掌握：如何让 Agent 自动识别业务类型与行业垂直、如何按六个维度（GBP 25% / 评论 20% / 页面 20% / NAP 与引文 15% / Schema 10% / 链接与权威 10%）输出可执行的本地 SEO 审计报告，以及如何结合仓库内的渲染脚本、GBP 弃用特性扫描器与 FLOW 本地提示词库把审计落地为实战动作。

一、技能定位与触发方式

seo-local是 claude-seo 仓库中 25 个细分技能之一，元数据声明于 skills/seo-local/SKILL.md 的 YAML front-matter（版本 2.2.0，分类seo，作者 AgriciDaniel，MIT 许可）。它通过如下自然语言短语触发：local SEO、Google Business Profile、GBP、map pack、local pack、citations、NAP consistency、local rankings、service area、multi-location、local search，并接受[url]作为参数提示。

在 agents/seo-local.md 中，该能力被封装为独立的本地 SEO 专家子代理：model: sonnet，maxTurns: 20，允许Read, Bash, WebFetch, Glob, Grep, Write六类工具。子代理的职责链与 SKILL.md 完全对应：

1. 抓取页面并检测业务类型（brick-and-mortar / SAB / hybrid）；
2. 从页面内容信号检测行业垂直（餐饮、医疗、法律、家居服务、房地产、汽车）；
3. 从可见 HTML、JSON-LD Schema 与 meta 标签三处提取 NAP，标记任何不一致；
4. 校验 LocalBusiness Schema 的行业子类型与必填/推荐属性；
5. 检查页面上的 GBP 信号（Maps 嵌入、地点引用、评论挂件、帖子与照片证据）；
6. 评估评论健康度（评分、数量、schema 中的 aggregateRating、回复模式）；
7. 检查 Tier 1 目录（Yelp、BBB）上的引文存在性；
8. 对多地点站点评估位置页质量（唯一内容占比、doorway 页面交换测试、内链深度）。

简单说：seo-local技能定义了"分析什么、按什么标准打分"，子代理则定义了"用什么工具、按什么顺序执行"。

二、业务类型检测：决定适用检查项的"前置于分析"步骤

SKILL.md 明确要求：在正式分析之前，先依据页面信号判定业务类型，因为它决定了后续哪些检查项适用。三类业务类型的判定信号如下：

对检查项的影响：SAB 跳过嵌入式地图验证与物理地址一致性检查；实体门店执行完整的 NAP + 地图检查；混合型两者都做。

这一点在 agents/seo-local.md 中同样位列第一执行步骤，并且有一个值得注意的工程细节：SAB 类型的判定直接关系到 Schema 标记的写法——SAB 应使用areaServed而非填写街道地址（详见第四节 Schema 部分）。

三、行业垂直检测：路由到行业专属检查

在判定业务类型之后，技能会从页面信号与 GBP 类别模式推断行业垂直，并据此路由到 skills/seo/references/local-schema-types.md 中对应的行业专属检查项：

如果未检测到任何垂直，则走通用的LocalBusiness分析路径。垂直检测的意义在于：不同行业的本地 Schema 子类型、引文来源与评论回复合规约束差异极大（例如医疗行业的 HIPAA 限制、法律行业的律师-客户特权），通用分析会漏掉这些关键差异。

四、六大分析维度：权重、检查清单与评分标准

这是 SKILL.md 的核心骨架。六个维度合计 100 分，各维度权重如下：GBP 信号 25%、评论与声誉 20%、本地页面 SEO 20%、NAP 一致性与引文 15%、本地 Schema 标记 10%、本地链接与权威信号 10%（与 agents/seo-local.md 中的维度权重表完全一致）。

1. GBP 信号（25%）

GBP 信号是本地包（local pack）权重占比最高的信号组（Whitespark 2026 显示其占本地包权重的 32%）。其中，主类别（primary category）是本地包排名最重要的单一因素（Whitespark 因子评分 193，排名第一），而主类别选错则是排名第一的负向因素（评分 176，是最严重的单一失误）。

检查清单：

• 页面上是否可检测到 GBP 嵌入或引用（Maps iframe、place ID、评论挂件）；
• 主类别是否恰当（将页面内容与可见的 GBP 数据对照推断）；
• 次类别证据（BrightLocal 建议最优为 4 个附加类别）；
• GBP 帖子是否存在（WebFX 实证显示无直接排名影响，但会触发 Post Justifications）；
• 照片/视频证据（Agency Jet 数据显示带照片可提升 45% 的路线请求量）；
• Q&A 内容：已于 2025 年 12 月弃用，由 Ask Maps Gemini AI 取代——建议将原 Q&A 内容重建为网站上的 FAQ 区块（GBP 已删除既有 Q&A 且无导出途径）；
• Google Verified 徽章资格（2025 年 10 月取代 Guaranteed/Screened）；
• GBP 链接 URL 策略：不要链接到网站最强的页面（Sterling Sky Diversity Update——有抑制自然排名的风险）；
• 营业时间在页面上的可见性（搜索时营业中的商家排名更高，位列第 5 大因子）。

评分标准：Full = 有 GBP 嵌入、类别信号对齐、帖子活跃、有照片；Partial = 部分 GBP 信号存在但不完整；Low = 网站上无可见 GBP 集成。

2. 评论与声誉（20%）

核心结论是评论增速（velocity）比总数更重要。Sterling Sky 的"18 天规则"（18-day rule）：如果连续 3 周没有新评论，排名会断崖式下跌。

检查清单：

• 页面上或 Schema 中可见的 Google 评论总数（Sterling Sky 的"魔法阈值 10"：10 条评论处存在显著排名跃升）；
• 星级（BrightLocal 2026：31% 的消费者只用 4.5 星以上商家，68% 只用 4 星以上）；
• 评论时效性指标（74% 的消费者只关心最近 3 个月的评论）；
• Schema 中的aggregateRating（ratingValue、reviewCount、bestRating）；
• 第三方评论平台存在性（BrightLocal 2026：消费者平均参考 6 个评论网站）；
• 商家回复模式（BrightLocal：88% 的消费者会使用有回复的商家）；
• 评论门控（review gating）检测：在将用户引导到评论平台之前预先筛选满意度是被禁止的——违反 Google 虚假互动政策与 FTC 消费者评论规则（每条违规最高罚款 $53,088）。

行业专属约束：

• 医疗：HIPAA 禁止在回复中确认/否认评论者是否为患者；
• 法律：评论回复中需考虑律师-客户特权。

评分标准：Full = 10+ 评论、4.5+ 星级、近期有活跃、有商家回复、多平台存在；Partial = 有评论但在时效性、评分或回复率上有缺口；Low = 少于 10 条评论、无近期活动、无回复、仅单一平台。

补充证据：仓库 skills/seo/references/local-seo-signals.md 提供了更细的基准——2024 年 Google 屏蔽/删除了 2.4 亿+ 条违规评论（同比 +40%）；2025 年 1-7 月评论删除率上升 600%+，其中 38% 被删的是五星评论；Search Atlas ML 研究（XGBoost 回归，解释 92-93% 方差）显示评论数量解释了 19.2% 的排名方差，仅次于邻近度（55.2%）。

3. 本地页面 SEO（20%）

独立服务页面（dedicated service pages）是本地自然排名的第一大因素，同时是 AI 可见度的第二大因素（Whitespark 2026）。

检查清单：

• 标题标签包含城市/服务关键词；
• H1 带本地意图（城市 + 服务）；
• NAP 在页面 HTML 中可见（页脚、联系区块、页眉）；
• 每个核心服务一个独立页面；
• 多地点站点的位置页质量：
  • 唯一内容占比至少 60-70%（行业共识，无 Google 官方确认阈值）；
  • Swap 测试（RicketyRoo 方法）：如果只替换城市名后内容依然成立，这就是 doorway 页面——文档记录了一个 HVAC 公司因该模式在 2024 年 3 月核心更新后损失 80% 排名与 63% 流量的案例；
  • 本地照片、区域专属推荐语、本地 FAQ；
• 嵌入式 Google 地图（强化地理信号而非直接排名因子——建议懒加载以缓解速度影响）；
• 首屏内的点击呼叫按钮（tel:链接）与联系表单；
• 内链架构：hub-and-spoke，每个关键页面距离首页 3 次点击以内；
• 每 1,000 字 2-5 个带描述性锚文本的上下文内链。

多地点专属：

• 店铺定位器使用可独立爬取的 URL（SSR/SSG 优先于 CSR）；
• 子目录结构：domain.com/locations/city-name/（Bruce Clay 研究显示子目录比子域名更能聚合链接权益，流量提升 50%+）；
• 每个位置页有带唯一@id的 LocalBusiness Schema。

评分标准：Full = 标题+H1 含城市、NAP 可见、有独立服务页、无 doorway 模式、内链良好；Partial = 部分本地信号存在但缺服务页或有 doorway 风险；Low = 通用标题/H1、NAP 不可见、位置页内容单薄。

4. NAP 一致性与引文（15%）

值得注意的趋势：传统本地包排名中引文（citations）的作用在下降，但AI 可见度前 5 大因子中有 3 个与引文相关（Whitespark 2026）。同时 Google 2025 年 7 月的文档更新已从"突出度"定义中移除了"目录"（directories）。

检查清单：

• NAP 提取并三源比对——Name、Address、Phone 分别取自：① 页面可见 HTML（页脚、联系页）；② LocalBusiness JSON-LD Schema；③ 任何可见的 GBP 数据；三个来源之间的任何不一致都要标记；
• Tier 1 目录引文存在性（通过 WebFetch 或 site: 搜索模式）：
  • 页面上的 Google Business Profile 信号；
  • Yelp：site:yelp.com "Business Name"；
  • BBB：site:bbb.org "Business Name"；
  • Facebook 商家主页引用；
• Apple Business Connect 意识（BrightLocal 2026：使用率翻倍至 27%——建议认领）；
• Bing Places 意识（驱动 ChatGPT、Copilot、Alexa——建议认领并优化）；
• 行业专属目录推荐（按垂直加载 skills/seo/references/local-schema-types.md）；
• 数据聚合器意识：Data Axle、Foursquare、Neustar/TransUnion（建议提交以向下游分发）。

评分标准：Full = 页面/Schema 间 NAP 一致、检测到 Tier 1 引文、行业目录齐全；Partial = NAP 存在但不一致、部分引文缺失；Low = NAP 不一致、无可见引文、无 Schema 地址。

skills/seo/references/local-seo-signals.md 补充了完整的引文层级：Tier 1（全行业通用）包括 Google Business Profile、Apple Business Connect（使用率从 14% 升至 27%，覆盖 10 亿+ iPhone 用户）、Bing Places（2025 年 10 月重构，日处理 9 亿查询）、Facebook、Yelp；Tier 2 包括 BBB、YellowPages、Manta、Superpages、Foursquare、Nextdoor；Tier 3 数据聚合器包括 Data Axle（原 Infogroup，合作 Google/Bing/Apple）、Foursquare（与 Factual 合并，驱动 Uber、Nextdoor、Yahoo、ChatGPT，覆盖 5 亿+ 设备）、Neustar/TransUnion Digital（80+ 平台合作）。

5. 本地 Schema 标记（10%）

SKILL.md 首先明确一个事实边界：Schema 不是直接排名因子（John Mueller 确认），但它能开启富结果（Webstix 案例研究显示 CTR 提升 43%），并帮助 AI 系统解析商家信息。

检查清单：

• LocalBusiness Schema 存在性（提取 JSON-LD 块）；
• 必填属性：name、address（含 PostalAddress 子属性）；
• 推荐属性：geo（至少 5 位小数，经确认）、openingHoursSpecification、telephone、url、priceRange（少于 100 字符）、image、aggregateRating；
• 行业正确子类型（加载 skills/seo/references/local-schema-types.md）：
  • 餐饮用Restaurant而非通用LocalBusiness；
  • 法律用LegalService而非已弃用的Attorney；
  • 汽车经销商用AutoDealer而非已弃用的VehicleListing；
  • 医疗用MedicalClinic/Hospital/Dentist而非通用MedicalBusiness；
• SAB 专属：areaServed使用具名城市（推荐做法，不在 Google 官方清单中但受 Schema.org 支持）；
• 多地点：每个位置页有自己的 LocalBusiness 且@id唯一，并通过branchOf链接到首页的 Organization；
• 行业专属 Schema 模式：
  • 餐饮：Menu + MenuSection + MenuItem + ReserveAction；
  • 医疗：Physician (Person) + MedicalSpecialty + sameAs 到 NPI；
  • 法律：LegalService + Person + Service（执业领域）；
  • 家居服务：子类型 + areaServed + Service；
  • 房地产：RealEstateAgent + Person + RealEstateListing；
  • 汽车：AutoDealer + Car + Offer（按部门拆分 Schema）。

评分标准：Full = 子类型正确、推荐属性齐全、行业专属模式完整、JSON-LD 有效；Partial = 有 LocalBusiness 但类型通用或缺少推荐属性；Low = 无本地 Schema，或 Schema 有错误/占位内容。

skills/seo/references/local-schema-types.md 提供了可直接落地的多地点 Schema JSON 模板——首页Organization（含@id），每个位置页独立LocalBusiness（如Dentist）通过branchOf回链，geo坐标示例为 5 位小数（"40.71234", "-74.00567"，约 1.1 米精度）。该文件还整理了弃用清单：Attorney（Schema.org 弃用，改用LegalService+Person）、VehicleListing（2025 年 6 月 12 日富结果移除，改用Car+Offer）、HowTo（2023 年 9 月富结果移除）、SpecialAnnouncement（2025 年 7 月 31 日弃用）。

6. 本地链接与权威信号（10%）

链接对本地包排名的权重在下降，但仍占本地自然排名的约 26%（Whitespark 2026，第二大因子组）。而"Best of"榜单位置是AI 可见度的第一大引文因子。

检查清单：

• 页面可检测的本地外链指标：
  • 商会（Chamber of Commerce）提及或链接（高 Trust Flow，GlueUp 数据显示消费者访问量提升约 80%）；
  • BBB 认证/徽章（Google 使用 BBB 进行商家验证）；
  • 本地新闻/媒体报道；
  • 社区参与信号（赞助、本地活动、合作）；
• "Best of" 榜单存在性（Whitespark 2026：AI 可见度第一因子）；
• 数字公关信号（BuzzStream 2026：66.2% 的公关从业者已将 AI 引文追踪设为 KPI）；
• 品牌提及与 AI 可见度的相关性是传统外链的 3 倍以上（Ahrefs：相关系数 0.664 vs 0.218）；
• 链接增速基准：小企业每月 5-10 个高质量本地链接（行业共识）。

评分标准：Full = 本地权威信号可见（商会、BBB、媒体报道）、社区参与明显；Partial = 部分权威信号但本地链接指标有限；Low = 无可检测的本地权威信号。

五、AI 搜索对本地 SEO 的影响：不可跳过的专属小节

SKILL.md 特别强调：不要重复 seo-geo 的分析，本节只提供本地专属的 AI 上下文，并建议对完整 AI 可见度分析运行/seo geo <url>。

关键本地 AI 事实（均来自 SKILL.md 与其引用的 2026 年研究）：

• AI Overviews 出现在最多 68% 的本地搜索中（Whitespark 2025 Q2）；
• ChatGPT 转化率 15.9% vs Google 自然搜索 1.76%（Seer Interactive）；
• AI 可见度前 5 大因子中有 3 个与引文相关（Whitespark 2026）；
• ChatGPT 并不直接访问 GBP——其信息来源是 Bing 索引、Yelp、TripAdvisor、BBB、Reddit；
• Bing Places 至关重要：驱动 ChatGPT、Copilot、Alexa；
• AI 驱动的本地包（美国移动端）只展示 1-2 个商家，展示数量减少 32%（Sterling Sky）。

local-seo-signals.md进一步补充：ChatGPT/AI 用于本地推荐的用户比例从 6% 飙升至 45%（BrightLocal LCRS 2026）；Perplexity 以权威性优先，从高权威站点多取 40% 内容，平均每次回答引用 21.87 个来源；移动端本地意图搜索的零点击率高达 78%。

行动建议：运行/seo geo <url>获取完整的 AI 搜索可见性分析，包括可引性评分、llms.txt 检查与品牌提及审计。同时务必在 ChatGPT 所引用的平台（Yelp、TripAdvisor、BBB、Reddit）上建立存在感。

六、参考文件：按需加载的知识库

SKILL.md 定义了两个按需加载的参考文件（在写作本文时已完整阅读并引用如上）：

• skills/seo/references/local-seo-signals.md：排名因子、评论基准、引文层级、GBP 功能状态、算法更新（含 2025-2026 年的 March 2025 Core、June 2025 Core、August 2025 Spam、December 2025 Core、February 2026 Discover Core、Sterling Sky "Diversity Update"），以及语音搜索数据（58% 的语音搜索与本地商家信息相关）。
• skills/seo/references/local-schema-types.md：按行业的 LocalBusiness 子类型、Schema 模式、每垂直的引文来源（如医疗的 Healthgrades/Zocdoc/NPI Registry、法律的 FindLaw/Martindale-Hubbell/Avvo、房地产的 Zillow/Homes.com 等）。

七、输出规范：LOCAL-SEO-ANALYSIS-{domain}.md

技能要求生成LOCAL-SEO-ANALYSIS-{domain}.md报告，必须包含以下 11 个部分：

1. Local SEO Score: XX/100，含各维度分解表；
2. 业务类型：Brick-and-mortar / SAB / Hybrid；
3. 检测到的行业垂直+ 行业专属发现；
4. GBP 优化清单（检测到的信号 vs 缺失项）；
5. 评论健康快照（评分、数量、增速指标、回复模式）；
6. NAP 一致性审计（页面 vs Schema 不一致项、跨来源比对）；
7. 引文存在性检查（Tier 1 目录状态）；
8. 本地 Schema 状态（存在/缺失/格式错误 + 可直接使用的修复方案）；
9. 位置页质量（多地点时：唯一内容占比、doorway 风险、店铺定位器）；
10. Top 10 优先行动（Critical > High > Medium > Low）；
11. 局限性免责声明：本次分析无法评估的项（geo-grid 排名、Domain Authority、全面外链、GBP Insights 数据、实时本地包排名位置）以及可用哪些付费工具补齐。

在审计编排器提供output_dir时，子代理还会将结果持久化为output_dir/findings/local.md，并以 JSON 兼容结构写入audit-data.json的 Local SEO 类别（见 agents/seo-local.md）。

八、执行层面：渲染、安全与弃用特性扫描

抓取与渲染：用 render_page.py 而非裸请求

agents/seo-local.md 明确要求本地审计通过python3 scripts/render_page.py <URL> --mode auto --json获取页面 HTML。该脚本（scripts/render_page.py）是 claude-seo v2.0.0 引入的共享无头渲染子系统，构建于 Playwright Chromium 之上，并用 trafilatura 做样板剥离、htmldate 做发布日期检测：

• auto模式：先做原始抓取，仅当检测到 SPA 外壳时才启动 Playwright（默认，最省成本的正确行为）；
• always模式：即使静态 HTML 也强制渲染；
• never模式：仅原始 HTML（等价于旧版 fetch_page.py）。

JSON 输出暴露raw_content（JS 执行前）、content（JS 执行后）、is_spa、extracted_text（经 trafilatura 去样板后的正文）、publication_date。为什么这对本地审计重要：地图嵌入、GBP 挂件、评论轮播通常由客户端注入，对 JS 密集站点应优先--mode always，使审计反映用户（以及 Google 爬虫）渲染后实际看到的内容。

安全边界：SSRF 与 DNS rebinding 防护位于 scripts/url_safety.py——永远不要对用户提供的 URL 直接调用requests.get。render_page.py 在交给 Playwright 前通过validate_url_strict校验 URL，并在 Chromium 内用route()处理器拦截所有解析到非公网 IP 的子资源请求，构成纵深防御。

GBP 弃用特性扫描：gbp_deprecation_lint.py

本地审计的另一项工程化配套是 scripts/gbp_deprecation_lint.py，它扫描 HTML 中三类已弃用的 GBP 引用，输出结构化发现：

用法示例：python scripts/gbp_deprecation_lint.py https://example.com（或--file page.html、--json）。无弃用模式时退出码为 0，否则为 1。对应测试位于 tests/test_gbp_lint_and_polish.py，覆盖干净页面返回ok、识别 GBP chat CTA、识别 business.site URL 等场景——这些测试同时是理解扫描器行为的可执行文档。

九、优先级路线图：Quick Wins → Medium → High Impact

SKILL.md 将优化动作按投入产出分为三档：

Quick Wins（快速见效）

1. 认领并优化 Apple Business Connect（使用率已翻倍至 27%）；
2. 认领并优化 Bing Places（驱动 ChatGPT、Copilot、Alexa）；
3. 修复页面、Schema、GBP 三者之间的任何 NAP 不一致；
4. 添加正确行业子类型的 LocalBusiness Schema；
5. 添加 5 位以上小数精度的geo坐标；
6. 确保电话号码使用tel:点击呼叫链接；
7. 在标题标签和 H1 中加入城市 + 服务关键词。

Medium Effort（中等投入）

1. 为每个核心服务创建独立页面（Whitespark：本地自然排名第一因子）；
2. 建立保持 18 天最小节奏的评论生成策略；
3. 提交到三家数据聚合器（Data Axle、Foursquare、Neustar/TransUnion）以实现下游分发；
4. 认领行业专属目录列表（按垂直推荐）；
5. 添加行业专属 Schema 模式（餐饮用 Menu、医疗用 Physician 等）；
6. 为服务/位置页实现 hub-and-spoke 内链架构。

High Impact（高影响）

1. 构建瞄准"best of"榜单的本地数字公关策略（AI 可见度第一因子）；
2. 为每个位置页开发独特的、不可交换的内容（唯一内容 >60%）；
3. 在 ChatGPT 信息来源平台（Yelp、TripAdvisor、BBB、Reddit）建立存在感；
4. 争取商会与 BBB 会员资格（权威 + 验证信号）；
5. 创作社区参与内容（赞助、本地活动、合作）。

十、可选集成与错误处理

DataForSEO 集成（可选）

若 DataForSEO MCP 工具可用，SKILL.md 建议使用local_business_data提取实时 GBP 数据、google_local_pack_serp获取实时本地包排名、business_listings跨目录自动化引文审计。这正好补上第七节"局限性免责声明"中提及的实时数据缺口。DataForSEO 扩展的安装与配置见 extensions/dataforseo/docs/DATAFORSEO-SETUP.md。

错误处理矩阵

FLOW Framework 集成

对提示词驱动的本地优化，可运行/seo flow local <url>。FLOW 的本地阶段提示词库位于 skills/seo-flow/references/prompts/local/，共 11 个提示词，覆盖 GBP 优化、meta 描述、标题标签与结构化本地审计工作流。代表性提示词包括：

• gbp-categories-prompt.md：以 FLOW 模型产出可执行的本地交付物，强制区分观察、假设、推荐行动与待验证声明，并明确"不得编造统计数据"；
• gbp-services-prompt.md：围绕搜索者意图、现有证据、信任/提取/转化障碍、优先级变更、测量事件与评论节奏构建本地服务交付物；
• prompt-generating-a-title-tag.md 与 prompt-generating-a-meta-description.md：生成包含城市 + 服务的标题标签与 meta 描述。

十一、使用前提与限制

最后需要明确本技能的适用前提与边界（据仓库实际内容）：

• 适用对象：面向实体门店、服务区域业务（SAB）与多地点商家的本地 SEO 审计；输入为 URL。
• 数据来源：技能的分析结论基于页面抓取、Schema 提取与公开行业研究（Whitespark、BrightLocal、Sterling Sky、Seer Interactive 等 2025-2026 年研究），并非来自 GBP 后台的真实运营数据；实时本地包排名、GBP Insights、完整外链画像需要配合 DataForSEO 等付费工具。
• 执行环境：本地审计依赖 scripts/render_page.py（Playwright + trafilatura + htmldate）与 scripts/url_safety.py 的安全校验；对 JS 密集页面建议--mode always保证审计所见即用户所见。
• 合规红线：评论门控同时违反 Google 政策与 FTC 规则；医疗、法律行业在评论回复与 Schema 表述上有 HIPAA、律师-客户特权等特殊约束，审计报告需按行业路由到对应检查项。