Claude SEO：在Claude Code里完成AI搜索审计
给SEO团队在Claude Code里做网站审计，兼顾传统SEO和AI搜索引用，不只是爬网页。
GitHub AgriciDaniel/claude-seo 更新 2026-10-26 分支 main 星标 20.9K 分叉 3.0K
Python SEO审计 Claude Code Schema.org GEO/AEO Google APIs

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你已有Claude Code 1.0.33或更高版本，想对网站运行完整SEO审计。
    README 的“Install”章节要求Claude Code 1.0.33或更新版本，/seo audit运行完整站点审计。
  • 你要同时检查Google AI Overviews、ChatGPT、Perplexity与Gemini的引用准备度。
    README 的“Claude SEO is a free SEO plugin for Claude Code”段落列出AI search（GEO）检查范围，/seo geo用于评估AI搜索准备度。
  • 你维护Next.js、React或Vue等需要JavaScript渲染的站点。
    README FAQ说明页面需要JavaScript时会自动使用headless browser，明确列出Next.js、React和Vue。
  • 你是SEO机构，需要把客户审计从季度频率提高到每周，并监控中间变化。
    README 的“Built for”章节明确面向希望每周审计并使用change monitoring的SEO agencies。
  • 你希望用PageSpeed Insights、Chrome UX Report、Search Console和Google Analytics 4补充真实字段数据。
    README FAQ说明可通过/seo google setup连接这四个免费Google APIs。

不适合，如果你

  • 你不能接受页面和分析数据发送给Claude或Anthropic模型。
    README FAQ“Does my data leave my computer?”明确说明数据会发送给Claude、Anthropic的模型。
  • 你主要需要比Claude SEO更快、更深的爬取能力或大型反向链接数据库。
    README FAQ说明Screaming Frog爬取更快更深，大型SEO套件拥有自己的backlink databases。
  • 你只能使用低于Python 3.11的运行环境。
    README“Good to know: requirements, limits and uninstall”要求Python 3.11至3.14。
  • 你的关键内容必须在滚动或点击后才加载，且不能接受可能有噪声的结果。
    README同一章节说明这类页面可能产生noisy results。

前置条件

  • 需要 Claude Code 1.0.33 或更新版本。
  • 需要 Python 3.11 至 3.14；/seo setup 会安装 headless browser。
  • 完整 /seo audit 使用 Opus 与 Sonnet，比单页检查消耗更多 Claude plan。
  • 不需要 API keys；连接真实字段数据时可使用 PageSpeed Insights、Chrome UX Report、Search Console 和 Google Analytics 4。

第一步命令（README 原文）

/plugin marketplace add AgriciDaniel/claude-seo

要注意

  • 没有Google API密钥时，Core Web Vitals不是现场数据而是lab estimates。
    README“Good to know: requirements, limits and uninstall”章节。
  • 使用/seo audit前要考虑Opus代理带来的Claude plan消耗。
    README说明五个需要更多判断的代理使用Opus，其余使用Sonnet。
  • 使用远程安装脚本前应检查内容，README提供cat install.sh后再执行bash install.sh的流程。
    README“Install”章节的curl安装命令与“review then run”说明。
  • 接入Wikipedia、Reddit、Common Crawl等公开来源时，审计读取的不仅是目标站点。
    README FAQ说明部分检查会读取Wikipedia、Reddit和Common Crawl等public sources。

替代方案

  • Screaming Frog：当主要目标是更快、更深地爬取网站时，README明确认为Screaming Frog更强。
    README FAQ：How is it different from Screaming Frog or other SEO tools?
  • 大型SEO套件：当需要大型SEO套件自带的反向链接数据库时，README说明Claude SEO不提供这一类能力。
    README FAQ：How is it different from Screaming Frog or other SEO tools?

材料未说明

  • README省略的Commands章节未提供完整命令清单，无法确认全部可用子命令。
  • README省略的Extensions章节未说明9个optional extensions各自的服务、费用与配置步骤。
  • 材料未说明完整/seo audit在不同网站规模下的实际耗时变化。
  • 材料未说明Claude API或Claude Code计划的具体费用与完整audit的精确额度消耗。
  • 材料未说明支持的认证方式、登录态页面与受保护站点审计范围。
  • 材料未提供26个sub-skills的完整清单，无法逐项核对其覆盖边界。
  • 材料未说明Windows、macOS与Linux之间的功能差异。

