Claude SEO 开源发布：面向 Claude Code 的全能 SEO 插件，内置 19 个专业 Agent 与 GEO 优化能力

在 Claude Code 内部运行的免费开源 SEO 审计工具。
帮助你在 Google 中获得更高排名，并在 AI 搜索中被频繁引用。

安装指南 · 功能演示 · 实际成效 · 团队 Agent · 命令列表 · 成本对比 · 常见问题

Claude SEO 是一款适用于 Claude Code 的免费 SEO 插件。 只需提供任意网址，它便会在 10 到 15 分钟内执行全方位的 SEO 审计，并输出一份按照重要性降序排列的清晰行动方案。

它覆盖了一名优秀 SEO 顾问所需要检查的所有维度：

• 技术 SEO（Technical SEO）。 抓取能力、索引状况、站点地图、robots.txt、重定向规则、页面加载速度以及核心网页指标（Core Web Vitals）。
• 内容质量（Content Quality）。 E-E-A-T 体系（经验、专业、权威与可信度）、薄弱页面排查及主题覆盖度。
• 结构化数据（Structured Data）。 发现、验证并编写用于富媒体搜索结果（Rich Results）的 Schema.org 标记代码。
• AI 搜索（GEO）。 评估页面被 Google AI Overviews、AI Mode、ChatGPT、Perplexity 与 Gemini 等引擎引用的概率。
• 本地与电商 SEO（Local & E-commerce SEO）。 Google Business Profile（谷歌商家资料）、用户评价、地图包（Map Pack）、产品页面以及国际化多语言站点优化。

Claude SEO 由 26 个子技能和 19 个专业 Agent 组成，最多可支持 17 个 Agent 同时对网站协同分析。每条建议均清晰注明其必要原因，以及后续验证改动是否生效的验收方法。

在 Claude Code 终端中输入 /seo 即可查看所有命令：

发起一次完整审计，实时观察各 Agent 在整站中分工协作：

在 YouTube 上观看完整演示视频

该项目自身的官方站点 claude-seo.md 自上线第一天起便全程由 Claude SEO 进行审计：在前 12 周内即获得 1.08 万次 Google Search Console 点击量，并在移动端 PageSpeed 获得 99 分的高分成绩。

全部 19 个专业 Agent

Agent	角色职责	所用模型	触发命令
seo-technical	技术 SEO 负责人	Sonnet	/seo technical
seo-content	内容主编	Opus	/seo content
seo-schema	结构化数据工程师	Sonnet	/seo schema
seo-sitemap	站点地图架构师	Sonnet	/seo sitemap
seo-performance	性能优化工程师	Sonnet	/seo audit
seo-visual	视觉质检师	Sonnet	/seo audit
seo-geo	AI 搜索分析师	Opus	/seo geo
seo-agentic	Agent 就绪度分析师	Sonnet	/seo agentic
seo-local	本地 SEO 专家	Sonnet	/seo local
seo-maps	地图搜索分析师	Sonnet	/seo maps
seo-google	Google 数据分析师	Sonnet	/seo google
seo-backlinks	外链分析师	Sonnet	/seo backlinks
Live data (extension)	实时数据分析师	Sonnet	/seo audit
seo-image-gen	图像制作师（扩展）	Sonnet	/seo image-gen
seo-cluster	主题策略师	Opus	/seo cluster
seo-sxo	搜索体验设计师	Opus	/seo sxo
seo-drift	异动监控师	Opus	/seo drift
seo-ecommerce	电商 SEO 专家	Sonnet	/seo ecommerce
seo-flow	FLOW 策略师	Sonnet	/seo flow

专为以下群体打造：

• SEO 服务机构（Agencies）： 希望将季度审计升级为面向每个客户的每周例行审计，并通过变更监测及时捕获两次检查期间发生的突发问题。
• 企业内部 SEO 团队（In-house SEO teams）： 适用于 SaaS、内容发布与电商公司，在每次版本上线前提供全方位把关（涵盖 AI 搜索评估）。
• 独立 SEO 顾问（Freelancers）： 首次沟通即可完成整站审计，在正式出具合作方案前展示真实得分与核心待修复项。

