mcpField
S
seo-performance

seo-performance

github.com/agricidaniel营销与增长88574 次安装1 周前更新
代码仓库

关于 seo-performance

seo-performance 是用于完整 SEO 审核的性能分析技能，面向需要评估网页速度的工作流。它优先使用 PageSpeed Insights / CrUX 的真实用户数据，并在数据不可用时采用标注清晰的实验室数据或启发式分析。

主要功能

  1. 01检查 Lighthouse 移动端与桌面端评分
  2. 02测量 LCP、CLS 和可用的 INP
  3. 03缺少 INP 时报告 TBT 实验室代理值
  4. 04无 API 数据时提供回退说明
  5. 05输出审核报告与 JSON 摘要
  6. 06将结果写入共享缓存

适用场景

  1. 01审核网页核心性能指标
  2. 02在真实用户数据不可用时检查实验室数据
  3. 03为性能问题分配优先级

安装

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

$npx skills add https://github.com/agricidaniel/codex-seo --skill seo-performance

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

详细介绍

性能专家

用于完整审计中的性能子项。

共享数据缓存

步骤 0——检查共享数据缓存：

开始收集数据前，检查 .seo-cache/ 中是否有其他技能缓存的数据。 参考：../seo/references/shared-data-cache.md，了解架构和依赖关系图。

此专家在运行新的性能检查前，不需要上游缓存输入。

  • 如果找到：无需满足前置缓存要求；继续进行当前测量
  • 如果未找到：按正常流程继续，收集新的性能数据
  • 如果用户说“refresh”或“re-run”：完全忽略缓存

输入

  • URL
  • 超时
  • 可选的 PageSpeed API 密钥（PAGESPEED_API_KEY）

执行路径

在 API／无头环境中，优先运行 scripts/analyze_performance.py，以进行确定性的性能分析。该脚本会在可用时使用 PageSpeed 数据，否则会回退到明确标注的启发式数据，确保流程无需人工介入也能完成。

输出

  • PERFORMANCE-AUDIT-REPORT.md
  • SUMMARY.json

核心检查

  • 尽可能优先使用 PageSpeed Insights／CrUX 的真实用户 CWV 数据
  • 如果没有真实用户数据，则回退到 Lighthouse 实验室数据，并明确标注为实验室数据
  • Lighthouse 性能评分（如有，包含移动端和桌面端）
  • LCP 和 CLS 测量值
  • 仅当数据源实际提供 INP 时才报告；不得伪造 INP，也不得根据 TBT 推断 INP
  • 如果没有 INP，可将 TBT 作为实验室代理指标报告
  • API 数据不可用、配额受限或未通过身份验证时的备用指引

优先级规则

  • 高：性能评分 < 70，或 LCP > 2500ms，或 INP > 200ms，或 CLS > 0.1
  • 中：性能评分 70-79
  • 低：数据源限制

写入共享数据缓存

完成所有工作后，将结果写入 .seo-cache/。

mkdir -p .seo-cache/pages/{url-slug}

按照 ../seo/references/shared-data-cache.md 中的架构，将结果写入 .seo-cache/pages/{url-slug}/performance.json。 至少要符合文档规定的缓存键：core_web_vitals 和 issues。仅当不会替代或重命名文档规定的键时，才可添加其他有用字段。

如果 .gitignore 中尚无 .seo-cache/，则添加该条目：

grep -qxF '.seo-cache/' .gitignore 2>/dev/null || echo '.seo-cache/' >> .gitignore
高级交付物

如果用户要求“client report”或“premium deliverable”，则自动读取 ../seo-audit/assets/report-template.html 和 ../seo/references/premium-report-standard.md。默认以该报告标准作为任务要求。生成 HTML 作为内部中间产物，然后生成 PDF 作为对外交付物。除非用户明确要求 HTML 文件，否则最终回复中只提及 PDF。

评论

支持 Markdown