💡 深度解析

6
不适合 我已经使用 Screaming Frog 做高速深度抓取，并依赖商业 SEO 套件的反向链接数据库；Claude SEO 能否单独替代这两类工具？
适合读者： 拥有大型网站、已经依赖 Screaming Frog 深度抓取和商业 SEO 套件反向链接数据库的技术 SEO 负责人

不适合单独替代这两类工具，因为项目定位是可对话、面向行动的综合审计，而不是高规模抓取或商业级链接索引。

  • README FAQ 直接承认，Screaming Frog 等爬虫抓取得更快、更深。
  • 同一章节说明大型 SEO 套件拥有自己的反向链接数据库，而 Claude SEO 做的是解释发现、按影响排序，并支持自然语言追问。
  • 项目洞察也指出，反向链接能力不能与拥有大规模自建链接索引的商业平台等量齐观。
  • 它仍适合作为补充层：将技术、内容、Schema、GEO、AI 代理可用性和修复验证整合到一个 Claude Code 工作流中。

如果你的核心约束是数百万页面的抓取深度、速度或完整外链覆盖，README 没有提供替代所需的指标。若目标是把已有发现转化为解释清晰的修复计划，它更有价值。

  • README FAQ「How is it different from Screaming Frog or other SEO tools?」
  • README：Screaming Frog crawls faster and deeper
  • README：big SEO suites have their own backlink databases
  • 项目洞察 market_gap：未完全填补高规模抓取和商业级反向链接数据需求
材料未说明：README 未提供最大抓取页面数、并发抓取速度、队列机制或超大网站的资源需求。；README 未说明反向链接检查具体使用哪些数据源、覆盖规模和更新频率。
不适合 我现在没有 Google Search Console、GA4、PageSpeed Insights 或 CrUX 的 API 密钥，但需要先审计网站的 Core Web Vitals 和索引问题；Claude SEO 的结果能否直接作为现场数据？
适合读者： 没有 Search Console、GA4 或 CrUX API 密钥、但需要判断 Core Web Vitals 和索引状态的内部 SEO 团队

不适合把无 API 密钥时的结果直接当作真实现场数据；它适合先做公开页面基础审计，但性能和索引结论需要区分为估计或推断。

  • FAQ 说明 Claude SEO 不要求 API 密钥，基础功能可以直接运行。
  • 同一章节明确指出，没有 Google API 时，Core Web Vitals 主要是实验室估计，索引状态是基于页面的推断，而不是 Search Console 的真实字段。
  • 项目支持通过 /seo google setup 接入 PageSpeed Insights、Chrome UX Report、Search Console 和 GA4，以获得更接近真实场景的数据。
  • README 还说明 Google API 密钥保存在本机；因此接入扩展后，工具能力更完整，但数据流和权限边界也会改变。

如果当前目标只是发现明显的可抓取性、页面速度和结构问题，可以先运行基础审计；如果目标是作出索引覆盖率或真实用户体验的判断，则不能把无 API 结果视为最终证据。

  • README FAQ「Do I need API keys?」：Claude SEO works out of the box
  • README FAQ「Do I need API keys?」：free Google APIs include PageSpeed Insights, Chrome UX Report, Search Console and Google Analytics 4
  • README「Limits」：Core Web Vitals are lab estimates and indexing is inferred from the page
  • README：Google API keys stay on your machine
/seo google setup
材料未说明：README 未说明 Google API 的具体配额、授权步骤、刷新机制和各接口的失败处理方式。；README 未说明接入 API 后每次审计会额外产生多少请求或运行成本。
适合 我在 Windows 上运行 Python 3.11 至 3.14，并且团队禁止直接执行未经审查的远程脚本；Claude SEO 的安装方式是否符合这个约束？
适合读者： 在 Windows 上部署、要求安装脚本可审查且环境使用 Python 3.11 至 3.14 的网站运营工程师