包含六大维度的 30 项核心与扩展命令。展开即可查看其具体功能；更多扩展命令详见完整命令参考手册。

审计与规划（Audits and Planning）（5 个命令）

• /seo setup：创建或更新隔离的 Python 运行环境与 Chromium 浏览器
• /seo doctor：在不改动系统配置的前提下检查环境就绪状态
• /seo audit <url>：通过多 Agent 并行协作执行全站 SEO 审计
• /seo page <url>：针对单个页面的深度分析
• /seo plan <type>：制定战略级 SEO 规划（可选类型：saas、local、ecommerce、publisher、agency）

技术 SEO（Technical SEO）（7 个命令）

• /seo technical <url>：覆盖 9 大维度的技术性 SEO 审计
• /seo sitemap <url | generate>：分析或自动生成 XML 站点地图
• /seo images <url>：图片资源优化深度分析
• /seo hreflang <url>：Hreflang 标签与国际化多语言 SEO 审计及代码生成
• /seo programmatic <url>：程序化 SEO（Programmatic SEO）分析与策略规划
• /seo google [command]：调用 Google SEO 官方 API：GSC、PageSpeed、CrUX、Indexing、GA4 及 PDF 报告导出
• /seo drift baseline | compare | history <url>：基于 SQLite 快照的 SEO 状态偏移/异动监测

内容与 E-E-A-T（Content and E-E-A-T）（6 个命令）

• /seo content <url>：E-E-A-T 标准与内容质量综合评估
• /seo content-brief <topic>：生成内容撰写大纲：包含目标关键词、结构骨架与内链建议
• /seo cluster <keyword>：基于 SERP 真实结果的语义主题聚类
• /seo sxo <url>：搜索体验优化（Search Experience Optimization）：识别页面类型、用户故事与受众画像
• /seo flow [stage]：FLOW 框架结构化提示词（基于 CC BY 4.0 协议，以事实为导向）
• /seo competitor-pages <url>：自动生成竞品对比页面内容架构

结构化数据与 AI 搜索（Schema and AI Search）（3 个命令）

• /seo schema <url>：检测、校验并生成 Schema.org 结构化标记代码
• /seo geo <url>：Google AI Overviews 与生成式引擎优化（GEO）深度分析
• /seo agentic <url>：Agent 就绪度评估：Lighthouse Agentic Browsing X/N 评分、AI Agent 访问支持度、llms.txt、Markdown 适配以及 WebMCP

本地、外链与电商（Local, Links, Commerce）（4 个命令）

• /seo local <url>：本地 SEO：评估 Google Business Profile、名录引用、用户评价及地图包排名
• /seo maps [command]：地图搜索情报分析：地理网格排名、GBP 审计、评价分析与竞品调研
• /seo backlinks <url>：外链画像分析（集成 Moz、Bing、Common Crawl 数据）
• /seo ecommerce <url>：电商独立站 SEO 与电商平台搜索情报

扩展插件（Extensions）（5 个命令）

• /seo image-gen [use-case]：生成适配 SEO 物料的 AI 图像
• /seo seranking [command]：监控在 ChatGPT、Gemini、Perplexity、AI Overviews 与 AI Mode 中的 AI 声量份额（Share-of-Voice）
• /seo profound [command]：大语言模型引用时序追踪分析
• /seo bing [command] <url>：Bing Webmaster Tools 集成与 IndexNow 链接即时提交
• /seo unlighthouse <url>：本地多页面 Lighthouse 批量跑分工具

