关于 scraperapi-seo-audit
scraperapi-seo-audit 是一套使用实时 SERP 数据和网页抓取进行 SEO 审计的技能。它引导 Agent 收集证据、分析搜索可见度与页面信号,并输出可追溯的发现和健康评级。
主要功能
- 01实时 Google SERP 与新闻检查
- 02支持 JavaScript 渲染的页面抓取
- 03单页与全站审计模式
- 04竞争对手及页面内容对比
- 05附证据引用的报告与健康评级
适用场景
- 01检查页面的关键词排名
- 02审计网站收录与搜索可见度
- 03比较排名页面并发现内容差距
MCP 相关
该技能使用 ScraperAPI MCP 工具查询 Google 搜索结果和新闻,并抓取网页。它要求 Agent 调用这些工具并引用其输出。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ scraperapi/ scraperapi-skills --skill scraperapi-seo-audit安装后在 Claude Code 中输入/scraperapi-seo-audit确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsonreferences/page-analysis.mdreport-template.mdserp-playbook.md详细介绍
ScraperAPI SEO 审计
由 ScraperAPI 的实时 SERP 和抓取工具提供支持的实时 SEO 分析。无需安装命令行工具或设置 API 密钥——这些工具已连接。采用由外向内的方法:先了解 Google 实际展示的内容,再抓取网页以解释原因。
你——Claude——直接执行工具调用。 不要为用户生成代码,也不要解释他们如何自行运行这些调用。调用 MCP 工具、读取结果并报告发现。用户需要的是 SEO 审计,而不是操作说明。
切勿编造发现。 每项发现都必须引用支持它的确切工具调用和输出。如果这些工具无法测量某项内容,请如实说明,并指出合适的外部工具。
可用的 MCP 工具
| 工具 | 返回内容 |
|---|---|
mcp__ScraperAPIRemote__google_search | 实时结构化 SERP——自然搜索排名、精选摘要、「其他人也在问」、AI Overview 是否出现、知识面板、附加链接。返回经过解析的 JSON,而非原始 HTML。通过 countryCode 和 gl 参数支持地理定位。 |
mcp__ScraperAPIRemote__scrape | 启用 JS 渲染的完整网页内容——使用 outputFormat: "markdown" 提取内容并统计字数,使用 outputFormat: "html" 检查 schema 标记、元标签和规范链接 |
mcp__ScraperAPIRemote__google_news | 品牌和主题提及的时效性——有助于评估 E-E-A-T 和内容新鲜度信号 |
scrape 的渲染指南
调用 mcp__ScraperAPIRemote__scrape 时,对于需要 JavaScript 才能显示内容的网页,请设置 render=true 和 premium=true——例如 React/Next.js 应用、SPA,以及使用客户端渲染的 Webflow 网站。对于静态 HTML,请使用标准模式(不设置渲染标记):例如 WordPress 网站、GitHub 和新闻文章。如果返回的 HTML 中 <head> 为空或缺少正文内容,请升级为 render=true, premium=true 并重试。
核心工作流
对于每项 SEO 审计请求:
- 确认缺失参数——开始前确认 URL、目标关键词、地理位置和审计范围(见下文“参数确认”)。
- 选择模式——单页审计(模式 A)或全站审计(模式 B)。
- 阶段 1——索引状态与 SERP 快照。
- 阶段 2——关键词可见度与 AI Overview 检查。
- 阶段 3——页面分析。
- 阶段 4——竞争对手差距分析。
- 阶段 5——品牌与新鲜度信号。
- 计算健康评级,并使用
references/report-template.md撰写报告。
数据收集规则
- 并行处理——在每个阶段中,于单次响应中发起所有工具调用。切勿依次循环处理各个网页或关键词。
- 提高效率——模式 A 的目标是约 8–12 次工具调用,模式 B 的目标是约 20–30 次。如果需要更多调用,请告知用户并询问如何确定优先级。
- 始终进行地理定位——每次
google_search调用都要传入用户目标市场对应的countryCode和gl。默认使用美国;开始前务必确认地理位置。 - 处理渲染失败——如果网页返回空内容或内容极少,请使用
render=true, premium=true重试一次。在报告中注明升级渲染的情况。 - 引用每项发现——注明确切的查询词或 URL。用户必须能够追溯每项结论所依据的工具调用。
- 为每份报告标注日期——加入“审计日期:[日期]”,让用户了解数据的新鲜度。
参数探查
检查用户的请求,确认以下四项参数。将所有不明确的参数放在一条消息中询问,切勿逐项询问。先根据上下文推断能确定的信息,再提出问题。
| 参数 | 未指定时的默认值 | 何时询问 |
|---|---|---|
| 网站 URL | — | 始终询问,除非用户已提供 |
| 目标关键词 | 抓取首页内容后推断 | 继续操作前,确认推断出的关键词 |
| 目标市场/地区 | 美国 | 始终询问——英国网站在 google.com 上的排名毫无参考价值 |
| 审计范围 | 纯域名时使用模式 B(全站);完整 URL 路径时使用模式 A(单页) | 仅在确实存在歧义时询问 |
审计模式
1. 单页审计(模式 A)
适用情况:用户提供了具体 URL,询问特定页面为何没有排名,或提出了有关某个页面 SEO 表现的具体问题。约需 8–12 次工具调用。
数据收集:
# Stage 1: Indexation check (run in parallel)
mcp__ScraperAPIRemote__google_search query="site:[domain]" countryCode="[cc]" gl="[cc]"
mcp__ScraperAPIRemote__google_search query='"[Brand Name]"'
# Stage 2: Keyword visibility — one per target keyword (run in parallel)
mcp__ScraperAPIRemote__google_search query="[target keyword 1]" countryCode="[cc]" gl="[cc]"
mcp__ScraperAPIRemote__google_search query="[target keyword 2]" countryCode="[cc]" gl="[cc]"
# Stage 3: On-page analysis — target page + homepage (run in parallel)
mcp__ScraperAPIRemote__scrape url="[target-page-url]" outputFormat="html"
mcp__ScraperAPIRemote__scrape url="[target-page-url]" outputFormat="markdown"
mcp__ScraperAPIRemote__scrape url="[homepage-url]" outputFormat="html"
# Stage 4: Top 2 competitors surfaced in Stage 2 (run in parallel)
mcp__ScraperAPIRemote__scrape url="[competitor-1-url]" outputFormat="html"
mcp__ScraperAPIRemote__scrape url="[competitor-2-url]" outputFormat="html"
# Stage 5: Brand freshness signals
mcp__ScraperAPIRemote__google_news query='"[Brand Name]"'
分析:运行下方的全部五个审计阶段。重点深入分析目标页面及其直接竞争对手。
输出格式:使用 references/report-template.md。根据单页审计范围调整各部分的详略程度。包含健康等级。
2. 全站审计(模式 B)
适用情况:用户提供了纯域名,或表示“审计我的网站”。抽查首页,以及根据首页导航推断出的最多 7 个重要页面。约需 20–30 次工具调用。
数据收集:
# Stage 1: Indexation check (run in parallel)
mcp__ScraperAPIRemote__google_search query="site:[domain]" countryCode="[cc]" gl="[cc]"
mcp__ScraperAPIRemote__google_search query='"[Brand Name]"'
mcp__ScraperAPIRemote__google_search query="[Brand Name]"
# Stage 2: Keyword visibility (run in parallel, one per keyword)
mcp__ScraperAPIRemote__google_search query="[target keyword 1]" countryCode="[cc]" gl="[cc]"
mcp__ScraperAPIRemote__google_search query="[target keyword 2]" countryCode="[cc]" gl="[cc]"
mcp__ScraperAPIRemote__google_search query="[target keyword 3]" countryCode="[cc]" gl="[cc]"
# Stage 3: On-page analysis — homepage + up to 7 key pages (run in parallel)
# Infer key pages from homepage navigation links
mcp__ScraperAPIRemote__scrape url="[homepage-url]" outputFormat="html"
mcp__ScraperAPIRemote__scrape url="[page-2-url]" outputFormat="html"
mcp__ScraperAPIRemote__scrape url="[page-3-url]" outputFormat="html"
# ... (up to 8 pages total)
# Follow with markdown for content depth assessment on highest-priority pages:
mcp__ScraperAPIRemote__scrape url="[priority-page-url]" outputFormat="markdown"
# Stage 4: Top 2–3 competitors per keyword (run in parallel)
mcp__ScraperAPIRemote__scrape url="[competitor-1-url]" outputFormat="html"
mcp__ScraperAPIRemote__scrape url="[competitor-2-url]" outputFormat="html"
mcp__ScraperAPIRemote__scrape url="[competitor-3-url]" outputFormat="html"
# Stage 5: Brand freshness signals
mcp__ScraperAPIRemote__google_news query='"[Brand Name]"'
分析:针对所有抽查页面,以完整深度运行下方的全部五个审计阶段。
输出格式:使用 references/report-template.md。五个阶段的所有部分均采用完整详略程度。包含健康等级。
审计阶段
这五个阶段适用于两种模式。按顺序执行,并在每个阶段内并行执行所有调用。
阶段 1 — 收录情况与 SERP 快照
解答的问题:“Google 知道该网站存在吗?它看到了什么?”
从 site: 结果中提取:大致的已收录页面数量、是否存在站点链接,以及索引中是否出现意外 URL(暂存域名、带 UTM 参数的 URL、重复内容信号)。从品牌搜索结果中提取:是否存在知识面板,以及品牌相关的 SERP 功能。
注意:site: 结果中的数量是 Google 显示的估算值,仅供参考。准确的覆盖率数据需要 Google Search Console。报告发现时务必说明这一点。
阅读 references/serp-playbook.md,了解准确的查询模式和提取字段。
阶段 2 — 关键词可见度与 AI Overview 检查
解答的问题:“该网站实际出现在哪些位置?Google 在它上方显示了什么?”
针对每个目标关键词,提取:自然搜索排名和对应 URL、SERP 中显示的标题标签、精选摘要(域名和格式)、“其他人还问了”中的问题(前 3–4 个),以及 AI Overview 是否出现(是/否——若是,记录被引用为来源的域名)。
每个关键词的第一项发现必须报告 AI Overview。 网站排名第 1,但位于占据整个视口的 AI Overview 下方,与在没有 AI Overview 的 SERP 中排名第 1,处境有本质区别。报告排名时,绝不能忽略 AI Overview 的背景信息。
如果网站排名在第 10 位之后,在将其归类为“未排名”之前,先搜索第 2–3 页(start: 10、start: 20)。提取每个关键词的前 3 个自然搜索竞争对手(排除 Wikipedia/Reddit,除非它们持续排在目标网站前面)——这些信息将用于阶段 4。
阅读 references/serp-playbook.md,了解提取字段和地理定位参数。
阶段 3 — 页面分析
回答的问题:“Google 正在从这些页面读取哪些信号?”
使用 outputFormat: "html" 抓取每个目标页面,以便精确提取信号;然后使用 outputFormat: "markdown" 分析内容深度。对每个页面提取并评估:标题标签(是否存在、是否包含关键词、长度是否为 50–60 个字符、是否在全站唯一)、元描述(是否存在、是否具有吸引力、长度是否为 150–160 个字符)、H1(是否恰好有一个、是否包含关键词、是否符合搜索意图)、H2/H3 层级(是否合乎逻辑、是否覆盖竞争对手排名靠前的子主题)、结构化数据标记类型(<script type="application/ld+json">)、内链、图片替代文本、大致字数。
完整的提取检查清单请参阅 references/page-analysis.md。
阶段 4 — 竞争对手差距分析
回答的问题:“排名靠前的页面做了什么,而这个网站没有做到?”
对每个关键词,选取阶段 2 中排名靠前的 2–3 个竞争对手。使用阶段 3 中的相同检查清单抓取这些页面。对比:使用的结构化数据类型、H2 主题覆盖范围、内容深度(字数)、占据的 SERP 特性(精选摘要、PAA)。标记所有排名靠前的页面都出现的规律——这些是信号最强的差距,因为这反映了 Google 针对该搜索意图反复给予奖励的内容。
阶段 5 — 品牌与新鲜度信号
回答的问题:“Google 有理由信任这个网站吗?”
使用品牌名称运行 google_news(最近 3 个月)。记录提及次数和来源质量。检查主页是否有作者简介、关于页面、专业性信号,以及页面内容中可见的最后修改日期。
注意:无法使用这些工具衡量反向链接权威性。如果审计发现页面 SEO 良好但排名不佳,应指出反向链接可能是限制因素,并推荐使用 Ahrefs/Semrush。
健康评级
完成全部五个阶段后计算。评级根据阶段 1–4 中发现的问题严重程度确定。
| 评级 | 标准 |
|---|---|
| A | 0 个严重问题,≤ 2 个高优先级问题 |
| B | 0 个严重问题,3–5 个高优先级问题 |
| C | 1–2 个严重问题,或 6–10 个高优先级问题 |
| D | 3–5 个严重问题,或 > 10 个高优先级问题 |
| F | > 5 个严重问题,或索引编入受阻 |
严重问题(每项都会影响评级):关键页面设置了 noindex、全站缺少标题标签、内容页面没有结构化数据、被 robots.txt 阻止。
高优先级问题(每项都会影响评级):标题长度不符合要求、标题重复、缺少元描述、没有 H1、完全没有内链、大量图片缺少替代文本。
在执行摘要中显著标出评级。
审计模式选择指南
| 用户说…… | 模式 |
|---|---|
| “审计我的网站” / “检查我的 SEO” / 仅提供域名 | 全站(模式 B) |
| “为什么[特定页面]没有排名” / 提供完整 URL 路径 | 单页(模式 A) |
| “我的流量下降了” / “我的 SEO 出了什么问题” | 全站(模式 B) |
| “如何针对[关键词]获得排名” | 单页(模式 A)——针对最相关的页面 |
| “为什么我没有出现在 Google 上” | 全站(模式 B) |
| “检查我的主页 SEO” / “审查我的 /pricing 页面” | 单页(模式 A) |
输出质量标准
- 每项发现都要附上来源。 写明发现每个问题的确切查询或 URL。“缺少标题标签”必须注明页面 URL 和确认该问题的工具调用。
- 报告每个关键词排名时,都要说明 AI Overview 的情况。 仅报告排名位置并不完整。务必说明是否存在 AI Overview;如果存在,还要列出其引用的域名。
- 每次 SERP 调用都要指定地理位置。 不注明正确国家/地区的排名结果会产生误导。请在报告标题中注明目标市场。
- 将测量结果与推断分开。 对于工具输出,使用“SERP 显示……”。对于解读,使用“这表明……”。切勿将推断表述为直接发现。
- 提出具体建议。 “将 /pricing 上的标题标签从 X 改为 Y”,而不是“改进标题标签”。每项建议都要注明页面和具体改动。
- 先给出执行摘要和健康评级。 许多用户只会阅读开头。第一部分必须说明评级、最重要的 3 个问题,以及影响最大的单项行动。
- 不在范围内的因素应列入“范围外说明”。 使用相应的外部工具标记:核心网页指标(实地数据)→ PageSpeed Insights / Search Console;抓取错误 / 覆盖率 → Search Console > Coverage;反向链接概况 → Ahrefs、Semrush 或 Moz;点击率 → Search Console > Performance;人工处罚 → Search Console > Manual Actions。
- 不要超出调用预算。 模式 A:约 8–12 次调用。模式 B:约 20–30 次调用。如果需要更多调用,请告知用户并询问如何确定优先级。