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 深度审计。一、这篇文章讲什么本地 SEOLocal SEO与通用 SEO 最大的区别在于排名信号高度依赖 Google Business ProfileGBP、NAPName/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, WriteSkill 定义skills/seo-local/SKILL.md版本2.2.0user-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 按以下顺序执行审计抓取页面并检测业务类型实体门店 / SAB / 混合依据地址可见性、服务区域措辞与 Maps 嵌入检测行业垂直餐饮、医疗、法律、家装、地产、汽车依据页面内容信号提取 NAP分别从可见 HTML、JSON-LD schema、meta 标签三处提取 Name/Address/Phone标记来源间任何不一致校验 LocalBusiness schema行业子类型是否正确、必填属性name、address与推荐属性geo 5 位小数精度、openingHoursSpecification、telephone、url是否齐全检查页面上的 GBP 信号Maps 嵌入、地点引用、评价组件、帖子指示、照片证据评估评价健康度基于可见数据评分、数量、schema 中 aggregateRating、回复模式检查 Tier 1 目录引用Yelp、BBB通过site:搜索模式或直接抓取评估多门店站点落地页质量内容唯一率、doorway 页替换测试swap test、内链深度。从源码结构看第 1 步的抓取统一走 scripts/render_page.pyv2.0.0 起所有子 Agent 共用而不是直接requests.get——因为本地页面上最常见的 Maps 嵌入、GBP 组件、评价轮播都是客户端注入原始 HTML 会漏掉关键信号详见第六节。四、业务类型识别先定审计边界业务类型决定后续哪些检查适用必须在分析前完成。判别信号如下类型判别信号审计影响Brick-and-mortar实体门店页面/页脚可见街道地址、Google Maps 嵌入带 pin/导航、Visit us at / Located at / Come see us、schema 中有结构化地址完整 NAP 地图检查SAB服务区域商家无可见物理地址、出现 serving [city/region]、service area includes、We come to you、On-site service、schema 中只有areaServed而无address.streetAddress跳过嵌入地图验证与物理地址一致性检查Hybrid混合地址与服务区域语言同时存在如 Visit our showroom 加上 We also serve [areas]两套检查都执行一个关键的实操提醒来自 local-schema-types.mdSAB 的 GBP 服务区域当前并不直接影响排名——排名基于验证地址Sterling Sky, 2025 年 3 月但areaServed属性仍被 Schema.org 支持、行业推荐使用建议用命名城市并配sameAs链接到 Wikipedia/Wikidata。五、行业垂直识别路由到行业专属检查Agent 从页面信号与 GBP 类别模式识别行业进而路由到 local-schema-types.md 中的行业专属检查。若无法识别则走通用LocalBusiness分析路径。垂直检测信号餐饮 Restaurant/menu、菜单项、预订、菜系类型、外卖/堂食、食物订购医疗 Healthcare接受保险、患者、预约、NPI、医疗术语、Dr.、HIPAA 声明法律 Legalattorney、lawyer、执业领域、bar admission、案件结果、free consultation家装 Home Services服务区域、紧急服务、免费估价、licensed/insured/bonded、24/7地产 Real Estate房源、MLS、在售/出租物业、经纪简介、brokerage、open house汽车 Automotive库存、VIN、试驾、经销商、售后部门、new/used/certified行业识别之所以重要是因为本地 schema 子类型直接影响富结果资格与 AI 实体理解。最典型的错误模式法律行业用已被 Schema.org 弃用的Attorney→ 应改用LegalServicePerson汽车经销商用 2025 年 6 月 12 日移除富结果支持的VehicleListing→ 应改用CarOffer医疗只用通用MedicalBusiness→ 应按场景改用MedicalClinic/Hospital/Dentist三者均可参与富结果。六、Local SEO Score六维加权评分体系Agent 输出一个 0–100 的本地 SEO 分数按六个维度加权维度权重GBP 信号GBP Signals25%评价与声誉Reviews Reputation20%本地页内优化Local On-Page SEO20%NAP 一致性与引用NAP Consistency Citations15%本地 Schema 标记Local Schema Markup10%本地链接与权威信号Local Link Authority Signals10%每个维度在 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.mdGBP 主类别是本地包排名第一因素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 完全一致、addressPostalAddress含 streetAddress / addressLocality / addressRegion / postalCode。推荐geo至少 5 位小数约 1.1m 精度、openingHoursSpecification标准/深夜/24h/季节性、telephone必须与 GBP 及页面 NAP 一致、url该地点的 canonical URL、aggregateRating含 reviewCount、priceRange100 字符内、image、review、department如汽车经销商嵌套部门、餐饮专属的menu与servesCuisine。SAB 专属areaServedPlace/GeoShape不在 Google 官方推荐列表但受 Schema.org 支持行业推荐 SAB 使用。7.2 各垂直 Schema 模式速查垂直正确子类型关键模式餐饮Restaurant/CafeOrCoffeeShop/BarOrPub等Menu MenuSection MenuItemReserveActionOrderActionservesCuisine医疗MedicalClinic/Hospital/Dentist/PhysicianPhysician 页用PersonmedicalSpecialtyhospitalAffiliationhasCredentialsameAs链接 NPI 注册表法律LegalService非弃用的Attorney律师简介用PersonjobTitle/worksFor/alumniOf/hasCredential每个执业领域一个Service家装Plumber/Electrician/HVACBusiness等子类型 areaServed命名城市 sameAshasOfferCatalog地产RealEstateAgent经纪与公司通用Schema.org 不存在RealEstateBrokerage经纪人页PersonmemberOf房源用RealEstateListingOfferEventopen house汽车AutoDealer销售/AutoRepair售后/AutoPartsStore配件CarVIN、里程、fuelType、变速箱Offer价格、货币、可用性独立 GBP 分部医疗行业有硬性合规约束HIPAA 禁止在评价回复中确认或否认评论者是患者2023 年 Manasa Health Center 案例罚款 3 万美元法律行业评价回复需考虑 attorney-client privilege。7.3 多门店 Schema 模式多门店站点采用首页 Organization 各落地页独立 LocalBusiness的模式首页Organization提供品牌级id每个门店页用LocalBusiness子类型 唯一idbranchOf指向品牌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被 Googlefake engagement policy与 FTC 双重禁止FTC Consumer Review Rule2024-10-21 生效单次违规罚金最高 $53,0882024 年 Google 拦截/移除 2.4 亿 违规评价GBP 功能状态QA 板块 2025-12-03 弃用由 Ask Maps / Gemini AI 接替历史内容无导出建议把 QA 内容重建为站内 FAQGBP 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 Update2025使同时排名地图包与有机结果更困难。这些数据都带证据等级标注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三种模式模式行为适用场景auto先原始抓取仅当检测到 SPA 壳时才启动 Playwright 渲染默认性价比最高always强制 Playwright 渲染JS 重站点审计本地页时优先使用never纯原始 HTML等价旧版 fetch_page.py不需要 JS 的静态分析JSON 输出字段与 render_page.py 源码中render_page()返回结构一致raw_contentJS 执行前的服务端响应 HTMLcontentJS 执行后的 DOM HTMLis_spa是否检测到 hydration 壳extracted_text经 trafilatura 去样板化的正文publication_datehtmldate 检测的 ISO 8601 发布日期另有status_code、headers、redirect_chain、console_errors、render_engine、render_ms、mode_used等字段。SPA 检测启发式源码 render_page.py 的_SPA_SHELL_PATTERNS与_is_spa覆盖 Reactdiv idroot、div id__next、Vue/Nuxtdiv id__nuxt、Sveltedata-svelte-h、Astro islandsastro-island以及 please enable javascript 等签名还包含一个保守的body内容长度阈值100 字符兼顾避免误判导致多余渲染。安全机制所有脚本必须通过 scripts/url_safety.py 校验用户提供的 URL——validate_url_strict()在发起连接前用socket.getaddrinfo解析并固定公网 IPsafe_requests_get()在 DNS pinning 上下文内完成请求防止 DNS rebinding 把公网 IP 换成内网 IPPlaywright 渲染时再挂route()处理器拦截每个子资源请求并中止解析到非公网 IP 的请求纵深防御。禁止对用户提供的 URL 直接调用requests.get。对本地审计的实际意义Maps 嵌入、GBP 组件、评价轮播普遍是客户端注入。在 JS 重站点上做本地审计时应优先--mode always让审计结果反映用户以及 Google 爬虫在渲染后真正看到的内容若用--mode auto遇到 SPA 壳也会自动升级渲染但明确指定 always 可避免因壳检测偏差漏检。十一、审计持久化与报告输出如果编排器audit orchestrator提供了output_dirAgent 写入output_dir/findings/local.mdGBP、NAP、评价、本地 schema、引用、门店落地页发现结构化 JSON 兼容的 findings归入audit-data.json的 Local SEO 类别。最终报告LOCAL-SEO-ANALYSIS-{domain}.md必须包含 11 个部分Local SEO Score: XX/100 六维分解表业务类型Brick-and-mortar / SAB / Hybrid检测到的行业垂直 行业专属发现GBP 优化清单已检测信号 vs 缺失评价健康快照评分、数量、速度指标、回复模式NAP 一致性审计页面 vs schema 差异、跨来源对比表引用存在性检查Tier 1 目录状态如site:yelp.com Business Name、site:bbb.org Business Name本地 schema 状态存在/缺失/格式错误 可直接使用的修复方案门店落地页质量多门店场景内容唯一率、doorway 风险、store locatorTop 10 优先行动按 Critical High Medium Low 排序限制声明明确列出免费手段无法评估的项目geo-grid 排名、域名权威、完整反向链接、GBP Insights 数据、实时本地包位置及可用付费工具补齐的路径。十二、错误处理与质量门禁seo-local Skill 定义了五类异常场景的处理策略场景动作URL 不可达DNS 失败、连接拒绝明确报告错误不猜测站点内容建议用户核实 URL 后重试页面无本地信号报告未发现本地商家指标建议确认这是否为本地业务并提供 GBP 列表 URL页面 HTML 中找不到 NAP检查 schema 与 meta 标签仍缺失则标记 Critical建议在页脚与联系页添加可见 NAP行业垂直不明确呈现得分最高的两个垂直及支撑信号请用户确认后再应用行业专属建议多门店 50 落地页应用 seo 编排器质量门禁30 页 WARNING强制 60% 唯一内容50 页 HARD STOP需用户论证后继续十三、可落地的优化路线图综合 seo-local Skill 的 Quick Wins / Medium Effort / High Impact 分层建议Quick Wins低投入认领并优化 Apple Business ConnectBrightLocal 2026使用率翻倍至 27%1B iPhone 用户认领并优化 Bing Places2025-10 改版为 ChatGPT、Copilot、Alexa 供数9 亿次/日查询修复页面、schema 与 GBP 之间的任何 NAP 不一致添加正确行业子类型的 LocalBusiness schema添加 5 位小数精度的geo坐标电话使用tel:链接实现点击拨打标题标签与 H1 加入城市 服务关键词。Medium Effort为每个核心服务建立专属页面Whitespark#1 本地有机因素建立维持 18 天最小节奏的评价获取策略提交三大数据聚合器Data Axle、Foursquare、Neustar/TransUnion以触达下游分发认领行业专属目录按垂直推荐清单添加行业专属 schema 模式餐饮 Menu、医疗 Physician 等为服务页/门店页实现 hub-and-spoke 内链架构关键页距离首页 3 次点击内每千字 2–5 条描述性锚文本内链。High Impact本地数字公关瞄准 best of 榜单#1 AI 可见性因素为每个门店落地页开发不可互换的独特内容唯一率 60%通过 swap test——若把城市名换掉内容依然成立就是 doorway 页风险参考案例某 HVAC 公司因此模式在 2024-03 Core Update 后损失 80% 排名与 63% 流量在 ChatGPT 引用源Yelp、TripAdvisor、BBB、Reddit建立存在感争取商会Chamber of Commerce与 BBB 会员权威 验证信号产出社区参与内容赞助、本地活动、合作。AI 搜索补充提示本地场景下 ChatGPT 并不直接访问 GBP而是从 Bing 网页索引、Yelp、TripAdvisor、BBB、Reddit 取数AI Overviews 出现在高达 68% 的本地搜索中。需要完整的 AI 可见性分析可引用性评分、llms.txt 检查、品牌提及审计时Agent 推荐运行seo-geo子 Agent面向提示词驱动的本地优化可走 FLOW 框架的/seo flow local urlFLOW 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.mdGBP 档案完整性评分卡与 DataForSEO 字段映射skills/seo/references/maps-gbp-checklist.md页面渲染实现SPA 检测、三模式、trafilatura/htmldatescripts/render_page.pySSRF/DNS rebinding 防护 APIvalidate_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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考