mcpField
S
scraperapi-seo-audit

scraperapi-seo-audit

github.com/scraperapi营销与增长10101 次安装12 周前更新
代码仓库

关于 scraperapi-seo-audit

scraperapi-seo-audit 是一套使用实时 SERP 数据和网页抓取进行 SEO 审计的技能。它引导 Agent 收集证据、分析搜索可见度与页面信号,并输出可追溯的发现和健康评级。

主要功能

  1. 01实时 Google SERP 与新闻检查
  2. 02支持 JavaScript 渲染的页面抓取
  3. 03单页与全站审计模式
  4. 04竞争对手及页面内容对比
  5. 05附证据引用的报告与健康评级

适用场景

  1. 01检查页面的关键词排名
  2. 02审计网站收录与搜索可见度
  3. 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.json
references/
page-analysis.md
report-template.md
serp-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 审计请求:

  1. 确认缺失参数——开始前确认 URL、目标关键词、地理位置和审计范围(见下文“参数确认”)。
  2. 选择模式——单页审计(模式 A)或全站审计(模式 B)。
  3. 阶段 1——索引状态与 SERP 快照。
  4. 阶段 2——关键词可见度与 AI Overview 检查。
  5. 阶段 3——页面分析。
  6. 阶段 4——竞争对手差距分析。
  7. 阶段 5——品牌与新鲜度信号。
  8. 计算健康评级,并使用 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 中发现的问题严重程度确定。

评级标准
A0 个严重问题,≤ 2 个高优先级问题
B0 个严重问题,3–5 个高优先级问题
C1–2 个严重问题,或 6–10 个高优先级问题
D3–5 个严重问题,或 > 10 个高优先级问题
F> 5 个严重问题,或索引编入受阻

严重问题(每项都会影响评级):关键页面设置了 noindex、全站缺少标题标签、内容页面没有结构化数据、被 robots.txt 阻止。 高优先级问题(每项都会影响评级):标题长度不符合要求、标题重复、缺少元描述、没有 H1、完全没有内链、大量图片缺少替代文本。

在执行摘要中显著标出评级。


审计模式选择指南

用户说……模式
“审计我的网站” / “检查我的 SEO” / 仅提供域名全站(模式 B)
“为什么[特定页面]没有排名” / 提供完整 URL 路径单页(模式 A)
“我的流量下降了” / “我的 SEO 出了什么问题”全站(模式 B)
“如何针对[关键词]获得排名”单页(模式 A)——针对最相关的页面
“为什么我没有出现在 Google 上”全站(模式 B)
“检查我的主页 SEO” / “审查我的 /pricing 页面”单页(模式 A)

输出质量标准

  1. 每项发现都要附上来源。 写明发现每个问题的确切查询或 URL。“缺少标题标签”必须注明页面 URL 和确认该问题的工具调用。
  2. 报告每个关键词排名时,都要说明 AI Overview 的情况。 仅报告排名位置并不完整。务必说明是否存在 AI Overview;如果存在,还要列出其引用的域名。
  3. 每次 SERP 调用都要指定地理位置。 不注明正确国家/地区的排名结果会产生误导。请在报告标题中注明目标市场。
  4. 将测量结果与推断分开。 对于工具输出,使用“SERP 显示……”。对于解读,使用“这表明……”。切勿将推断表述为直接发现。
  5. 提出具体建议。 “将 /pricing 上的标题标签从 X 改为 Y”,而不是“改进标题标签”。每项建议都要注明页面和具体改动。
  6. 先给出执行摘要和健康评级。 许多用户只会阅读开头。第一部分必须说明评级、最重要的 3 个问题,以及影响最大的单项行动。
  7. 不在范围内的因素应列入“范围外说明”。 使用相应的外部工具标记:核心网页指标(实地数据)→ PageSpeed Insights / Search Console;抓取错误 / 覆盖率 → Search Console > Coverage;反向链接概况 → Ahrefs、Semrush 或 Moz;点击率 → Search Console > Performance;人工处罚 → Search Console > Manual Actions。
  8. 不要超出调用预算。 模式 A:约 8–12 次调用。模式 B:约 20–30 次调用。如果需要更多调用,请告知用户并询问如何确定优先级。

评论

支持 Markdown