AGENT SKILL
seo-cwv
暂无简介
- License 许可
- MIT
- 所属仓库
- bonc-ai/cogseed
- 最近更新
- 2026-11-13
- Stars
- ★ 19
- Forks
- 10
01 前言 Front Matter
- name
- seo-cwv
- category
- data
- ownerAgent
- e064dca9e1bd
- description_en
- Fetch Core Web Vitals via Google PageSpeed Insights: LCP/CLS/INP/FCP and the performance score, separating CrUX real-user field data (Measured) from lab data (Estimated); emits performance-dimension findings; free, no OAuth; For: 'check this page's load performance', 'how are the Core Web Vitals / LCP'; Triggers: CWV, Core Web Vitals, LCP, CLS, INP, PageSpeed, performance, load speed
- description_zh
- 用 Google PageSpeed Insights 查核心网页指标(Core Web Vitals):LCP/CLS/INP/FCP 与性能分,区分 CrUX 真实用户字段数据(Measured)与实验室数据(Estimated),输出 performance 维度 findings;免费、无需 OAuth;适合"测一下这页的加载性能""看看 CWV/LCP 怎么样";触发词:CWV、核心网页指标、LCP、CLS、INP、PageSpeed、性能、加载速度
02 资源文件 9
- 参考文档artifact.yaml903 B
- 参考文档evals/evals.json261 B
- 参考文档references/business-ontology.yaml62 B
- 参考文档references/security-manifest.yaml2.8 KB
- 参考文档references/skill-spec.yaml464 B
- 参考文档references/validation-contract.yaml48 B
- 参考文档schemas.json40 B
- 脚本scripts/cwv.py7.8 KB
- 脚本test/test_cwv.py6.2 KB
03 SKILL.md 正文
seo-cwv
Measure Core Web Vitals with the free PageSpeed Insights API. Field data (CrUX, real users) is reported as Measured; lab (Lighthouse synthetic) as Estimated.
When to use
- The diagnose flow wants real performance / CWV signals (the other skills are HTML-only).
- Checking LCP/CLS/INP before/after a performance fix.
When NOT to use
- On-page HTML SEO (meta/headings/schema) — those skills cover it.
- Bulk auditing many URLs fast — keyless PSI is rate-limited (set a key).
Preconditions
- Network access to
googleapis.com(honors HTTP(S)_PROXY automatically). Optional free API key via--keyorCOGSEED_PAGESPEED_KEY(keyless works but is rate-limited). Python 3.9+ stdlib only. PSI is slow (synthetic run) — default timeout 60s.
How to call
"$COGSEED_NODE" "$COGSEED_PC_DIR/bin/run-skill.cjs" seo-cwv cwv -- <url> [--strategy mobile|desktop] [--key <k>] [--out <cwv.json>]
Expected output
{ "ok": true, "data": {
"strategy": "mobile", "performance_score": 42,
"lab": { "lcp_ms": 4100, "cls": 0.28, "tbt_ms": 600, "fcp_ms": 2100, "si_ms": 5000 },
"field": { "lcp_ms": 4200, "cls": 0.30, "inp_ms": 540, "fcp_ms": 2200, "overall_category": "SLOW", "has_field_data": true },
"findings": [ { "id": "lcp_poor", "dimension": "performance", "severity": "high",
"evidence": "...", "recommendation": "...", "leading_indicator": "...",
"failure_criterion": "...", "data_tier": "Measured" } ],
"summary": { "total": 1 }, "meta": { "url": "...", "field_data": true } } }
Findings use dimension: "performance" and feed seo-report --add. Failure: {"ok": false, "error": "..."} (e.g. PSI quota/error) on stderr, non-zero exit.
Thresholds (Google)
LCP good ≤2500ms / poor >4000ms · CLS good ≤0.10 / poor >0.25 · INP good ≤200ms / poor >500ms. Field (CrUX) is preferred and Measured; lab is the fallback and Estimated. INP comes from field only (lab has TBT as a proxy).
04 同仓库更多 Skills
sample-supply-chain
供应链样本:安装钩子 + 拼写伪装 + 源覆盖。
★ 19
sample-prose-only
纯散文安全守则样本:禁止某行为的说明不等于该行为。
★ 19
sample-obfuscated
混淆载荷样本:解码与执行共现。
★ 19
sample-hidden-content
隐藏内容载荷样本:用于回归「不可见字符不做上下文降权」这一不变量。
★ 19
sample-evasion
反规避样本:危险内容只以「不可见字符切断」与「编码后」两种形式出现。
★ 19
sample-agentic
代理运行时风险样本:配置篡改 + 隐蔽指令。
★ 19