扣子Webflow API搭建轻量级作品集自动生成器

你是否希望将 GitHub 项目自动同步到个人作品集，却不想每次都手动更新 Webflow 页面？借助扣子（Coze）工作流调用 Webflow API，就能让新提交的代码仓库自动转化为网页上的卡片，全过程无需编写任何部署脚本。核心思路如下：首先获取 Webflow 的 API 密钥、站点 ID 和 Projects 集合 ID；接着在扣子中创建一条工作流，包含 GitHub Webhook 接收、数据解析与 API 提交三个核心节点；最后配置条件判断与失败通知。这样一来，每当新仓库创建时，便会自动呈现在你的作品集页面上。

准备工作：获取 Webflow API 密钥与站点 ID

先别急着动手写代码，得先把 Webflow 那边的“钥匙”拿到手。登录 Webflow 账户后，进入「Account Settings」，在左侧菜单中找到「API Tokens」，点击「Create Token」。

在弹窗里为这个 token 命名，例如“coze-portfolio-sync”。权限方面，只需勾选 【Sites: Read & Write】 和 【Collections: Read & Write】，其他选项一律不选——请注意，多勾反而可能导致密钥被平台风控拒绝调用，得不偿失。

点击创建之后，页面仅显示一次完整的密钥。这一步至关重要：立即复制并保存到本地文本文件中。一旦关闭此页面，就再也无法查看原始值了。接着，打开 Webflow 编辑器，进入你要自动更新的作品集项目。查看浏览器地址栏，URL 形如 https://webflow.com/sites/abc123/edit，其中 abc123 就是你的 【Site ID】，请记录下来。

返回 Webflow 后台，进入「Collections」，找到或新建一个名为「Projects」的集合。点击进入后，查看右上角的「Settings」，这里有一个 【Collection ID】——这是一串字母数字组合，不是集合名称，千万别混淆。

在扣子中创建工作流并配置触发节点

登录扣子平台（coze.cn），进入工作空间后点击「+ 新建」，选择「工作流」，命名为「Webflow-Auto-Project-Sync」，描述填写“监听 GitHub 新仓库并同步至 Webflow Projects 集合”。

画布上默认有「开始」和「结束」两个节点，先把「结束」节点删除，后面再添加。从左侧节点库拖入一个「HTTP 请求」节点，重命名为「GitHub Webhook 接收」。双击进入编辑界面：协议选择「POST」，路径留空（扣子会自动生成唯一的 webhook URL），请求体类型选「JSON」。

点击「启用 Webhook」后复制生成的 URL。这个地址就是 GitHub 那边用来发送新仓库事件的接收端点。

配置 GitHub Webhook 并验证事件结构

进入 GitHub 个人主页 → 「Settings」→ 「Developer settings」→ 「Webhooks」→ 「Add webhook」。将刚才复制的扣子 webhook 地址粘贴到 Payload URL 栏；Content type 选择「application/json」。最关键的是底部的事件选择：勾选「Let me select individual events」，然后确保「Create」已启用，仅监听新仓库创建事件。这样能有效避免误触发 fork 或 star 等无关操作。

点击「Add webhook」后，GitHub 会立即发送一条测试请求。回到扣子工作流，点击「GitHub Webhook 接收」节点右上角的「调试」，查看「最近请求」里的 raw body。确认结构是否包含 repository.full_name、repository.description、repository.html_url 这三个字段——它们是后续写入 Webflow 所需的最小数据源。如果 body 为空或字段缺失，说明 GitHub 没有发送成功，回去检查事件类型是否勾选正确。

解析 GitHub 数据并构造 Webflow 请求体

在「GitHub Webhook 接收」节点下游，拖入一个「代码」节点，重命名为「Build Webflow Payload」。在代码编辑区粘贴以下 JavaScript：

ret = {
  fields: {
    "name": params.body.repository.full_name,
    "description": params.body.repository.description || "No description provided",
    "link": params.body.repository.html_url,
    "github_url": params.body.repository.html_url,
    "status": "published"
  }
};

这段代码非常关键：它把 GitHub 事件中的关键字段映射成 Webflow Collection Item 所需的 fields 结构。注意 params.body.repository.description 这里添加了空值兜底（"No description provided"），否则当仓库没有描述时，Webflow API 会因为字段缺失直接返回 400 错误。

调用 Webflow API 创建新项目条目

在「Build Webflow Payload」节点下游，拖入第二个「HTTP 请求」节点，重命名为「Post to Webflow Projects」。

配置参数如下：
方法：POST
URL：https://api.webflow.com/v2/sites/【你的 Site ID】/collections/【你的 Collection ID】/items
Headers 添加两行：
Authorization：Bearer 【你的 Webflow API 密钥】
Content-Type：application/json

Body 类型选「Raw」，内容填：{{#context.code_1.ret#}}。这是扣子的语法，表示引用上游代码节点（Build Webflow Payload）的输出结果。

配置完成后，点击「测试运行」查看效果。如果响应状态码是 201，说明请求成功，新项目条目已创建。如果返回 401，请检查密钥是否过期或权限不足；如果返回 404，通常是 Site ID 或 Collection ID 填写错误——这两个 ID 区分大小写，且不能包含空格，务必仔细核对。

添加失败处理与日志反馈

为了让整个工作流更加可靠，需要添加错误处理逻辑。从节点库拖入一个「条件判断」节点，连接到「Post to Webflow Projects」后面，设置判断条件为：response.status === 201。

「是」分支连接到一个「结束」节点，标签写「Sync Success」；「否」分支连接到另一个「结束」节点，标签写「Sync Failed」。

在「Sync Failed」分支上，额外添加一个「通知」节点（可选飞书、邮件或 Webhook），通知内容填写：Webflow sync failed for {{params.body.repository.full_name}}: {{response.statusText}}。这样一旦同步出错，你能第一时间知道是哪个仓库出了问题，以及具体的错误原因。

全部完成后，保存工作流，点击右上角的「发布」。此时，GitHub 上的新仓库事件便开始实时地流向扣子工作流，最终自动呈现在你的 Webflow 作品集页面上。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：扣子Webflow API搭建轻量级作品集自动生成器要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题