适合，因为 README 提供 Windows PowerShell 安装流程，并明确推荐先克隆和检查脚本，而不是直接执行远程代码。

  • Requirements 章节要求 Claude Code 1.0.33 或更高版本，以及 Python 3.11 至 3.14。
  • Windows 安装方式是先 git clone --depth 1，再通过 powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1 执行本地脚本。
  • README 解释了为什么不推荐 irm ... | iex：Claude Code 的安全防护会将其标记为供应链风险，因为它下载并执行未经验证的远程代码。
  • /seo setup 会准备项目自己的 Python 环境和无头浏览器，不触碰系统其余部分；/seo doctor 可检查配置。

这满足“先审查再执行”的安装约束，但 ExecutionPolicy Bypass 的使用仍应纳入你们自己的 Windows 安全审批流程。README 没有描述企业代理、杀毒软件或组策略环境下的兼容性。

  • README「Requirements」：Claude Code 1.0.33 or newer and Python 3.11 to 3.14
  • README「Manual install: Windows (PowerShell)」
  • README：`git clone` lets you inspect `claude-seo\install.ps1` before running it
  • README：`/seo setup` installs its own Python environment and headless browser
  • README：run `/seo doctor` any time to check it
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
材料未说明：README 未说明 PowerShell ExecutionPolicy Bypass 在企业组策略下是否会被阻止。；README 未说明 Windows 代理、杀毒软件、网络隔离或无头浏览器依赖的具体兼容性。
适合 我需要为多个客户重复执行网站审计，而且团队已经使用 Claude Code；Claude SEO 能否替代我们当前手工汇总技术 SEO、内容质量、Schema 和 AI 搜索问题的流程？
适合读者： 需要为多个客户重复执行审计、希望用 Claude Code 在 10 到 15 分钟内生成优先级行动计划的 SEO 代理机构顾问

适合，因为它把多领域检查、问题解释和优先级行动计划放进 Claude Code 的同一工作流，但它不是大型爬虫或反向链接数据库的完全替代品。

  • README 称完整审计通常在 10 到 15 分钟完成，并输出按重要性排序的行动计划。
  • 项目由 26 个子技能和 19 个专业代理组成，最多可同时运行 17 个代理，覆盖技术 SEO、内容、Schema、GEO、本地和电商 SEO。
  • 每条建议会说明为什么重要，以及如何验证是否生效，这比单纯导出错误列表更适合客户汇报。
  • FAQ 也明确指出，Screaming Frog 抓取更快更深，大型 SEO 套件拥有反向链接数据库；两者可以并用。

如果客户数量较多，完整审计会比单页检查消耗更多 Claude 计划额度，因为五个高判断任务使用 Opus，其余主要使用 Sonnet。

  • README「Claude SEO is a free SEO plugin for Claude Code」：full SEO audit in 10 to 15 minutes
  • README「It is built from 26 sub-skills and 19 specialist agents」
  • README「up to 17 agents work on your site at the same time」
  • README FAQ「Crawlers like Screaming Frog crawl faster and deeper」
  • README「Cost of a full audit」：five agents use Opus and the rest use Sonnet
/seo audit https://example.com
材料未说明：README 未说明单个 Claude 账户同时处理多少客户网站时的吞吐量和并发限制。；README 未给出不同网站规模下的平均页面数、运行时间和 Claude 费用。
视情况 我维护的是 Next.js、React 或 Vue 网站，页面关键内容由 JavaScript 渲染；如果部分内容还要滚动或点击后才出现，Claude SEO 的页面审计是否可靠？
适合读者： 维护 Next.js、React 或 Vue 单页应用、担心关键内容依赖 JavaScript、滚动或点击后才出现的前端工程师

视情况：对普通客户端渲染内容较适合，但依赖复杂交互、滚动或点击才能出现的内容存在噪声风险。

  • README 明确支持 Next.js、React 和 Vue；页面需要 JavaScript 时，工具会自动用无头浏览器打开页面，因此不是只抓取初始 HTML。
  • 项目洞察说明底层结合 Python、Shell、PowerShell 和无头浏览器处理页面抓取与 JavaScript 渲染。
  • 但 README 的限制也明确指出，关键内容只有在滚动或点击后加载时，结果可能不稳定或嘈杂。
  • 因此它适合审计访客通常能看到的 SPA 内容，不足以证明所有交互状态、登录后内容或复杂延迟加载流程都已被完整覆盖。

