claude-seo 本地 SEO 审计实战指南：GBP 信号、NAP 一致性、本地 Schema 与多门店质量检测

【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-seo

本文基于 claude-seo 仓库中的 seo-local 审计 Agent 文档，结合 seo-local Skill、local-schema-types 参考、local-seo-signals 参考、GBP 完整性清单 以及 render_page.py 等源码实现，系统讲解如何用 25% GBP 信号 + 20% 评价 + 20% 本地页内优化等六维评分模型，对实体门店（brick-and-mortar）、服务区域商家（SAB）和多门店站点完成一次可量化的本地 SEO 深度审计。

一、这篇文章讲什么

本地 SEO（Local SEO）与通用 SEO 最大的区别在于：排名信号高度依赖 Google Business Profile（GBP）、NAP（Name/Address/Phone）一致性、评价健康度、本地引用（citation）与行业专属 schema。claude-seo 将这套方法论固化为一个名为seo-local的审计 Agent：给它一个 URL，它会按 8 步检测管线抓取页面、识别业务类型与行业垂直、交叉比对 NAP、校验 LocalBusiness schema、评估 GBP 信号与评价健康度、检查 Tier 1 目录引用，最终输出 0–100 分的六维评分报告与 Top 10 优先行动清单。

读完本文，你将掌握：该 Agent 的完整审计流程与评分权重、业务类型与行业垂直的判别信号、2026 年本地排名关键因素（Whitespark/Sterling Sky 等研究的可操作结论）、按行业选择正确 schema 子类型的方法，以及底层 render_page.py 在 SPA 站点上的渲染策略与 SSRF 防护机制。

二、Agent 定位与职责边界

seo-local在仓库中同时存在两个形态：

• Agent 定义：agents/seo-local.md，模型指定为sonnet，最大 20 轮（maxTurns: 20），可用工具为Read, Bash, WebFetch, Glob, Grep, Write；
• Skill 定义：skills/seo-local/SKILL.md，版本2.2.0，user-invocable: true，触发词覆盖 "local SEO"、"Google Business Profile"、"GBP"、"map pack"、"local pack"、"citations"、"NAP consistency"、"local rankings"、"service area"、"multi-location" 等。

职责边界很清晰：它负责"页面端（on-page）+ 可观测信号"的审计，而 GBP 平台端（maps PLATFORM）的档案完整性评分由 maps-gbp-checklist.md 承担——后者通过 DataForSEO My Business Info API 打分，两者互补而非重叠。此外，Agent 明确要求"Do not duplicate seo-geo analysis"，本地相关 AI 搜索可见性分析应交给seo-geo子 Agent，避免职责混叠。

三、八步检测管线

给定一个 URL 后，Agent 按以下顺序执行审计：

1. 抓取页面并检测业务类型（实体门店 / SAB / 混合），依据地址可见性、服务区域措辞与 Maps 嵌入；
2. 检测行业垂直（餐饮、医疗、法律、家装、地产、汽车），依据页面内容信号；
3. 提取 NAP：分别从可见 HTML、JSON-LD schema、meta 标签三处提取 Name/Address/Phone，标记来源间任何不一致；
4. 校验 LocalBusiness schema：行业子类型是否正确、必填属性（name、address）与推荐属性（geo 5 位小数精度、openingHoursSpecification、telephone、url）是否齐全；
5. 检查页面上的 GBP 信号：Maps 嵌入、地点引用、评价组件、帖子指示、照片证据；
6. 评估评价健康度：基于可见数据（评分、数量、schema 中 aggregateRating、回复模式）；
7. 检查 Tier 1 目录引用（Yelp、BBB），通过site:搜索模式或直接抓取；
8. 评估多门店站点落地页质量：内容唯一率、doorway 页替换测试（swap test）、内链深度。

从源码结构看，第 1 步的抓取统一走 scripts/render_page.py（v2.0.0 起所有子 Agent 共用），而不是直接requests.get——因为本地页面上最常见的 Maps 嵌入、GBP 组件、评价轮播都是客户端注入，原始 HTML 会漏掉关键信号（详见第六节）。

四、业务类型识别：先定审计边界

业务类型决定后续哪些检查适用，必须在分析前完成。判别信号如下：

一个关键的实操提醒（来自 local-schema-types.md）：SAB 的 GBP 服务区域当前并不直接影响排名——排名基于验证地址（Sterling Sky, 2025 年 3 月），但areaServed属性仍被 Schema.org 支持、行业推荐使用，建议用命名城市并配sameAs链接到 Wikipedia/Wikidata。

五、行业垂直识别：路由到行业专属检查

Agent 从页面信号与 GBP 类别模式识别行业，进而路由到 local-schema-types.md 中的行业专属检查。若无法识别，则走通用LocalBusiness分析路径。

