SuperAPI AI 工具集

seo-core-web-vitals

营销与增长

查看项目

更新于 10-16 08:48

技能介绍

用途:审计 Core Web Vitals(LCP、INP、CLS)与页面性能,基于 PageSnapshot 分析,并区分实验室数据与真实用户字段数据。

主要能力:按 p75 字段阈值判定(LCP≤2.5s、INP≤200ms、CLS≤0.1,三者全过才算 good),并用预警阈值(LCP>2.0s、INP>160ms、CLS>0.08)提前告警;识别渲染阻塞资源(head 中同步 script、阻塞样式表、@import 链);识别未优化图片(缺 width/height、无懒加载、无 srcset/sizes、未预加载 LCP 图);识别布局偏移来源(未预留尺寸、字体 swap、上方注入内容);对 LCP 做 TTFB、资源加载延迟、加载时长、渲染延迟的分解归因。

使用方式:从 dispatch 指定的 PageSnapshot 读取 pages/<slug>.json 与 HTML 证据;确定性发现已由 audit.mjs 输出,不重复上报。直接传入 URL 且无快照时先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs"。字段验证用 node "${CLAUDE_PLUGIN_ROOT}/scripts/psi-client.mjs" --url <final_url> [--strategy mobile|desktop] [--timeout 60000],密钥来自环境变量 CLAUDE_PLUGIN_OPTION_PSI_API_KEY 或 PSI_API_KEY,无 --key 参数;无密钥时返回 status: "needs_api" 且退出码为 0,需按 status 分支判断。

适用场景:SEO 性能审计、模板级性能问题定位与修复优先级排序。

限制:修复仅为建议(fixable: advisory),不自动编辑性能代码;无字段数据时不得编造数值,应请求 PSI/CrUX 密钥或留 TODO;实验室数据不能当作字段结果;本工具未实现 CrUX History,不能声称 p75 趋势;字段 CWV 严重度最高为 4,是平局决胜信号而非资格门槛。