对关键页面可以先用单页命令观察工具实际看到的内容，再决定是否把结果纳入技术修复清单；README 没有承诺对登录态或任意交互流程提供完整模拟。

  • README FAQ「Does it work on JavaScript sites like Next.js, React or Vue?」
  • README FAQ：页面需要 JavaScript 时会自动使用 headless browser
  • README「Limits」：内容只有在 scrolling or clicking 后加载时，结果可能 noisy
  • 项目洞察 solution_analysis：使用无头浏览器处理页面抓取和 JavaScript 渲染
/seo page https://example.com/pricing
材料未说明：README 未说明无头浏览器支持哪些具体浏览器版本、登录流程、Cookie 或身份验证机制。；README 未量化滚动、点击和延迟加载场景下的漏检率或误报率。
适合 我需要同时检查 Google AI Overviews、AI Mode、ChatGPT、Perplexity 和 Gemini 的引用准备度，还要确认 AI 爬虫能否访问网站；Claude SEO 是否适合做这类诊断？
适合读者： 负责品牌在 Google AI Overviews、AI Mode、ChatGPT、Perplexity 和 Gemini 中可见性的 GEO 专员

适合做 AI 搜索准备度诊断，但不适合把评分理解为这些平台真实引用概率的精确预测。

  • README 将 AI search（GEO）列为核心能力，检查 Google AI Overviews、AI Mode、ChatGPT、Perplexity 和 Gemini 是否可能引用页面。
  • /seo geo 会评估页面是否容易被引用、AI 爬虫是否能够访问，并检查品牌在 Wikipedia、Reddit、YouTube 和 LinkedIn 上的公开存在。
  • /seo agentic 进一步检查 AI 代理使用网站的能力，项目洞察还列出 Lighthouse Agentic Browsing、WebMCP 和 llms.txt。
  • README 说明其方法仍从可索引、快速、清晰等传统 SEO 基础开始，因此它更像准备度与可访问性审计，而不是各平台黑盒检索结果的实测排名。

这对定位 robots、内容清晰度、结构化信息和代理可用性问题有直接价值；但 README 没有承诺能复现每个平台的真实生成答案或引用结果。

  • README 功能列表「AI search (GEO)」
  • README FAQ「How does it help with AI search like Google AI Overviews and ChatGPT?」
  • README：`/seo geo` checks AI crawlers and brand presence on Wikipedia, Reddit, YouTube and LinkedIn
  • README：`/seo agentic` checks how well AI agents can use your site
  • 项目数据 description：agent readiness covers Lighthouse Agentic Browsing, WebMCP and llms.txt
/seo geo https://example.com
材料未说明：README 未说明 GEO 评分的计算公式、训练数据、更新时间或各平台分别使用的权重。；README 未说明是否会真实调用 Google、OpenAI、Perplexity 或 Gemini 的搜索与生成接口。

✨ 核心亮点

  • 26个子技能与19个专用代理并行审计
  • 10至15分钟输出按影响排序的行动计划
  • 覆盖Google AI Overviews与ChatGPT引用
  • 支持Next.js、React、Vue的无头浏览器审计
  • 完整audit会消耗更多Claude计划额度

🔧 工程化

  • 用/seo audit检查技术SEO、内容、Schema.org与GEO
  • /seo geo评估页面被Google与AI模型引用的准备度
  • /seo google setup连接PageSpeed与Search Console数据
  • 多代理模型使用Sonnet与Opus解释优先级

⚠️ 风险

  • 无Google API密钥时Core Web Vitals只是实验室估算
  • 滚动或点击后加载内容可能造成结果噪声
  • 页面数据会发送给Claude与Anthropic模型
  • Screaming Frog在爬取速度与深度上更强

👥 适合谁？

  • 使用Claude Code的SEO机构与顾问
  • SaaS、出版与电商公司的内部SEO团队
  • 需要审计Next.js、React或Vue站点的团队
  • 需要Google Business Profile与电商SEO检查的团队