方案全维度对比
| 人工手动排查 | 雇佣外部代理商 | 传统 SEO 审计软件 | Claude SEO
---|---|---|---|---
单次审计耗时 | 4 至 8 小时 | 1 至 3 周 | 10 至 45 分钟 | 10 至 15 分钟
使用成本 | 计入人工工时费 | 每个项目 2,000 至 15,000+ 美元 | 每月 99 至 999 美元订阅费 | 免费，仅需现有的 Claude Code 订阅
检查标准一致性 | 取决于执行人员水平 | 取决于负责的服务团队 | 是 | 每次遵循完全一致的检查清单
最终交付物 | 电子表格或 PDF | 幻灯片演示文稿 | 网页仪表盘及 CSV 导出文件 | 完全由你掌控的 Markdown、PDF 与 JSON 文件
数据保留在本地 | 是 | 否 | 否 | 是，完全在本地机器上运行
覆盖 AI 搜索 | 视情况而定 | 视情况而定 | 规则更新往往滞后数月 | 是，紧跟 Google 官方最新指导准则
每项修复均提供验证方案 | 偶尔包含 | 偶尔包含 | 极少包含 | 每一项均包含可量化验收方式

注：以上列出的市场价格仅作为参考对比，实际收费可能因情况而异。

1. 主动理解站点架构。 Claude SEO 会自动识别你的商业模式（SaaS、本地生活、电商、内容门户或代理商），并自适应调整检查策略。
2. 专业 Agent 协同推进。 最多 17 个专业 Agent 并行执行审计：涵盖技术底层、内容质量、Schema 标记、访问速度、AI 搜索适配等各个环节。
3. 输出落地行动方案而非告警列表。 所有发现均经过量化打分，并梳理为一份按优先级排序的行动指南。每条改进建议均明确指明判断依据、前后置依赖，以及后续的验证方法。

审计报告会保存为标准的 Markdown 文件，使用 /seo google report 命令可将其自动转换为排版精美的 PDF 报告。

实际报告片段示例：Schema 结构化数据审计的起始部分

# Schema Markup Report: rankenstein.pro/about

| Metric              | Value                                       |
|---------------------|---------------------------------------------|
| JSON-LD Blocks      | 3                                           |
| Schema Types        | Organization, WebSite, SoftwareApplication  |
| Critical Issues     | 2                                           |
| Warnings            | 5                                           |
| Passed Checks       | 18                                          |
| Overall Grade       | B+ (solid foundation, actionable gaps)      |

**Critical Issue:** The `founder` property only includes Daniel Agrici.
Benjamin Samar (Co-Founder and Technical Director) is displayed on the page
but absent from the schema. This content-schema mismatch can confuse search engines.

如需深入了解项目原理，欢迎查阅方法论体系与系统架构说明。

安装需依赖 Claude Code 1.0.33 或更高版本。在终端中执行以下三行命令：

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

/seo setup 将自动准备 Claude SEO 所需的环境组件（独立的 Python 运行环境以及无头浏览器 Chromium），不会对操作系统的全局配置造成任何污染。用户可随时通过运行 /seo doctor 命令检测环境健康状况。

手动安装方式：macOS 与 Linux

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-s

Free, open-source SEO audits insideClaude Code.
Rank higher in Google and get cited by AI search.

Install · Demo · Results · Team · Commands · Pricing · FAQ

Claude SEO is a free SEO plugin for Claude Code. Give it any website and it runs a full SEO audit in 10 to 15 minutes, then hands you a clear action plan, sorted by what matters most.

It checks everything a good SEO consultant would:

• Technical SEO. Crawlability, indexing, sitemaps, robots.txt, redirects, page speed and Core Web Vitals.
• Content quality. E-E-A-T (experience, expertise, authority and trust), thin pages and topic coverage.
• Structured data. Finds, validates and writes Schema.org markup for rich results.
• AI search (GEO). How likely Google AI Overviews, AI Mode, ChatGPT, Perplexity and Gemini are to cite your pages.
• Local and e-commerce SEO. Google Business Profile, reviews, map pack, product pages and international sites.

Claude SEO is built from 26 sub-skills and 19 specialist agents, and up to 17 agents work on your site at the same time. Every recommendation explains why it matters and how you will know it worked.

