GitHubHelp

Sanjeever/seo-skill

基于 Google Search Central 官方中文文档提炼的结构化 SEO 技能，面向 Claude Code AI Agent 使用。覆盖技术 SEO 审计、抓取与索引排查、结构化数据、内容优化、电商 SEO、国际化、Search Console 诊断等完整工作流。

★ 0Forks 0PythonGitHub ↗Compare

README

SEO Skill

基于 Google Search Central 官方中文文档提炼的结构化 SEO 技能，面向 Claude Code AI Agent 使用。覆盖技术 SEO 审计、抓取与索引排查、结构化数据、内容优化、电商 SEO、国际化、Search Console 诊断等完整工作流。

目录结构

.claude/skills/seo/
├── SKILL.md                  # 主入口：8 个工作流 + 诊断框架 + 原则清单
└── references/
    ├── technical-seo.md              # robots.txt、sitemap、canonical、URL、meta、重定向、JS SEO
    ├── crawling-indexing.md          # Googlebot、移动端优先、网站迁移、A/B 测试、内容移除
    ├── content-search-appearance.md  # 内容质量、E-E-A-T、标题/摘要、图片/视频、Core Web Vitals
    ├── structured-data.md            # 35+ 种结构化数据类型、政策、实施、验证
    ├── ecommerce-international.md    # 电商 SEO、多语言/多区域、hreflang
    └── monitoring-debugging.md      # Search Console、流量下降、搜索运算符、安全监控

覆盖的工作流

工作流 说明
技术 SEO 审计 robots.txt → sitemap → canonical → HTTPS → 移动端 → Core Web Vitals
抓取与索引排查 noindex 误用、robots 冲突、JS 渲染、soft 404、站点地图加速
内容质量与页面优化 E-E-A-T 自评、标题/摘要/图片/视频优化、AI 内容合规
结构化数据规划与校验 页面类型匹配 → JSON-LD 实施 → 富媒体搜索结果测试 → SC 监控
搜索结果呈现优化 标题链接、摘要控制、网站图标/名称、站内链接、精选摘要
电商 SEO 检查 导航结构、商品 URL、分页、结构化数据、Merchant Center
国际化 hreflang/canonical URL 结构选择、hreflang 双向确认、x-default、常见错误
Search Console 诊断 流量下降原因定位、气泡图分析、GA 联合分析、安全监控
输出建议格式 优先级 + 证据 + 影响范围 + 建议改动 + 验证方法的标准化模板

安装使用

将 .claude/skills/seo 目录复制到你项目的 .claude/skills/ 下即可。Claude Code 会自动识别 SKILL.md 中的 frontmatter 并注册为可用 skill。

# 复制到你的项目
cp -r .claude/skills/seo /path/to/your-project/.claude/skills/seo

也可复制到用户级 skills 目录（所有项目可用）：

cp -r .claude/skills/seo ~/.claude/skills/seo

触发方式

在 Claude Code 中直接使用自然语言提问，包含 SEO 相关关键词即可自动触发该 skill。也支持显式调用：

/seo 帮我审计这个网站的技术 SEO

触发词覆盖：SEO、搜索引擎优化、Google Search、Search Console、抓取、索引、结构化数据、canonical、robots.txt、sitemap、hreflang、Core Web Vitals、rich results、ecommerce SEO 等。

构建方式

本 skill 的知识来源于 Google Search Central 中文文档。构建流程：

  1. 爬取 — uv run scrape_google_search_docs.py 从 Google Search Central 爬取全部约 130 篇中文文档到 docs/
  2. 提炼 — AI Agent 系统性阅读所有文档，按主题归纳、合并、去重，将规则抽象为可执行的检查项和工作流
  3. 输出 — 写入 .claude/skills/seo/，内容为提炼后的知识，不依赖原始 docs/ 文件

设计原则

  • 面向 Agent，而非人类 — 内容是可执行的诊断流程和检查清单，不是百科式笔记
  • 不照搬原文 — 将分散在多处的规则归纳合并，用 AI Agent 能直接使用的格式重组
  • 自包含 — skill 不依赖 docs/ 原文件，不引用外部路径
  • KISS — 无脚本、无复杂工具，纯粹的专业知识和工作流

开源协议

MIT

贡献

欢迎提交 Issue 和 Pull Request。贡献方向包括：

  • 补充 Google 文档更新后新增的内容
  • 完善工作流的诊断步骤
  • 修正事实性错误或过时信息
  • 新增专项工作流（如新闻 SEO、视频 SEO 深度指南）

Contributors

Sanjeever

Issues