用途:Clay 是纯云端平台,没有本地运行时。该技能帮助搭建本地开发反馈闭环:脚本经 webhook 把数据推入 Clay,Clay 在云端执行富化,再由 HTTP API 列通过 ngrok 把富化结果 POST 回本地端点,便于迭代 webhook 处理器与测试富化流程。
前置条件:完成 clay-install-auth 设置;Node.js 18+ 或 Python 3.10+;安装 ngrok(npm install -g ngrok);已在 Clay 表配置 webhook 数据源。
主要步骤:1)用 ngrok http 3000 暴露本地服务,复制 HTTPS 转发地址;2)用 Express 建本地接收端点(如 /api/clay/enriched 接收富化数据,/api/health 供健康检查);3)写测试数据发送脚本,向 CLAY_WEBHOOK_URL 逐条 POST 测试线索并控制速率;4)在 Clay 表添加 HTTP API 列,Method 设为 POST,URL 填 ngrok 地址,Body 用 {{列名}} 语法映射字段,并启用新行自动运行;5)三终端迭代:ngrok、本地接收器、测试发送脚本;修改 Clay 富化列或 Claygent 提示后重发数据并观察回传结果;6)用 vitest 等对接收处理器做单元测试,使用模拟的富化载荷避免真实调用 Clay。
常见问题:ngrok 免费隧道会话过期会断连,需重启;ngrok 地址变化后须在 Clay 列中更新 URL;HTTP API 列未启用自动运行则无数据回传;测试数据 JSON 格式错误会返回 422,可用 jq 校验;Clay 表未配置富化提供商时富化列为空。
限制与安全:输出为本地测试凭证(含 fixture 版本、回调结果、校验状态、脱敏关联 ID)。应使用合成或不可逆脱敏的测试数据,切勿把生产线索数据、真实密钥或 CRM 凭据通过隧道引入开发机。具体收费、价格与官方平台细节资料未提供。