SuperAPI AI 工具集

seo-freshness

营销与增长

查看项目

更新于 10-16 08:48

技能介绍

用途:审计页面的时效性(freshness)与时间信号,核对可见日期与结构化数据日期,评估内容相对主题波动性的陈旧程度。适用于 SEO 与 AI 答案引擎引用优化场景。

主要能力:检测页面上的 Published / Updated on / Last reviewed 等可见日期;解析 JSON-LD Article/BlogPosting/NewsArticle 中的 datePublished/dateModified;比对可见日期与 schema 日期是否一致;按主题波动性判断内容是否 stale;识别无实质内容变更的“updated on”反模式。

使用方式:基于 dispatch envelope 指定的 PageSnapshot,读取 <run_dir>/pages/<slug>.json 的 jsonld[]、metas[] 与 headers.last-modified,Grep HTML 取证;site 产物位于 <run_dir>/site/{robots.json,sitemaps.json,discovery.json}。audit.mjs 已产出的确定性 findings 不重复输出。若直接传入 URL/路径且无快照,先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs",使用打印出的快照路径。

修复分级:AUTO 可向现有 Article schema 注入缺失的 dateModified,禁止回填虚假日期,须用可验证的最后变更日期或明确 TODO 占位;PROPOSED 以草稿形式呈现可见与 schema 日期不一致的修正值,需逐项确认;ADVISORY 建议对陈旧且高波动页面做真实内容更新,工具不撰写编辑内容。

验证:dom_assert 检查可见日期存在且可解析并与 schema 匹配;schema_validator 检查 ISO 8601 有效且 dateModified >= datePublished;header_check 用 HTTP Last-Modified 佐证。实时层不可用时状态为 needs_api,不误报通过。

限制:时效性是上下文信号而非通用排名提升;仅改日期无真实内容变更可被检测且无持久价值;日期解析受语言限制,无法识别的格式报 M13.schema.date_unparseable,不虚构不一致。