行业识别之所以重要，是因为本地 schema 子类型直接影响富结果资格与 AI 实体理解。最典型的错误模式：

• 法律行业用已被 Schema.org 弃用的Attorney→ 应改用LegalService+Person；
• 汽车经销商用 2025 年 6 月 12 日移除富结果支持的VehicleListing→ 应改用Car+Offer；
• 医疗只用通用MedicalBusiness→ 应按场景改用MedicalClinic/Hospital/Dentist（三者均可参与富结果）。

六、Local SEO Score：六维加权评分体系

Agent 输出一个 0–100 的本地 SEO 分数，按六个维度加权：

每个维度在 seo-local Skill 中都有明确的打分指引（Full / Partial / Low 三档），例如：

• GBP 信号维度：Full = GBP 嵌入存在、类别信号一致、有帖子与照片；Low = 网站上无任何可见 GBP 集成。
• 评价维度：Full = 10+ 条评价、4.5+ 星、近期活跃、有业主回复、多平台存在；Low = <10 条评价、无近期活动、无回复、仅单一平台。
• 本地页内维度：Full = 标题与 H1 含城市+服务关键词、NAP 可见、有独立服务页、无 doorway 模式、内链良好；Low = 标题/H1 通用化、NAP 不可见、落地页内容稀薄。

评分背后的行业依据（详见 local-seo-signals.md）：

• GBP 主类别是本地包排名第一因素（Whitespark 2026，得分 193）；主类别错误是头号负向因素（得分 176）——这是单点最严重的错误；
• 评价速度 18 天规则（Sterling Sky）：连续 3 周无新评价，排名"断崖式"下滑——速度比总量更重要；
• 专属服务页是本地有机排名第一因素、AI 可见性第二因素；
• AI 可见性前 5 大因素中有 3 个与引用相关（Whitespark 2026）；
• 距离因素解释 55.2% 的排名方差（Search Atlas ML 研究，XGBoost 模型解释 92–93% 方差）——不在站点可控范围内，报告需注明该限制。

七、行业专属检查与 Schema 模式

Agent 明确要求加载skills/seo/references/local-schema-types.md以获取：

• 每个垂直的正确 schema 子类型；
• 行业专属引用源推荐；
• Schema 模式模板。

7.1 必填与推荐属性

依据 Google Developers 文档（2025-12-10 更新）：

必填：name（必须与 GBP 完全一致）、address（PostalAddress，含 streetAddress / addressLocality / addressRegion / postalCode）。

推荐：geo（至少 5 位小数，约 1.1m 精度）、openingHoursSpecification（标准/深夜/24h/季节性）、telephone（必须与 GBP 及页面 NAP 一致）、url（该地点的 canonical URL）、aggregateRating（含 reviewCount）、priceRange（100 字符内）、image、review、department（如汽车经销商嵌套部门）、餐饮专属的menu与servesCuisine。

SAB 专属：areaServed（Place/GeoShape），不在 Google 官方推荐列表但受 Schema.org 支持，行业推荐 SAB 使用。

7.2 各垂直 Schema 模式速查

医疗行业有硬性合规约束：HIPAA 禁止在评价回复中确认或否认评论者是患者（2023 年 Manasa Health Center 案例罚款 3 万美元）；法律行业评价回复需考虑 attorney-client privilege。

7.3 多门店 Schema 模式

多门店站点采用"首页 Organization + 各落地页独立 LocalBusiness"的模式：首页Organization提供品牌级@id，每个门店页用LocalBusiness子类型 + 唯一@id+branchOf指向品牌@id。落地页推荐使用子目录结构domain.com/locations/city-name/——子目录比子域更能聚合链接权益（Bruce Clay 研究显示 50%+ 流量提升）。

八、2026 关键排名因素与算法环境

Agent 内置了 Whitespark 2026 本地搜索排名因素的结论，审计报告会引用这些基准：

