zapier-sdk

用途：Zapier SDK 是 Zapier 的代码接口（TypeScript），为编程者和 AI 编码代理提供对 9,000+ 应用的程序化、受治理访问，可在 Cursor、Claude Code、VS Code 等编辑器中使用。需要交付代码时选 SDK；若只需在 AI 对话中做临时工具调用，则用 Zapier MCP。其同级终端接口为 CLI（@zapier/zapier-sdk-cli，npx zapier-sdk ...）。\n\n主要能力：查找或创建连接（OAuth 授权）；运行动作，类型含 read、write、search；运行时发现动作与输入结构；通过 Zapier 认证基础设施调用原始 API（zapier.fetch）；覆盖 Apps、Actions、Connections、HTTP、Tables、Auth、Profile 等类别。SDK 自动处理令牌刷新、重试与 API 差异。\n\n用法：先安装并认证。npm install @zapier/zapier-sdk；CLI 为 npm install -D @zapier/zapier-sdk-cli @types/node typescript；npx zapier-sdk login 打开浏览器登录。查询登录身份用 npx zapier-sdk get-profile（无 whoami、status、auth）。查找应用用 zapier-sdk list-apps --search，列动作用 list-actions，查询输入字段用 list-action-input-fields，执行用 run-action。代码中先 findFirstConnection 取得连接，再 zapier.runAction({ appKey, actionType, actionKey, connection, inputs })。\n\n限制：OAuth 无法完全自动化，必须由人类在浏览器点击授权，代理需展示 URL 并等待；is_hidden: true 的动作不在稳定接口上；runAction 的 appKey 需 CLIAPI 后缀形式（如 NotionCLIAPI）；动态输入字段需针对实时连接校验；runAction 始终返回 { data: T[] } 数组；上游 429 会以 ZAPIER_ACTION_ERROR 返回。SDK 较新，勿凭训练知识猜测方法或应用/动作键，应查官方文档 https://docs.zapier.com/sdk/reference。\n\n费用、定价与平台支持细节暂未提供。