SuperAPI AI 工具集

seo-drift

营销与增长

查看项目

更新于 10-15 16:43

技能介绍

用途:为页面SEO关键元素建立“已知良好”基线快照,之后对比当前状态以发现回归和漂移,并保留变化历史。适合部署前后检查、持续监控以及排查流量下滑。

主要能力:基线记录标题、meta 描述、canonical、robots 指令、H1/H2/H3、JSON-LD schema、Open Graph、Core Web Vitals、HTTP 状态码、HTML 与 schema 的 SHA-256 哈希。对比引擎内置 17 条规则、分 CRITICAL/WARNING/INFO 三级严重度,触发后给出建议动作,并可跨技能推荐(如 schema、technical、page、content 等)。

使用方式:命令行使用 /seo drift baseline <url>、/seo drift compare <url>、/seo drift history <url>。脚本执行形如 python scripts/drift_baseline.py <url>(可加 --skip-cwv),compare 可用 --baseline-id 指定基线,history 可用 --limit 限制条数;对比后可用 python scripts/drift_report.py <comparison_json_file> --output drift-report.html 生成 HTML 报告。

数据与存储:所有数据保存在本地 SQLite ~/.cache/codex-seo/drift/baselines.db,含 baselines 与 comparisons 两表;URL 会做规范化以保证匹配一致。

限制与说明:页面不可达时会上报错误而不猜测状态;无基线时需先建基线;SSRF 校验会拒绝私网地址且不可绕过;无 API key 时 CWV 字段存 null 并跳过 CWV 规则;4xx/5xx 仍可作为基线采集。抓取统一走 fetch_page.py,所有查询使用参数化占位符,TLS 始终校验。具体对 SEO 排名的实际效果、收费与价格信息暂未提供。