• 本地包因子组：GBP 信号 32%（稳定居首）、评价信号约 20%（较 2023 年 ~16% 上升）、页内信号 15–19%（略降）、链接信号持续多年下滑、行为/互动信号上升（点击、电话、路线请求）、AI 搜索信号首次入榜；
• Top 15 单因素：主类别 > GBP 标题关键词 > 与搜索点距离 > 已认证 GBP > 搜索时营业中（Sterling Sky 受控实验）> 高分 Google 评分 > 原生 Google 评价数量 > 附加类别 > 评价新近度/速度 > 专属服务页 > 域名权威 > NAP 一致性 > 垃圾列表移除 > 高质量反向链接 > 评价情感；
• 评价基准：Magic 10 阈值（10 条评价处存在显著排名提升，9→10 明显、10→11 无同等提升）；BrightLocal LCRS 2026 显示 74% 消费者只关心近 3 个月评价、41% 每次都读评价、31% 只用 4.5+ 星；
• 合规红线：评价门控（review gating）被 Google（fake engagement policy）与 FTC 双重禁止，FTC Consumer Review Rule（2024-10-21 生效）单次违规罚金最高 $53,088；2024 年 Google 拦截/移除 2.4 亿+ 违规评价；
• GBP 功能状态：Q&A 板块 2025-12-03 弃用（由 Ask Maps / Gemini AI 接替，历史内容无导出，建议把 Q&A 内容重建为站内 FAQ）；GBP Messaging 与呼叫历史追踪已移除；Google Verified 徽章 2025-10 取代 Guaranteed/Screened；
• 影响本地的算法更新：2025-03 Core（强调 E-E-A-T、惩罚薄内容/AI 内容）、2025-08 Spam（打击关键词堆砌、假评价、PBN，本地包常保持稳定）、2025-12 Core（强化 E-E-A-T 与行为信号权重）、2026-02 Discover Core（偏好本地专业内容）；另有"Diversity Update"（2025）使同时排名地图包与有机结果更困难。

这些数据都带证据等级标注（Confirmed / Study / Consensus / Caution），审计报告中引用时应沿用该区分，避免把行业研究当作 Google 官方声明。

九、DataForSEO 集成（可选）

当环境中有 DataForSEO MCP 工具时，Agent 可以升级审计能力：

• local_business_data：获取实时 GBP 数据（档案字段、评价、照片等）；
• google_local_pack_serp：获取本地包实时排名位置；
• business_listings：跨目录自动化引用审计（见 seo-dataforseo Skill）。

值得一提的是 maps-gbp-checklist.md 提供了 GBP 平台端评分卡：25 个字段（8 个关键字段 16 分 + 8 个重要字段 16 分 + 9 个补充字段 18 分，共 50 分，归一化到 0–100），并按行业施加权重乘数（餐饮的 Menu 链接 x2、家装的服务区域 x2、地产的照片 x2 等）。得分解读：90–100 优秀、75–89 良好、50–74 需要补缺、25–49 差、0–24 危急（基本未认领）。表中还给出了 DataForSEO My Business Info API 到清单字段的映射（如category→ 主类别、additional_categories→ 附加类别、work_hours→ 营业时间），并诚实标注"已验证状态"无法从 API 直接获取、需人工核查。

十、页面抓取：render_page.py 的三种模式与 SSRF 防护

这是 v2.0.0 起所有审计 Agent 的统一抓取入口，命令为：

python3 scripts/render_page.py <URL> --mode auto --json

三种模式：

JSON 输出字段（与 render_page.py 源码中render_page()返回结构一致）：

• raw_content：JS 执行前的服务端响应 HTML；
• content：JS 执行后的 DOM HTML；
• is_spa：是否检测到 hydration 壳；
• extracted_text：经 trafilatura 去样板化的正文；
• publication_date：htmldate 检测的 ISO 8601 发布日期；
• 另有status_code、headers、redirect_chain、console_errors、render_engine、render_ms、mode_used等字段。

SPA 检测启发式（源码 render_page.py 的_SPA_SHELL_PATTERNS与_is_spa）覆盖 React（<div id="root">、<div id="__next">）、Vue/Nuxt（<div id="__nuxt">）、Svelte（data-svelte-h=）、Astro islands（<astro-island）以及 "please enable javascript" 等签名；还包含一个保守的<body>内容长度阈值（100 字符），兼顾避免误判导致多余渲染。

安全机制：所有脚本必须通过 scripts/url_safety.py 校验用户提供的 URL——validate_url_strict()在发起连接前用socket.getaddrinfo解析并固定公网 IP，safe_requests_get()在 DNS pinning 上下文内完成请求，防止 DNS rebinding 把公网 IP 换成内网 IP；Playwright 渲染时再挂route()处理器拦截每个子资源请求并中止解析到非公网 IP 的请求（纵深防御）。禁止对用户提供的 URL 直接调用requests.get。

对本地审计的实际意义：Maps 嵌入、GBP 组件、评价轮播普遍是客户端注入。在 JS 重站点上做本地审计时，应优先--mode always，让审计结果反映用户（以及 Google 爬虫）在渲染后真正看到的内容；若用--mode auto遇到 SPA 壳也会自动升级渲染，但明确指定 always 可避免因壳检测偏差漏检。

十一、审计持久化与报告输出

如果编排器（audit orchestrator）提供了output_dir，Agent 写入：

• output_dir/findings/local.md：GBP、NAP、评价、本地 schema、引用、门店落地页发现；
• 结构化 JSON 兼容的 findings，归入audit-data.json的 Local SEO 类别。

