增强 · 实时数据SEO Agent

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 如何运作

由 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 块,以便报告能说明记录成本。

工作流

  1. **界定范围。**确认站点、优先关键词、点名的竞品,以及这是一次全站还是单页审计。(若存在,先读取 .agents/product-marketing.md / .claude/product-marketing.md / 旧版 product-marketing-context.md,只就其未覆盖的部分发问。)如果触发原因是流量下滑,则设定一个前后对比的时间窗,并计划倚重 seo/backlinks/history 和 seo/competitors/historical-rank-overview。
  2. **渲染页面。**对每个优先 URL,用 browser/markdown + browser/html 捕获渲染后的标题、meta、标题层级、正文与 JSON-LD;用 browser/links 获取内部链接图谱。这是支柱 1–3 的原材料——切勿从静态 HTML 评判页面情况。
  3. 拉取排名与竞品实况。seo/competitors/domain → 谁才是真正的自然竞品;seo/competitors/domain-rank-overview → 他们相对目标站的流量;seo/competitors/relevant-pages + seo/competitors/ranked-keywords → 站点如今排名的词;对每个优先查询用 seo/serp → 实时位置、目标可见性与 SERP 形式。把每一条"你没有排名"的论断都绑定到一条 seo/serp 记录上,并指出谁排在该页前面。
  4. **拉取权威画像。**先用 seo/backlinks/summary 看总览,再看 referring-domains、anchors、bulk-spam-score,以及缺口组合(competitors + domain-intersection)。这把过去手动的外链支柱变成了证据:真实的引荐域名数、毒性外链标记、锚文本过度优化,以及一份具体的触达/外链缺口清单。
  5. 按固定的 5 支柱优先级顺序审计(见下文),把每一条发现都写成「发现模式」。支柱顺序是刻意的——一处索引阻塞会让页面打磨变得无意义,因此切勿重排顺序。从 references/pillar-checklists.md 加载冗长的逐支柱检查清单;当站点为多语言时加载 references/international-seo.md。
  6. **整理为 4 档计划。**按影响 × 投入,将每条发现分入 关键 → 高影响 → 速赢 → 长期。
  7. **报告并移交。**产出结构化报告(输出)。把关键词/竞品缺口扩展路由给 keyword-research,把结构化数据修复路由给 schema。

5 根支柱(按此优先级顺序审计)

自上而下审计;靠前支柱中的失误,通常比下方任何问题都更重要。

  1. 可抓取性与索引 —— Google 能找到并索引它吗? robots.txt、XML sitemap、规范化、noindex、重定向链、孤立页。证据:browser/links(孤立页、深度)、browser/html(渲染后的 canonical/robots meta)、用 seo/serp 看 site: 实况。
  2. 技术地基 —— 站点是否快速且可用? 核心网页指标(LCP/INP/CLS)、HTTPS、移动友好性、URL 结构。用 PageSpeed Insights / Search Console 看指标;用 browser/markdown 确认渲染后的页面。
  3. 页面优化 —— 内容是否定位正确? 标题/meta/H1、标题层级、关键词定位、自我蚕食、内部链接锚文本。证据:browser/html/browser/markdown(页面上实际有什么)、seo/keywords/overview + seo/keywords/intent(目标查询是否真实且意图匹配)、seo/serp(页面究竟可不可见)。
  4. 内容质量 —— 它配得上排名吗? E-E-A-T 信号、相对于击败它的页面的深度、新鲜度。证据:seo/competitors/relevant-pages + 实时 seo/serp 第 1 页结果集(把目标页与真正胜出的页面对比)。参见 references/ai-writing-detection.md,用以标记那些侵蚀质量信号的低投入 AI 文案。
  5. 权威度与外链 —— 它有可信度吗? 引荐域名数量与质量、毒性外链、锚文本分布、相对竞品的外链缺口、外链增长速度。证据: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 流程仍然可见、可调用。

  • 按影响力排序的问题清单(抓取、页面内、内容)
  • 实时自然排名位置,以及每个查询下的竞争页面
  • 速赢项与长期修复项,每项都附带背后的证据
相关 skills

SEO Agent 中的更多 skills

在同一个 Agent 中把它们串联起来,从一个决策成果走向下一个——每个都有各自的运行提示词、工作流与预期输出。

SEO 修复

把实时 SEO 审计证据转化为按优先级排序的修复项、负责人与验收检查。

打开 SEO 修复

关键词调研

从实时 SERP 与搜索量数据出发,把一份种子清单转化为排序后的关键词机会与竞品空白。

打开 关键词调研

Schema

为某个页面选择并实现正确的 schema.org 类型,并附上助手可写入的有效 JSON-LD。

打开 Schema
查看 SEO Agent 中的每一个 skill
FAQ

关于 SEO 审计 的常见问题

定价、工作流边界、公开数据范围,以及为什么它作为一个 Agent Skill 运行效果更好。

不会。它读取公开的 SERP 与页面数据并告诉你该修复什么;改动由你或你自己的助手来做。UnifAPI 从不触碰你的站点或 Search Console。

每条发现都与实时排名证据绑定——针对你的查询「实际在排名的内容」以及谁在超越你——而不是一份泛泛的最佳实践清单。