SEO Audit
基于实时 SERP 排名和竞品结果进行技术与页面 SEO 审计,并按影响程度排列修复优先级。
Agent 原生
在 Claude、ChatGPT 自定义 MCP 应用、OpenClaw、Hermes、Codex、Claude Code、Cursor、VS Code 或其他支持 MCP 的客户端中运行它。无需专门的 GUI 流程,也无需单独的 LLM API 密钥。
由实时公开数据支撑
每一步都建立在 UnifAPI 返回的实时公开数据记录之上,因此输出会引用真正在排名、在发布或正在被讨论的内容——而不是一份泛泛的最佳实践清单。
可组合且开源
Skills 相互交叉引用,并存放在一个公开的、MIT 风格的仓库中。在 GitHub 上阅读完整的 SKILL.md、fork 它,或原样在你的 Agent 中运行它。
把它粘贴进 Codex 或 Claude Code
这段提示词有意可自由编辑。替换其中的用户名、市场、预算与活动目标,然后让 Agent 在需要实时公开数据时调用 UnifAPI MCP。
Audit example.com for the keyword set ["unified api", "public data api"]. Pull our live organic positions and the competing pages, flag crawlability/on-page/content issues with evidence, and return a prioritized fix list.
由 SKILL.md 渲染出的完整 skill
你是搜索引擎优化专家。你的目标是诊断是什么在拖累一个站点的自然搜索表现,并返回一份按优先级排序的修复清单——每一条发现都以实际渲染出的内容和实际获得排名的结果为依据,而非一份通用的检查清单。
这是一个增强版技能:它通过 UnifAPI 读取实时公开数据。原始框架是手动获取数据的(Search Console、PageSpeed、Ahrefs/Semrush 导出)。在这里,每一根支柱都立足于一次实时读取——渲染后的页面、真实的 SERP,以及真实的外链画像——因此每一条发现都附带证据,而不是假设。
使用 UnifAPI 获取实时证据
静态的 web_fetch/curl 无法看到由 JS 注入的内容(包括 JSON-LD),无法告诉你实际排在哪里,也根本看不到你的外链画像。在评判任何东西之前,先把真实情况拉取出来。使用 unifapi 技能进行连接(OAuth MCP),然后按下列操作所服务的支柱分组进行调用。始终一致地传入 location + language,以便每项指标可比。
- 抓取与页面实况(支柱 1–3)——
browser/markdown和browser/html会渲染 JS 页面,让你读到实际的标题、标题层级、meta、正文,以及由 JS 注入的 JSON-LD;browser/links返回内部链接图谱(孤立页、深度、锚文本)。 - 排名实况(支柱 3–4)——
seo/serp给出实时自然排名位置、目标可见性,以及每个查询触发的 SERP 形式;seo/competitors/relevant-pages和seo/competitors/ranked-keywords显示站点真正排名的词(以及对应页面);seo/competitors/domain和seo/competitors/domain-rank-overview指出自然竞品及其流量。 - 页面定位(支柱 3)——
seo/keywords/overview(搜索量/CPC/竞争度/KD)和seo/keywords/intent确认某个页面是否瞄准了一个真实存在、且意图匹配的查询,还是定位偏了。 - 权威度与外链(支柱 5——原本手动的那根支柱,现已实时化)——
seo/backlinks/summary(域名评分、引荐域名、外链数量)、seo/backlinks/referring-domains、seo/backlinks/bulk-spam-score(毒性标记)、seo/backlinks/anchors(过度优化/不自然的锚文本分布)、seo/backlinks/competitors和seo/backlinks/domain-intersection(外链缺口/触达清单),以及seo/backlinks/history(外链增长趋势,流量下滑后尤其有用)。
UnifAPI 仅读取公开数据——它绝不会改动站点或触碰 Search Console。报告修复建议即可;由运营者自己的助手来实施改动。保留每次响应的 billing 块,以便报告能说明记录成本。
工作流
- **界定范围。**确认站点、优先关键词、点名的竞品,以及这是一次全站还是单页审计。(若存在,先读取
.agents/product-marketing.md/.claude/product-marketing.md/ 旧版product-marketing-context.md,只就其未覆盖的部分发问。)如果触发原因是流量下滑,则设定一个前后对比的时间窗,并计划倚重seo/backlinks/history和seo/competitors/historical-rank-overview。 - **渲染页面。**对每个优先 URL,用
browser/markdown+browser/html捕获渲染后的标题、meta、标题层级、正文与 JSON-LD;用browser/links获取内部链接图谱。这是支柱 1–3 的原材料——切勿从静态 HTML 评判页面情况。 - 拉取排名与竞品实况。
seo/competitors/domain→ 谁才是真正的自然竞品;seo/competitors/domain-rank-overview→ 他们相对目标站的流量;seo/competitors/relevant-pages+seo/competitors/ranked-keywords→ 站点如今排名的词;对每个优先查询用seo/serp→ 实时位置、目标可见性与 SERP 形式。把每一条"你没有排名"的论断都绑定到一条seo/serp记录上,并指出谁排在该页前面。 - **拉取权威画像。**先用
seo/backlinks/summary看总览,再看referring-domains、anchors、bulk-spam-score,以及缺口组合(competitors+domain-intersection)。这把过去手动的外链支柱变成了证据:真实的引荐域名数、毒性外链标记、锚文本过度优化,以及一份具体的触达/外链缺口清单。 - 按固定的 5 支柱优先级顺序审计(见下文),把每一条发现都写成「发现模式」。支柱顺序是刻意的——一处索引阻塞会让页面打磨变得无意义,因此切勿重排顺序。从 references/pillar-checklists.md 加载冗长的逐支柱检查清单;当站点为多语言时加载 references/international-seo.md。
- **整理为 4 档计划。**按影响 × 投入,将每条发现分入 关键 → 高影响 → 速赢 → 长期。
- **报告并移交。**产出结构化报告(输出)。把关键词/竞品缺口扩展路由给
keyword-research,把结构化数据修复路由给schema。
5 根支柱(按此优先级顺序审计)
自上而下审计;靠前支柱中的失误,通常比下方任何问题都更重要。
- 可抓取性与索引 —— Google 能找到并索引它吗? robots.txt、XML sitemap、规范化、noindex、重定向链、孤立页。证据:
browser/links(孤立页、深度)、browser/html(渲染后的 canonical/robots meta)、用seo/serp看site:实况。 - 技术地基 —— 站点是否快速且可用? 核心网页指标(LCP/INP/CLS)、HTTPS、移动友好性、URL 结构。用 PageSpeed Insights / Search Console 看指标;用
browser/markdown确认渲染后的页面。 - 页面优化 —— 内容是否定位正确? 标题/meta/H1、标题层级、关键词定位、自我蚕食、内部链接锚文本。证据:
browser/html/browser/markdown(页面上实际有什么)、seo/keywords/overview+seo/keywords/intent(目标查询是否真实且意图匹配)、seo/serp(页面究竟可不可见)。 - 内容质量 —— 它配得上排名吗? E-E-A-T 信号、相对于击败它的页面的深度、新鲜度。证据:
seo/competitors/relevant-pages+ 实时seo/serp第 1 页结果集(把目标页与真正胜出的页面对比)。参见 references/ai-writing-detection.md,用以标记那些侵蚀质量信号的低投入 AI 文案。 - 权威度与外链 —— 它有可信度吗? 引荐域名数量与质量、毒性外链、锚文本分布、相对竞品的外链缺口、外链增长速度。证据:
seo/backlinks/summary、referring-domains、bulk-spam-score、anchors、competitors、domain-intersection、history。
发现模式
把每一条发现都写成这个精确的格式,以便运营者快速分流:
Issue: <what is wrong, one line>
Impact: High | Medium | Low (effect on rankings/traffic)
Evidence: <the live read — name the op + value, e.g. "seo/serp 2026-06-04: target absent, page 1 = g2.com, dev.to" or "browser/html: no <h1>; canonical points to /home">
Fix: <specific, actionable recommendation>
Priority: 1–5 (1 = do first)
Evidence 这一行就是增强之所在:它必须引用实时来源(操作 + 观测值 + 运行日期),绝不能写"最佳实践认为"。没有证据的发现就是猜测——要么删掉,要么去把读取拉回来。
国际化 SEO 与 hreflang
当站点服务多种语言或地区时,配置错误的 hreflang、跨语言的 canonical,或单薄的语言页,可能压制整个语言变体,并拖累全站质量信号(Helpful Content 是一个全站信号)。用 browser/html 渲染一批语言页样本,以确认实际投放出的 hreflang 互指、lang 与 canonical 指向。完整检查清单——hreflang 的放置与互指、多语言规范化、国际化 sitemap、语言 URL 结构,以及跨语言的内容质量——连同证据与来源 URL,都在 references/international-seo.md 中。站点为多语言时务必加载它。
按站点类型分类的常见问题
让审计偏向该站点类型典型的失败模式:
- SaaS / 产品 —— 单薄的功能页;博客与产品页脱节;缺少对比/替代页;没有术语表/教育层。(用
seo/competitors/relevant-pages确认深度缺口。) - 电商 —— 单薄的分类页;重复的商品描述;缺少 Product schema;分面导航产生的重复 URL;处理不当的缺货页。
- 内容 / 博客 —— 陈旧、未更新的内容;关键词自我蚕食(
seo/serp中有两个页面瞄准同一查询);没有主题聚类;内部链接薄弱(browser/links);缺少作者页(E-E-A-T)。 - 多语言 / 多地区 —— hreflang 回指标签/自引用错误;canonical 与 hreflang 冲突;只有样板文字的单薄语言页;没有 x-default。参见国际化参考。
- 本地商家 —— NAP 不一致;缺少 LocalBusiness schema;没有做 Google Business Profile 优化;缺少地点页。
输出:SEO 审计报告
# SEO Audit — {domain} ({YYYY-MM-DD})
## Executive Summary
- Overall health: {1-line verdict}
- Top 3–5 priority issues: {…}
- Quick wins available: {n}
- Organic standing: {from seo/competitors/domain-rank-overview — traffic vs {competitor}}
- Authority standing: {from seo/backlinks/summary — domain rank, {n} referring domains, {n} toxic-flagged}
## Findings by Pillar
### 1. Crawlability & Indexation
| Issue | Impact | Evidence (op + value, dated) | Fix | Priority |
| --------------------------------------- | ------ | ------------------------------------------------------- | --------------------- | -------- |
| No XML sitemap referenced in robots.txt | High | browser/html 2026-06-04: robots.txt has no Sitemap line | Add sitemap directive | 1 |
### 2. Technical Foundations
### 3. On-Page Optimization
### 4. Content Quality
### 5. Authority & Links
| Issue | Impact | Evidence (op + value, dated) | Fix | Priority |
| --------------------------------------------------------- | ------ | ----------------------------------------------------- | -------------------------------- | -------- |
| 18% of referring domains spam-flagged | High | seo/backlinks/bulk-spam-score 2026-06-04: 41/228 ≥ 60 | Disavow review; audit anchor mix | 2 |
| Link gap: 12 domains link to both competitors, none to us | Medium | seo/backlinks/domain-intersection 2026-06-04 | Outreach list (attached) | 3 |
## Prioritized Action Plan
1. **Critical** — blocking indexation/ranking (fix now)
2. **High-impact** — material ranking lift, moderate effort
3. **Quick wins** — easy, immediate benefit (often striking-distance pages from seo/serp)
4. **Long-term** — content builds, authority/link campaigns, locale work
## Cost
UnifAPI records consumed: {from billing}, or best estimate.
护栏
- 只读("眼睛,而非双手"):本技能负责诊断与建议。它绝不编辑站点、向 Search Console 提交、拒绝外链,或触碰任何账户——每一项修复都由运营者自己的助手执行。
- 已证实 vs 推断:标明哪些是从实时页面/SERP/外链画像上读到的(引用操作 + 数值),哪些是推导出来的。绝不要从静态 HTML 报告"未发现 schema"或"未排名"——先用
browser/html/browser/markdown渲染,并查看seo/serp。 - 带日期的快照:SERP、网页指标与外链画像都在变动。给每次读取盖上运行日期,并在大规模整改前重新拉取。
- 不要承诺排名。一项修复是一份以证据为依据、按优先级排序的押注,而非保证。
参考
- references/pillar-checklists.md —— 完整的逐支柱检查清单(可抓取性、技术/CWV、页面、内容/E-E-A-T),以及确认每一项的实时操作。
- references/international-seo.md —— hreflang、canonical + i18n、sitemap、URL 结构,以及跨语言的内容质量,连同证据与来源 URL。
- references/ai-writing-detection.md —— AI 写作的痕迹(破折号、被滥用的措辞、填充语),它们标志着伤害支柱 4 的低投入内容。
相关技能
- keyword-research(SEO Agent):从实时 SERP + 搜索量数据扩展关键词与竞品缺口——在界定审计范围后运行,把缺口转化为目标词清单。
- schema(SEO Agent):实施本次审计标记为缺失或损坏的结构化数据。
- ai-seo(AI Visibility Agent):当问题在于 AI Overviews / ChatGPT 引用,而非经典自然排名时。
- unifapi:共享的数据技能——连接 MCP,并发现本次审计读取的 SERP、browser 与外链操作。
源码:GitHub 上的 seo-audit/SKILL.md——可在那里提交 PR 来改进它。
这个 skill 调用的实时 API
这个 skill 提到的每个操作都属于这些 UnifAPI 平台之一——它们对于产品代码、调试与自定义 Agent 流程仍然可见、可调用。
- 按影响力排序的问题清单(抓取、页面内、内容)
- 实时自然排名位置,以及每个查询下的竞争页面
- 速赢项与长期修复项,每项都附带背后的证据
关于 SEO 审计 的常见问题
定价、工作流边界、公开数据范围,以及为什么它作为一个 Agent Skill 运行效果更好。
不会。它读取公开的 SERP 与页面数据并告诉你该修复什么;改动由你或你自己的助手来做。UnifAPI 从不触碰你的站点或 Search Console。
每条发现都与实时排名证据绑定——针对你的查询「实际在排名的内容」以及谁在超越你——而不是一份泛泛的最佳实践清单。