mcpField
S
seo-audit-full

seo-audit-full

github.com/infrasity-labs营销与增长15090 次安装18 周前更新
代码仓库

关于 seo-audit-full

此 Skill 通过抓取网站页面、分派专项检查、汇总评分并生成报告和优先级行动计划，执行完整 SEO 审计，适用于评估技术、内容、性能、本地及 AI 搜索表现。

主要功能

  1. 01遵守 robots.txt 抓取最多 500 个页面
  2. 02分派不同 SEO 专项检查
  3. 03按审计类别评估网站健康度
  4. 04生成报告与优先级行动计划
  5. 05可选接入 Google 或 DataForSEO 数据

适用场景

  1. 01审查网站抓取与索引情况
  2. 02检查内容、结构化数据和页面性能
  3. 03评估本地 SEO 与 AI 搜索准备度
  4. 04结合可用外部数据对照审计结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill seo-audit-full

安装后在 Claude Code 中输入/seo-audit-full确认已加载。

详细介绍

全站 SEO 审计

流程

  1. 获取首页：使用 scripts/fetch_page.py 获取 HTML
  2. 识别业务类型：根据 SEO 编排器分析首页信号
  3. 爬取网站：沿内部链接爬取最多 500 个页面，并遵守 robots.txt
  4. 委派给子 Agent（如有；否则依次内联执行）：
    • seo-technical——robots.txt、站点地图、规范链接、Core Web Vitals、安全标头
    • seo-content——E-E-A-T、可读性、单薄内容、AI 引用就绪度
    • seo-schema——检测、验证、生成建议
    • seo-sitemap——结构分析、质量门槛、缺失页面
    • seo-performance——LCP、INP、CLS 测量
    • seo-visual——截图、移动端测试、首屏分析
    • seo-geo——AI 爬虫访问、llms.txt、可引用性、品牌提及信号
    • seo-local——GBP 信号、NAP 一致性、评价、本地结构化数据、行业特定的本地因素（检测到本地服务行业时启动：实体店、SAB 或混合业务类型）
    • seo-maps——地理网格排名跟踪、GBP 审计、评价情报、竞争对手半径范围映射（检测到本地服务且 DataForSEO MCP 可用时启动）
    • seo-google——CWV 实地数据（CrUX）、URL 索引状态（GSC）、自然流量（GA4）（通过 python scripts/google_auth.py --check 检测到 Google API 凭据时启动）
    • seo-backlinks——反向链接概况数据：DA/PA、引荐域名、锚文本、有害链接（通过 python scripts/backlinks_auth.py --check 检测到 Moz 或 Bing API 凭据时启动；或始终纳入 Common Crawl 域级指标）
    • seo-cluster——语义聚类分析（检测到内容策略信号时启动：博客、支柱页面、主题集群）
    • seo-sxo——搜索体验分析：页面类型不匹配、用户故事、用户画像评分（完整审计中始终纳入）
    • seo-drift——漂移分析：与存储的基线进行比较（通过 python scripts/drift_history.py <url> 确认存在该 URL 的漂移基线时启动）
    • seo-ecommerce——产品结构化数据、市场情报（检测到电子商务行业时启动）
  5. 评分——汇总为 SEO 健康评分（0–100）
  6. 报告——生成按优先级排序的行动计划

爬取配置

Max pages: 500
Respect robots.txt: Yes
Follow redirects: Yes (max 3 hops)
Timeout per page: 30 seconds
Concurrent requests: 5
Delay between requests: 1 second

输出文件

  • FULL-AUDIT-REPORT.md：全面的审计结果
  • ACTION-PLAN.md：按优先级排序的建议（关键 > 高 > 中 > 低）
  • screenshots/：桌面端和移动端截图（如有 Playwright）
  • PDF 报告（推荐）：使用 scripts/google_report.py --type full 生成专业的 A4 PDF。报告采用白色封面的企业风格，包含目录、执行摘要、图表（Lighthouse 仪表盘、查询柱状图、索引环形图）、指标卡片、阈值表、附带工作量预估的优先级建议，以及实施路线图。完成审计后，务必提供 PDF 生成选项。

评分权重

类别权重
技术 SEO22%
内容质量23%
页面 SEO20%
结构化数据10%
性能（CWV）10%
AI 搜索就绪度10%
图片5%

报告结构

执行摘要
  • SEO 整体健康评分（0–100）
  • 检测到的业务类型
  • 5 个最关键问题
  • 5 个最快可实现的改进
技术 SEO
  • 爬取性问题
  • 索引问题
  • 安全隐患
  • Core Web Vitals 状态
内容质量
  • E-E-A-T 评估
  • 单薄内容页面
  • 重复内容问题
  • 可读性评分
页面 SEO
  • 标题标签问题
  • 元描述问题
  • 标题层级结构
  • 内部链接缺口
结构化数据
  • 当前实现
  • 验证错误
  • 缺失的机会
性能
  • LCP、INP、CLS 评分
  • 资源优化需求
  • 第三方脚本的影响
图片
  • 缺少替代文本
  • 过大的图片
  • 格式建议
AI 搜索就绪度
  • 可引用性评分
  • 结构改进
  • 权威性信号

优先级定义

  • 严重：阻止索引或导致惩罚（立即修复）
  • 高：显著影响排名（1 周内修复）
  • 中：优化机会（1 个月内修复）
  • 低：锦上添花（列入待办事项）

DataForSEO 集成（可选）

如果 DataForSEO MCP 工具可用，则在现有子 Agent 旁启动 seo-dataforseo Agent，以便通过实时数据丰富审计结果：真实 SERP 排名、带垃圾评分的反向链接概况、页面分析（Lighthouse）、商家列表和 AI 可见度检查（ChatGPT 抓取器、LLM 提及情况）。

Google API 集成（可选）

如果已配置 Google API 凭据（python scripts/google_auth.py --check），则启动 seo-google Agent，以便通过真实的 Google 实地数据丰富审计结果：CrUX Core Web Vitals（替代仅基于实验室数据的估算）、GSC URL 索引状态、搜索效果（点击次数、展示次数、CTR）和 GA4 自然流量趋势。性能（CWV）类别评分最能从实地数据中受益。

错误处理

场景操作
URL 无法访问（DNS 失败、连接被拒绝）清楚地报告错误。不要猜测网站内容。建议用户核实 URL 后重试。
robots.txt 阻止抓取报告哪些路径被阻止。仅分析可访问的页面，并在报告中注明此限制。
速率限制（429 响应）暂停并减少并发请求。报告部分结果，并注明哪些部分未能完成。
大型网站超时（500+ 个页面）将抓取范围限制在超时上限内。报告已抓取页面的调查结果，并估算网站总规模。

评论

支持 Markdown