qiaomu-seo

在 AI 编程助手日益普及的今天，大多数 SEO 工具仍停留在检查 Title 字符数、H1 标签数量或关键词密度的浅层阶段。qiaomu-seo是一个专为 Codex、Claude Code、Cursor 等兼容 Agent Skills 的工具设计的专业 SEO 智能体技能。

qiaomu-seo 不只是一个打分器，它模拟真实的搜索引擎工作链路：爬虫访问与 URL 发现 → 抓取与 JavaScript 渲染 → 可索引性 → Canonical/Hreflang → 页面相关性与搜索意图 → 内链与信息架构 → 搜索表现测量。通过这种深度诊断，它能解决从技术故障到流量下降的各类复杂问题。

核心能力：解决什么 SEO 难题？

1. 深度收录与索引诊断

当页面未被收录或收录异常时，qiaomu-seo 会层层排查：

• 检查 robots.txt、状态码、渲染结果、索引指令、Canonical 标签及 Sitemap。
• 结合 Search Console 证据，精准定位阻塞发生在哪一层（是爬虫进不来，还是引擎不索引）。

2. 自然流量下降归因

面对流量下滑，它能按页面、查询、国家、设备及时间切片进行多维分析，区分是技术故障、市场需求变化、内容衰退、站点迁移影响，还是数据统计口径问题。

3. 关键词策略与落地页映射

针对“有词无页”或“关键词内耗”问题，它通过研究搜索意图与主题关系，生成 keyword-to-page map、内容 Brief 以及页面新建/合并/改进建议，确保每个核心词都有精准的落地页承接。

4. 技术 SEO 落地修复

在获得明确授权后，它能直接修复代码层面的问题，包括：

• Canonical、Redirect、Sitemap、Robots 配置。
• Metadata、JSON-LD 结构化数据、Hreflang 多语言标签。
• 分页逻辑、内部链接结构及 JavaScript 渲染优化。

5. 站点迁移与国际化支持

• 迁移监控：建立 URL Inventory，生成重定向映射，检查 Canonical/Hreflang/Sitemap 的一致性，并提供上线监控与回滚方案。
• 大型站点审计：针对电商变体、分类筛选页、程序化页面及多语言信号进行抽样检查，评估实际覆盖率。

6. AI Search 可见性审计

区别于传统 SEO，qiaomu-seo 专门检查网站在 Google AI Overviews / AI Mode、ChatGPT Search、Copilot 与 Perplexity 中的基础可访问性。它清晰界定传统 SEO、模型训练与 AI 引用之间的边界，不混淆概念。

交付物：透明、可验证、不编造

qiaomu-seo 坚持专业边界，所有结论均标明是“直接观察”、“合理推断”还是“缺少证据”。它不编造搜索量、排名或竞品数据，也不承诺收录或排名。

快速安装与使用

qiaomu-seo 基于 Node.js 环境，通过 npx 一键安装到支持 Agent Skills 的客户端中。

前置条件：

• 已安装 Node.js (LTS 版本) 和 npm/npx。
• 使用支持 Agent Skills 的客户端（如 Codex, Claude Code, Cursor）。

安装命令：

npx skills add joeseesun/qiaomu-seo

确认安装：

npx skills add joeseesun/qiaomu-seo --list

常用指令示例：

• “抓取并渲染这个网站，找出为什么产品页没有进入 Google 索引。”
• “分析这份 Search Console 导出，按页面和查询定位过去 90 天自然流量下降的原因。”
• “修复这个 Next.js 项目的 canonical、sitemap、robots 和 Product JSON-LD，并验证渲染结果。”
• “分别检查 Google AI Overviews、ChatGPT Search 和 Perplexity 的抓取与可见性基础。”

专业边界与持续进化

qiaomu-seo 遵循严格的职业操守：

• 默认只读：审计与诊断模式下不修改任何线上数据或代码。
• 授权执行：仅在明确授权后进行代码修复，并保留完整的修改前证据、测试结果及回滚方案。
• 知识更新：定期复查 33 个来自 Google、Bing、Schema.org、OpenAI 等官方来源的规则，自动拦截陈旧断言，并区分不同 AI Crawler（如 OAI-SearchBot, GPTBot）的控制边界。