Type /seo in Claude Code to see every command:

Run a full audit and watch the agents fan out across the site:

Watch the full demo on YouTube

The project's own site, claude-seo.md, audited with Claude SEO from day one: 10.8K Search Console clicks in its first 12 weeks and a 99 mobile PageSpeed score.

All 19 agents

Agent	Role	Model	Command
seo-technical	Technical SEO Lead	Sonnet	/seo technical
seo-content	Content Editor	Opus	/seo content
seo-schema	Structured Data Engineer	Sonnet	/seo schema
seo-sitemap	Sitemap Architect	Sonnet	/seo sitemap
seo-performance	Performance Engineer	Sonnet	/seo audit
seo-visual	Visual QA	Sonnet	/seo audit
seo-geo	AI Search Analyst	Opus	/seo geo
seo-agentic	Agent Readiness Analyst	Sonnet	/seo agentic
seo-local	Local SEO Specialist	Sonnet	/seo local
seo-maps	Maps Analyst	Sonnet	/seo maps
seo-google	Google Data Analyst	Sonnet	/seo google
seo-backlinks	Link Analyst	Sonnet	/seo backlinks
Live data (extension)	Live Data Analyst	Sonnet	/seo audit
seo-image-gen	Image Producer (extension)	Sonnet	/seo image-gen
seo-cluster	Topic Strategist	Opus	/seo cluster
seo-sxo	Search Experience Designer	Opus	/seo sxo
seo-drift	Change Monitor	Opus	/seo drift
seo-ecommerce	E-commerce Specialist	Sonnet	/seo ecommerce
seo-flow	FLOW Strategist	Sonnet	/seo flow

Built for:

• SEO agencies that want weekly audits for every client instead of quarterly ones, with change monitoring to catch problems in between.
• In-house SEO teams at SaaS, publishing and e-commerce companies that want a second pair of eyes before every review, AI search included.
• Freelance SEO consultants who want to run an audit on the first call and show a real score and the top fixes before writing a proposal.

30 core and extension commands in six groups. Open one to see what is inside; a few more extension commands are in the full command reference.

Audits and Planning (5 commands)

• /seo setup: Create or refresh the isolated Python runtime and Chromium
• /seo doctor: Check runtime readiness without changing the system
• /seo audit <url>: Full website audit with parallel agents
• /seo page <url>: Deep single-page analysis
• /seo plan <type>: Strategic SEO planning (saas, local, ecommerce, publisher, agency)

Technical SEO (7 commands)

• /seo technical <url>: Technical SEO audit across 9 categories
• /seo sitemap <url | generate>: Analyze or generate XML sitemaps
• /seo images <url>: Image optimization analysis
• /seo hreflang <url>: Hreflang and i18n SEO audit and generation
• /seo programmatic <url>: Programmatic SEO analysis and planning
• /seo google [command]: Google SEO APIs: GSC, PageSpeed, CrUX, Indexing, GA4, PDF reports
• /seo drift baseline | compare | history <url>: SEO drift monitoring with SQLite snapshots

Content and E-E-A-T (6 commands)

• /seo content <url>: E-E-A-T and content quality analysis
• /seo content-brief <topic>: Content brief: target keywords, outline, internal links
• /seo cluster <keyword>: SERP-based semantic clustering
• /seo sxo <url>: Search Experience Optimization: page type, user stories, personas
• /seo flow [stage]: FLOW framework prompts (CC BY 4.0, evidence-led)
• /seo competitor-pages <url>: Competitor comparison page generation

Schema and AI Search (3 commands)

• /seo schema <url>: Detect, validate and generate Schema.org markup
• /seo geo <url>: AI Overviews and Generative Engine Optimization
• /seo agentic <url>: Agent readiness: Lighthouse Agentic Browsing X/N, AI agent access, llms.txt, Markdown, WebMCP

Local, Links, Commerce (4 commands)

