catalog/repos/agricidaniel--claude-seo.md

12 KiB
Raw Blame History

Claude Code SEO审计技能

SEO Claude Code 技术SEO 内容优化 谷歌API

Claude SEO - Claude Code 的 SEO 审计技能

Claude Code 的全面 SEO 分析技能。涵盖技术SEO、页面分析、内容质量E-E-A-T、Schema标记、图片优化、站点地图架构、AI搜索优化GEO、本地SEO、地图智能、谷歌SEO APISearch Console、PageSpeed、CrUX、GA4、PDF报告生成及战略规划。

CI Claude Code Skill License: MIT Version

博客: Claude Code SEO技术栈完整解析 | v1.7.2版本Firecrawl外链分析

目录

安装

插件安装Claude Code 1.0.33+

# 添加市场(一次性操作)
/plugin marketplace add AgriciDaniel/claude-seo

# 安装插件
/plugin install claude-seo@AgriciDaniel-claude-seo

手动安装Unix/macOS/Linux

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh
一键安装curl
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash

或通过 install.cat

curl -fsSL install.cat/AgriciDaniel/claude-seo | bash

希望在运行前检查脚本?

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh        # 检查内容
bash install.sh       # 确认无误后运行
rm install.sh

WindowsPowerShell

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

为什么用 git clone 而不是 irm | iex Claude Code 自身的安全机制会将 irm ... | iex 标记为供应链风险下载并直接执行远程代码无需验证。git clone 方式允许您在运行前检查 claude-seo\install.ps1 脚本内容。

快速开始

# 启动 Claude Code
claude

# 运行完整站点审计
/seo audit https://example.com

# 分析单个页面
/seo page https://example.com/about

# 检查 Schema 标记
/seo schema https://example.com

# 生成站点地图
/seo sitemap generate

# 优化 AI 搜索
/seo geo https://example.com

演示:

在 YouTube 观看完整演示

/seo audit:通过并行子代理执行完整站点审计

命令

命令 描述
/seo audit <url> 通过并行子代理委托执行完整网站审计
/seo page <url> 深度单页面分析
/seo sitemap <url> 分析现有 XML 站点地图
/seo sitemap generate 使用行业模板生成新站点地图
/seo schema <url> 检测、验证并生成 Schema.org 标记
/seo images <url> 图片优化分析
/seo technical <url> 技术SEO审计9个类别
/seo content <url> E-E-A-T 与内容质量分析
/seo geo <url> AI 摘要 / 生成式引擎优化
/seo plan <type> 战略SEO规划saas、本地、电商、媒体、代理商
/seo programmatic <url> 程序化SEO分析与规划
/seo competitor-pages <url> 竞品对比页面生成
/seo local <url> 本地SEO分析GBP、引用、评论、地图包
/seo maps [command] 地图智能地理网格、GBP审计、评论、竞品
/seo hreflang <url> Hreflang/i18n SEO 审计与生成
/seo google [command] [url] 谷歌SEO APIGSC、PageSpeed、CrUX、索引、GA4
/seo google report [type] 生成带图表的 PDF/HTML 报告cwv-audit、gsc-performance、full

/seo programmatic [url|plan]

程序化SEO分析与规划

从数据源批量构建SEO页面并设有质量保障机制。

功能:

  • 分析现有程序化页面的内容稀薄问题和关键词蚕食现象
  • 为数据驱动页面规划URL模式和模板结构
  • 生成页面之间的内部链接自动化
  • 规范标签策略与索引膨胀防控
  • 质量门控超过100个页面时发出警告超过500个页面时强制停止并要求审计

/seo competitor-pages [url|generate]

竞品对比页面生成器

创建高转化率的"X vs Y"和"X 的替代方案"页面。

功能:

  • 带功能矩阵的结构化对比表格
  • 带 AggregateRating 的产品 Schema 标记
  • 针对转化优化的布局与 CTA 放置
  • 针对比较意图查询的关键词定向
  • 竞品公正呈现的准确性指引

/seo hreflang [url]

Hreflang / i18n SEO 审计与生成

验证并生成多语言网站的 hreflang 标签。

功能:

  • 生成 hreflang 标签HTML、HTTP 头或 XML 站点地图)
  • 验证自引用标签、返回标签、x-default
  • 检测常见错误缺少返回标签、无效代码、HTTP/HTTPS 不一致)
  • 跨域 hreflang 支持
  • 语言/地区代码验证ISO 639-1 + ISO 3166-1

功能特性

核心网页指标(当前指标)

  • LCP(最大内容绘制):目标 < 2.5秒
  • INP(下次绘制交互):目标 < 200毫秒
  • CLS(累积布局偏移):目标 < 0.1

注意INP 已于2024年3月12日取代 FID。FID 已于2024年9月9日从所有 Chrome 工具中完全移除。

E-E-A-T 分析

更新至2025年9月质量评估指南

  • 经验Experience:第一手知识信号
  • 专业知识Expertise:作者资质与内容深度
  • 权威性Authoritativeness:行业认可度
  • 可信度Trustworthiness:联系信息、安全性、透明度

