用途:构建最小化、只读优先的 Webflow Data API v2 集成,用于验证连通性、了解资源 ID,并安全地建立后续工作基础。
主要能力:以官方文档和项目已安装版本为准,保持发现过程只读,将准备与实际的写操作分离。认证方式为 bearer token,可按需选用 site token、workspace token 或 OAuth,作用域由具体端点推导;令牌值不得出现在命令、补丁、示例、日志或报告中。工作流从 GET /v2/sites 开始,用返回的 site ID 发现 collections 等资源,并分别读取 staged 与 live 的分页数据并标注来源。
使用方式:先检查项目指令、运行时、包管理器与现有环境变量约定;添加固定版本的 webflow-api 依赖和仅服务端可用的 WEBFLOW_API_TOKEN;创建小型 client 模块与列出可访问站点的命令;按 ID 选择站点,列出 collections 并记录 ID 与显示名;读取有界的 staged 与 live 项目。若项目已有类型检查或测试命令则运行,否则提供应执行的确切命令与预期标识字段。
限制与边界:连接成功不等于授权写入,hello-world 路径保持只读,直到用户明确指定目标 collection 与期望变更。任何创建、更新、删除、发布、取消发布、归档、部署、撤销令牌或注册 webhook 前,须展示确切环境与资源 ID、拟议更改、验证方法及回滚方案,并获得明确批准;生产发布或破坏性操作需重新明确批准。无站点返回时确认令牌类型与授权,不得猜测 site ID;collection 缺失时重新列出并考虑环境或语言差异。输出需区分文档事实、仓库证据与推断。