• /seo local <url>: Local SEO: GBP, citations, reviews, map pack
• /seo maps [command]: Maps intelligence: geo-grid, GBP audit, reviews, competitors
• /seo backlinks <url>: Backlink profile analysis (Moz, Bing, Common Crawl)
• /seo ecommerce <url>: E-commerce SEO and marketplace intelligence

Extensions (5 commands)

• /seo image-gen [use-case]: AI image generation for SEO assets
• /seo seranking [command]: AI Share-of-Voice across ChatGPT, Gemini, Perplexity, AI Overviews, AI Mode
• /seo profound [command]: LLM citation tracking with time-series data
• /seo bing [command] <url>: Bing Webmaster Tools + IndexNow URL submission
• /seo unlighthouse <url>: Multi-page Lighthouse runner, runs locally

The full comparison
| Doing it by hand | Hiring an agency | SEO audit software | Claude SEO
---|---|---|---|---
Time per audit | 4 to 8 hours | 1 to 3 weeks | 10 to 45 minutes | 10 to 15 minutes
Cost | Billable hours | $2k to $15k+ per project | $99 to $999 a month | Free, with your Claude Code plan
Consistent checks | Depends on who does it | Depends on the team | Yes | Same checklist every time
What you get | A spreadsheet or PDF | A slide deck | A dashboard and CSV exports | Markdown, PDF and JSON files you keep
Your data stays with you | Yes | No | No | Yes, it runs on your machine
Covers AI search | Depends | Depends | Often months behind | Yes, follows Google's latest guidance
Each fix comes with a way to check it worked | Sometimes | Sometimes | Rarely | Yes

Typical market prices, for illustration. Your numbers may differ.

1. It learns your site. Claude SEO detects the type of business (SaaS, local, e-commerce, publisher or agency) and adjusts its checks.
2. The team fans out. Up to 17 specialist agents audit the site in parallel: technical, content, schema, speed, AI search and more.
3. You get a plan, not a pile of warnings. Findings are scored and sorted into a prioritized action plan. Each recommendation says what it is based on, what it depends on and how you will know it worked.

Reports are saved as Markdown, and /seo google report turns them into a polished PDF.

See a real report : the start of a schema audit

# Schema Markup Report: rankenstein.pro/about

| Metric              | Value                                       |
|---------------------|---------------------------------------------|
| JSON-LD Blocks      | 3                                           |
| Schema Types        | Organization, WebSite, SoftwareApplication  |
| Critical Issues     | 2                                           |
| Warnings            | 5                                           |
| Passed Checks       | 18                                          |
| Overall Grade       | B+ (solid foundation, actionable gaps)      |

**Critical Issue:** The `founder` property only includes Daniel Agrici.
Benjamin Samar (Co-Founder and Technical Director) is displayed on the page
but absent from the schema. This content-schema mismatch can confuse search engines.

Want the details? Read the methodology and the architecture.

You need Claude Code 1.0.33 or newer. Run these three commands inside it:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

/seo setup prepares everything Claude SEO needs (its own Python environment and a headless browser) without touching the rest of your system. Run /seo doctor any time to check it.

Manual install: macOS and Linux

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

One-liner (curl, review then run):

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh        # review before running
bash install.sh
rm install.sh

Manual install: Windows (PowerShell)

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

Whygit clone instead of irm | iex? Claude Code's own security guardrails flag irm ... | iex as a supply chain risk: downloading and executing remote code without verification. The git clone approach lets you inspect claude-seo\install.ps1 before running it.

Two versions. This public version is MIT licensed and free for everyone. AI Marketing Hub Pro members also get a private version with early access to new features. Members install it with:

/plugin marketplace add AI-Marketing-Hub/claude-seo
/plugin install claude-seo@ai-marketing-hub-claude-seo
/seo setup

Your first audit:

claude                                   # start Claude Code

/seo audit https://example.com           # full site audit with a prioritized plan
/seo page https://example.com/pricing    # one page, in depth
/seo geo https://example.com             # how ready you are for AI search
/seo schema https://example.com          # check and generate structured data
/seo local https://example.com           # local SEO and Google Business Profile

