☰
claude-seo 本地 SEO 审计完全指南:GBP 信号、NAP 一致性、本地 Schema 与 AI 搜索时代排名实战
2026/10/26 1:23:31 网站建设 项目流程

【免费下载链接】claude-seo

Universal 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技能(定义于 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 明确要求:在正式分析之前,先依据页面信号判定业务类型,因为它决定了后续哪些检查项适用。三类业务类型的判定信号如下:

类型页面信号
Brick-and-Mortar(实体门店)页面内容或页脚出现实体街道地址;带图钉/路线按钮的 Google Maps 嵌入;"Visit us at"、"Located at"、"Come see us" 等措辞;LocalBusiness Schema 中的结构化地址
Service Area Business(服务区域业务,SAB)无可见物理地址;出现"serving [城市/地区]"、"service area includes";"We come to you"、"On-site service"、"Mobile [服务名]";Schema 中含areaServed但无address.streetAddress
Hybrid(混合型)物理地址与服务区域措辞同时存在,例如"Visit our showroom"与"We also serve [区域]"并存

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

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

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

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

垂直检测信号
餐饮 Restaurant/menu、菜单项、预订、菜系、点餐、"dine-in"、"takeout"
医疗 Healthcare接受的保险、患者、预约、NPI、医学术语、"Dr."、HIPAA 声明
法律 Legalattorney、lawyer、执业领域、bar admission、案件结果、"free consultation"
家居服务 Home Services服务区域、紧急服务、"free estimate"、licensed/insured/bonded、"24/7"
房地产 Real Estatelistings、MLS、在售/出租房源、经纪人简介、brokerage、"open house"
汽车 Automotiveinventory、VIN、试驾、经销商、服务部门、"new/used/certified"

如果未检测到任何垂直,则走通用的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 引用,输出结构化发现:

模式严重级说明
GBP Chat / 通话记录 CTA("Message us on Google" 等)Critical2024-07-31 全面关停,CTA 已失效并损害用户信任
*.business.siteURLHigh2024 年 3 月关停、2024-06-10 重定向过期,属死链
嵌入式 GBP Q&AMedium2025 年 12 月退役,由 Ask Maps Gemini AI 取代,嵌入可能空白渲染

用法示例: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。

错误处理矩阵

场景处理动作
URL 不可达(DNS 失败、连接拒绝)清晰报告错误,不要猜测站点内容,建议用户核对 URL 后重试
页面未检测到本地信号报告未发现本地商家指标,建议用户确认这是本地商家并提供 GBP 列表 URL
页面 HTML 中找不到 NAP检查 Schema 与 meta 标签;仍缺失则标记为 Critical,建议在页脚与联系页添加可见 NAP
行业垂直不明确呈现检测到的前两个垂直及其支持信号,请用户确认后再应用行业专属建议
50+ 位置页的多地点站点应用 seo 编排器的质量门控:30+ 页时 WARNING(强制 60%+ 唯一内容),50+ 页时 HARD STOP(要求用户说明理由后才能继续)

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、律师-客户特权等特殊约束,审计报告需按行业路由到对应检查项。

【免费下载链接】claude-seo

Universal 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
点击查看免费下载
上一篇:Go-QRCode最佳实践:企业级二维码生成解决方案终极指南
下一篇:Is-Prime项目揭秘:O(1)时间复杂度的素数检测算法如何实现95%+准确率?

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询