技能介绍

它解决什么问题

当你用脚本管理 Webflow 站点时，有几件重复且琐碎的事绕不开：想查清手上有哪些站点，得手工打开 dashboard 逐个记录；改完 CMS 内容后想发布上线，要回到界面点按钮确认；不同环境还要分别维护凭据。这些动作本身不难，但散落在界面操作里，agent 或脚本很难稳定复用。这个技能正是为这类场景准备的：它把 Webflow Data API 的官方 JavaScript SDK 封装成可调用的能力，让列站点、发布内容、管理 CMS 数据都能以代码方式完成。

核心能力与工作方式

技能围绕 Data API 的四类典型操作展开：

站点与工作区管理：列出当前凭据可见的站点，便于脚本按需选择操作目标。
发布工作流：在内容变更后触发站点发布，把 CMS 更新同步到线上。
CMS 数据管理：读写 CMS collection 条目，支撑内容入库、更新与查询。
认证方式：支持三种凭据——workspace token、site token，以及完整的 OAuth 流程，覆盖从个人脚本到多用户应用的不同需求。

工作方式上，技能本质是对官方 webflow-api SDK 的结构化调用约定。拿到凭据后先初始化客户端，再按目标资源（站点、collection、发布状态）逐层调用对应接口。OAuth 场景下，需要先在 Webflow 工作区注册应用，启用 Data Client building block，拿到 client ID 和 client secret，再走标准的授权码交换流程。

适用边界与注意点

OAuth 配置是硬门槛：需要多用户授权时必须先完成应用注册，缺少 Data Client building block 会直接导致认证失败。
凭据作用域决定可见范围：site token 通常只能操作单个站点，跨站点任务应使用 workspace token。
发布是站点级的副作用动作：调用前应确认目标站点正确，避免把调试内容推上生产环境。
技能提取自上游官方 SDK 文档，接口行为与 webflow/js-webflow-api 保持一致；Webflow API 更新时建议同步核对上游 changelog。