What is Claude SEO?

A free, open-source SEO audit tool that runs inside Claude Code. It checks technical SEO, Core Web Vitals, content quality, Schema.org structured data, AI search readiness, local SEO, e-commerce and international SEO, then gives you a prioritized action plan. It follows Google's own documentation, including the AI Optimization Guide.

Is it really free?

Yes. It is MIT licensed, with no per-site pricing, no usage limits and no tracking. You only need Claude Code. A few optional extensions connect to paid services where you bring your own account, but everything works without them.

Do I need API keys?

No. Claude SEO works out of the box. If you want real field data, you can connect free Google APIs (PageSpeed Insights, Chrome UX Report, Search Console and Google Analytics 4) with /seo google setup. Your keys stay on your machine.

How does it help with AI search like Google AI Overviews and ChatGPT?

Google says optimizing for AI search is still SEO, so Claude SEO starts with the basics that AI answers rely on: being indexed, fast and clear. Then /seo geo scores how easy your pages are to quote, checks that AI crawlers can reach them and looks at your brand's presence on Wikipedia, Reddit, YouTube and LinkedIn. /seo agentic checks how well AI agents can use your site.

Does it work on JavaScript sites like Next.js, React or Vue?

Yes. When a page needs JavaScript to show its content, Claude SEO opens it in a headless browser automatically, so single-page apps are audited as visitors see them.

How is it different from Screaming Frog or other SEO tools?

Crawlers like Screaming Frog crawl faster and deeper, and big SEO suites have their own backlink databases. Claude SEO does something else: it explains what it finds, sorts it by impact, covers AI search in depth and lets you ask follow-up questions in plain English. Many people use both.

Does my data leave my computer?

Claude SEO runs inside Claude Code, so the pages and data it analyzes are sent to Claude, Anthropic's model, the same as anything else you work on in Claude Code. Reports are saved as files on your machine. No SEO service or other third party sees your data unless you connect an extension or API yourself. Besides the site you audit, some checks read public sources such as Wikipedia, Reddit and Common Crawl. See PRIVACY.md for the full list.

Good to know: requirements, limits and uninstall

Requirements. Claude Code 1.0.33 or newer and Python 3.11 to 3.14. /seo setup installs the headless browser for you.

Cost of a full audit. Five agents that need more judgment run on Opus and the rest on Sonnet, so a full /seo audit uses more of your Claude plan than a single-page check. You can change any agent's model in its file under agents/.

Limits. Without Google API keys, Core Web Vitals are lab estimates and indexing is inferred from the page. Pages that load key content only after scrolling or clicking can give noisy results.

Uninstall. Installed as a plugin: /plugin uninstall claude-seo@agricidaniel-claude-seo. Installed manually:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.sh

Optional add-ons that bring in more data. Claude SEO works fully without them.

• Banana: AI images for SEO, from social previews to blog heroes (Claude Banana)
• SE Ranking: your share of voice in ChatGPT, Gemini, Perplexity and Google AI answers
• Profound: tracks when AI models cite your site
• Bing Webmaster: Bing data plus instant IndexNow submission
• Unlighthouse: Lighthouse scores for every page of your site

Setup guides live in extensions/.

More from the same family

Project	What it does
Claude Blog	Writes and optimizes blog posts from your SEO findings
Claude Banana	AI image generation for SEO assets and posts
ChatGPT SEO	Turns a page, draft or SEO export into a sourced fix plan inside ChatGPT
FLOW	An evidence-led SEO framework with 42 AI prompts
AI Marketing Claude	Community suite for copy, email, ads and funnels

Docs: Installation · Commands · Architecture · Troubleshooting · Extensions setup · Security · Privacy · Contributors

MIT License, see LICENSE. Contributions are welcome: read CONTRIBUTING.md first and mention the checks you ran in your pull request.

Built by Agrici Daniel , AI Workflow Architect, with help from the AI Marketing Hub Pro community.