传统SEO审计依赖人工或云端SaaS，存在数据隐私与成本门槛。Claude SEO通过开源Agent架构将审计流程本地化，兼容静态站与SPA，并内置GEO生成式搜索检测。掌握其部署与指令逻辑，可快速输出标准化优化报告，提升站点诊断效率。
Claude SEO的核心定位与能力
Claude SEO 是一款开源的 SEO 审计项目，原生对接 Claude Code，将传统人工审计流程封装为可调用的 Agent 能力。项目支持普通静态网站与 SPA 单页应用，输出标准化可落地的优化报告。核心功能全部开放，第三方数据源接口需使用者自行准备密钥，数据主要在本地完成运算，不会将站点数据上传第三方服务器。
安装部署与环境自检
项目提供三种安装路径，适配不同操作系统与使用习惯：
- 方式一（推荐）：通过 Claude Code 插件市场直接安装，流程最简；
- 方式二：macOS/Linux 用户可执行项目提供的 Shell 一键部署脚本；
- 方式三：Windows 用户使用 PowerShell 离线安装脚本。
安装完成后，执行 /seo doctor 进行环境自检，确认运行依赖与权限配置正常后再开始审计任务。
常用审计指令与输出格式
工具通过 CLI 指令触发不同维度的分析任务，覆盖全站、单页、GEO 适配与结构化数据校验：
/seoaudit 目标网址 # 全站深度审计 /seopage 目标网址 # 单页面精细化分析 /seogeo 目标网址 # GEO生成式搜索适配评分 /seoschema 目标网址 # 结构化数据校验与生成
任务执行完毕后，可获取 Markdown 报告、PDF 报告或 JSON 原始数据。根据报告给出的校验标准，可逐项完成站点优化。若未配置第三方 API 密钥，Core Web Vitals 仅返回实验室模拟数据，无法获取谷歌真实用户 CrUX 指标。
竞品对比与数据隐私说明
与 Screaming Frog SEO Spider 和 Ahrefs Site Audit 相比，Claude SEO 在部署模式、GEO 检测、隐私与成本上具有差异化特征：
- 部署与集成：开源本地运行，可直接嵌入 Claude Code 开发工作流；Screaming Frog 为独立桌面客户端，Ahrefs 为 SaaS 云端平台，均无法无缝接入代码环境。
- GEO 生成式搜索检测：Claude SEO 原生内置专项模块；Screaming Frog 无原生 GEO 检测，Ahrefs 更新存在滞后。
- 数据隐私：数据本地处理不上传第三方；Screaming Frog 同样本地处理但日志可导出，Ahrefs 数据需上传厂商云端。
- 成本模式：核心功能 MIT 开源免费，第三方接口自备密钥；Screaming Frog 采用付费授权加少量免费额度，Ahrefs 为按月订阅付费。
常见问题与使用边界
是否必须付费才能使用？
项目主体为 MIT 开源，核心审计功能免费。仅对接 Ahrefs、DataForSEO 等第三方数据源时，需自行准备对应服务的账号密钥。
静态网站与 SPA 兼容性如何？
普通静态网站检测效果稳定；SPA 页面中需要滚动、点击才加载的内容可能存在识别噪音，建议交叉核验检测结果。
不配置谷歌 API 密钥能否运行？
可以正常运行基础审计，但无法获取 GSC、GA4 真实业务数据，Core Web Vitals 只能得到实验室模拟值，缺少真实用户指标。
工具会直接修改网站代码吗？
本身只做审计并输出优化建议，不会自动修改站点代码；可结合 Claude Code 能力，参考报告手动完成代码修改。
Windows 安装会污染本机 Python 环境吗？
不会。部署脚本会创建隔离 Python 运行环境，不改动系统全局依赖，并提供一键卸载脚本。
项目 GitHub 地址：https://github.com/AgriciDaniel/claude-seo
