webflow-schema 是一款面向 Webflow 网站的 JSON-LD 结构化数据技能，覆盖构建、修复与审计三类任务。
用途 该技能用于向 Webflow 站点添加或修正 JSON-LD 结构化数据，主要服务于 Collection 模板中的 schema 添加、schema 与 CMS 字段绑定，以及排查富媒体结果不显示等问题。它选择 Webflow 页面级 JSON-LD 字段（Page Settings，也可通过 Data API 写入）作为 schema 的存放位置，原因是该字段会进入服务器返回的 HTML，而大多数 AI 爬虫不执行 JavaScript。
主要能力 技能围绕两种工作架构展开：默认架构 A，将 CMS 字段直接绑定进 JSON-LD 字段，值由服务器渲染，不使用富文本；架构 B，当内容已渲染在页面上（如 FAQ 折叠面板）时，用客户端脚本读取 DOM 生成 schema，Google 可渲染，但多数 AI 爬虫看不到；架构 C，仅在站点已有 Cloudflare Worker 时，通过 HTMLRewriter 在边缘注入。技能明确说明了 Webflow 平台的两个限制：CMS 值绑定后被 HTML 转义，直撇号（'）渲染为 '、直双引号渲染为 "、& 渲染为 &，爬虫会把这些当成字面文本，解决方式是使用排版符号（如 ’）并将 & 拼写为“and”；RichText 字段绑定后返回空字符串，因此富文本永远不能用于模板绑定。静态页面中直接键入的文字不会被转义，上述限制只针对 {{wf ...}} 绑定。技能还要求写作时遵循硬性规则：发布留给人工并在对话中说明变更待发布；不编辑正文内容；不编造日期、作者、评分等事实，无法绑定就省略该属性；绑定结果必须在发布后抓取线上页面验证。写作上建议单个 script 块、单个 @context，所有节点放在 @graph 中，URL 使用规范主机名的绝对地址。
使用方式 快速流程为：先获取 site_id、确认规范主机名与 www 重定向、列出页面并定位 Collection 模板、读取模板与线上页面已有的 schema；选择架构；检查可绑定内容是否为 PlainText 等允许类型，且不含直撇号、直双引号和 &，可用 check_bindable_text.py 检查；写入一个 @graph；通过 API 写入时注意绑定 token 不带反斜杠；交付人工发布后用 audit_jsonld.py 审计多个线上页面。搜索参考文件可用 search_references.py，按标签、关键词或列出全部条目。
适用场景与限制 适用于 Webflow 站点上的博客文章、案例研究、索引页等页面的结构化数据构建与修复，以及线上 schema 审计。局限包括上述转义与富文本限制、客户端方案对多数 AI 爬虫不可见，以及发布必须由人工完成。项目以 MIT 许可证发布。部分具体细节（如 API 调用的完整参数、脚本的具体实现、各架构脚本的属性约定）在资料中以参考文档和脚本形式给出，此处暂未展开。