Schema 标记

  • 检测JSON-LD推荐、Microdata、RDFa
  • 依据谷歌支持类型进行验证
  • 使用模板生成
  • 废弃提醒:
    • HowTo已废弃2023年9月
    • FAQ仅限政府/医疗网站2023年8月
    • SpecialAnnouncement已废弃2025年7月

AI搜索优化GEO

2026年新增 - 优化适配:

  • 谷歌 AI 摘要
  • ChatGPT 网页搜索
  • Perplexity
  • 其他 AI 驱动搜索引擎

谷歌SEO APIv1.7.0新增)

直接集成谷歌SEO数据

  • PageSpeed Insights + CrUX:实验室和现场核心网页指标数据
  • Search Console热门查询、URL检查、站点地图状态
  • 索引API:通知谷歌新增/更新/删除的URL
  • GA4:自然流量、热门落地页、设备/国家分布
  • PDF报告:通过 WeasyPrint + matplotlib 生成企业级A4报告含图表

四级凭证系统——每个层级均可获得对应价值:

层级 认证 可用API
0 API密钥 PSI、CrUX、CrUX历史
1 + OAuth/SA + GSC、URL检查、索引
2 + GA4配置 + GA4自然流量
3 + Ads令牌 + 关键词规划师

本地SEO与地图智能v1.6.0新增)

  • 谷歌商家资料优化
  • NAP一致性审计
  • 引用与评论分析
  • 地理网格排名跟踪与竞品半径地图

质量门控

  • 超过30个地区页面时发出警告
  • 超过50个地区页面时强制停止
  • 按页面类型检测内容稀薄问题
  • 门廊页面防控

架构

~/.claude/skills/seo/         # 主编排技能
~/.claude/skills/seo-*/       # 子技能15个 + 2个扩展
~/.claude/agents/seo-*.md     # 子代理10个 + 2个扩展

视频与直播 Schema新增

针对视频内容、直播和关键时刻的额外 Schema 类型:

  • VideoObject视频页面标记含缩略图、时长、上传日期
  • BroadcastEvent直播内容的直播标识支持
  • Clip视频内的关键时刻/章节
  • SeekToAction在视频富结果中启用跳转功能
  • SoftwareSourceCode开源及代码仓库页面

参见 schema/templates.json 获取即用型 JSON-LD 代码片段。

近期新增

  • 程序化SEO技能/seo programmatic
  • 竞品对比页面技能(/seo competitor-pages
  • 多语言 hreflang 验证(/seo hreflang
  • 视频与直播 Schema 类型VideoObject、BroadcastEvent、Clip、SeekToAction
  • 谷歌SEO快速参考指南

系统要求

  • Python 3.10+
  • Claude Code CLI
  • 可选Playwright用于截图
  • 可选谷歌API凭证用于获取丰富数据参见 /seo google setup

卸载

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.sh
一键卸载curl
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash

MCP集成

与MCP服务器集成以获取实时SEO数据包括来自 Ahrefs@ahrefs/mcp)和 Semrush 的官方服务器,以及用于 Google Search Console、PageSpeed Insights 和 DataForSEO 的社区服务器。参见 MCP集成指南 进行配置。

扩展

通过MCP服务器集成外部数据源的可选附加组件。

DataForSEO

实时SERP数据、关键词研究、外链、页面分析、内容分析、商业列表、AI可见性检查及LLM提及追踪。涵盖9个API模块共22条命令。

# 安装(需要 DataForSEO 账户)
./extensions/dataforseo/install.sh
# 示例命令
/seo dataforseo serp best coffee shops
/seo dataforseo keywords seo tools
/seo dataforseo backlinks example.com
/seo dataforseo ai-mentions your brand
/seo dataforseo ai-scrape your brand name

完整文档参见 DataForSEO扩展

BananaAI图片生成

使用 Claude Banana 创意总监流水线生成SEO图片OG预览图、博客封面、产品图、信息图

# 安装扩展
./extensions/banana/install.sh
# 示例命令
/seo image-gen og "Professional SaaS dashboard"
/seo image-gen hero "AI-powered content creation"
/seo image-gen batch "Product photography" 3

完整文档参见 Banana扩展。 已在使用独立版 Claude Banana该扩展会复用您现有的 nanobanana-mcp 配置。

生态系统

Claude SEO 是一套协同工作的 Claude Code 技能家族的核心组件:

技能 功能 协作方式
Claude SEO SEO分析、审计、Schema、GEO 核心——分析网站,生成行动计划
Claude Blog 博客撰写、优化、评分 配套——根据SEO发现撰写优化内容
Claude Banana 通过 Gemini 进行AI图片生成 共享——为SEO资产和博客文章生成图片
AI Marketing Claude 文案、邮件、社交、广告、漏斗、CRO 社区——基于SEO发现执行营销行动

工作流示例:

  1. /seo audit https://example.com — 识别内容缺口和技术问题
  2. /seo backlinks https://example.com — 分析外链情况和竞品差距
  3. /blog write "目标关键词" — 创作SEO优化博客文章
  4. /seo image-gen hero "博客主题" — 生成封面图banana扩展
  5. /seo geo https://example.com/blog/post — 优化AI引用

文档

许可证

MIT 许可证 - 详情参见 LICENSE

贡献

欢迎贡献!提交 PR 前请阅读 CONTRIBUTING.md


@AgriciDaniel 为 Claude Code 构建