最终报告（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 目录状态，如site:yelp.com "Business Name"、site:bbb.org "Business Name"）；
8. 本地 schema 状态（存在/缺失/格式错误 + 可直接使用的修复方案）；
9. 门店落地页质量（多门店场景：内容唯一率、doorway 风险、store locator）；
10. Top 10 优先行动（按 Critical > High > Medium > Low 排序）；
11. 限制声明：明确列出免费手段无法评估的项目（geo-grid 排名、域名权威、完整反向链接、GBP Insights 数据、实时本地包位置）及可用付费工具补齐的路径。

十二、错误处理与质量门禁

seo-local Skill 定义了五类异常场景的处理策略：

十三、可落地的优化路线图

综合 seo-local Skill 的 Quick Wins / Medium Effort / High Impact 分层建议：

Quick Wins（低投入）

1. 认领并优化 Apple Business Connect（BrightLocal 2026：使用率翻倍至 27%，1B+ iPhone 用户）；
2. 认领并优化 Bing Places（2025-10 改版，为 ChatGPT、Copilot、Alexa 供数，9 亿次/日查询）；
3. 修复页面、schema 与 GBP 之间的任何 NAP 不一致；
4. 添加正确行业子类型的 LocalBusiness schema；
5. 添加 5+ 位小数精度的geo坐标；
6. 电话使用tel:链接实现点击拨打；
7. 标题标签与 H1 加入"城市 + 服务"关键词。

Medium Effort

1. 为每个核心服务建立专属页面（Whitespark：#1 本地有机因素）；
2. 建立维持 18 天最小节奏的评价获取策略；
3. 提交三大数据聚合器（Data Axle、Foursquare、Neustar/TransUnion）以触达下游分发；
4. 认领行业专属目录（按垂直推荐清单）；
5. 添加行业专属 schema 模式（餐饮 Menu、医疗 Physician 等）；
6. 为服务页/门店页实现 hub-and-spoke 内链架构（关键页距离首页 3 次点击内，每千字 2–5 条描述性锚文本内链）。

High Impact

1. 本地数字公关瞄准 "best of" 榜单（#1 AI 可见性因素）；
2. 为每个门店落地页开发不可互换的独特内容（唯一率 >60%，通过 swap test——若把城市名换掉内容依然成立，就是 doorway 页风险；参考案例：某 HVAC 公司因此模式在 2024-03 Core Update 后损失 80% 排名与 63% 流量）；
3. 在 ChatGPT 引用源（Yelp、TripAdvisor、BBB、Reddit）建立存在感；
4. 争取商会（Chamber of Commerce）与 BBB 会员（权威 + 验证信号）；
5. 产出社区参与内容（赞助、本地活动、合作）。

AI 搜索补充提示：本地场景下 ChatGPT 并不直接访问 GBP，而是从 Bing 网页索引、Yelp、TripAdvisor、BBB、Reddit 取数；AI Overviews 出现在高达 68% 的本地搜索中。需要完整的 AI 可见性分析（可引用性评分、llms.txt 检查、品牌提及审计）时，Agent 推荐运行seo-geo子 Agent；面向提示词驱动的本地优化，可走 FLOW 框架的/seo flow local <url>（FLOW Skill 内置 11 个本地阶段提示词，覆盖 GBP 优化、meta 描述、标题标签与结构化审计流程，提示词文件位于 prompts/local 目录）。

十四、证据与延伸阅读

本文关键结论均可回溯到仓库内文件：

• 审计流程与评分权重：agents/seo-local.md；
• 六维打分细则、错误处理、优化路线图：skills/seo-local/SKILL.md；
• 行业 schema 子类型、必填/推荐属性、多门店模式、行业引用源：skills/seo/references/local-schema-types.md；
• 排名因素研究、评价基准、引用分层、GBP 功能状态、算法更新：skills/seo/references/local-seo-signals.md；
• GBP 档案完整性评分卡与 DataForSEO 字段映射：skills/seo/references/maps-gbp-checklist.md；
• 页面渲染实现（SPA 检测、三模式、trafilatura/htmldate）：scripts/render_page.py；
• SSRF/DNS rebinding 防护 API：validate_url_strict、safe_requests_get、make_safe_playwright_route_handler，见 scripts/url_safety.py；
• 免费数据源与置信度加权（引用审计扩展）：skills/seo/references/free-backlink-sources.md。

注意事项：文中行业研究结论（Whitespark 2026、Sterling Sky、BrightLocal LCRS 2026、Search Atlas ML 等）属于第三方研究数据而非 Google 官方承诺，实施优先级时应结合自身行业与竞争环境验证；schema 从未被证实为直接排名因素（John Mueller / Gary Illyes 确认），其价值在于富结果资格、实体理解与 AI 搜索解析——审计中应如实传达这一边界，避免过度承诺。

【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-seo