Zapier SDK

这个 Agent 能做什么，适合哪些场景？

Zapier SDK 通过 npm 包 @zapier/zapier-sdk 提供对 Zapier 应用生态的程序化访问，仓库本身则打包了 SDK 文档、经校验的示例和可安装的智能体技能。执行模型是：用户在本地通过 npx zapier-sdk login 登录，用 create-connection 为某个应用建立 OAuth 连接（密钥由 Zapier 持有），再用 run-action 调用目录中的具体 Action；SDK 在运行时解析 Action schema，代码始终不接触 token。仓库按 by-app、by-domain、by-pattern 三种方式索引 examples/ 目录，并提供符合 agentskills.io 的 zapier-sdk 技能与只读的 zapier-sdk-explorer 子代理。除标准 CLI/SDK 用法外，它还支持以插件形式装入 Claude Code、OpenAI Codex 和 GitHub Copilot CLI，或手动 clone 后引用 SKILL.md。集成边界明确：连接与 Action 目录由 Zapier 平台托管，代码可移动、平台不可移动。

该仓库提供并説明 @zapier/zapier-sdk（运行时 SDK）与 @zapier/zapier-sdk-cli（CLI 伴侣）的用法。典型流程为：先 npm install 两个包，再运行 npx zapier-sdk login 在本地保存凭据，createZapierSdk() 会自动读取这些凭据；随后用 npx zapier-sdk list-connections、npx zapier-sdk create-connection <app> 为 notion、gmail、google-sheets、airtable 等应用建立 OAuth 连接；最后用 npx zapier-sdk run-action <app> <action> --inputs '{...}' 执行具体 Action，例如 notion 的 search page_by_title、gmail 的 search message、google-sheets 的 search lookup_row、airtable 的 search findRecord，输出为 JSON。示例目录 examples/by-app 收录单次调用的 SDK 示例，by-domain 用 README 将行业域映射到示例，by-pattern 提供 notify-on-event、data-sync、lead-routing、scheduled-report 等端到端自动化形态；示例中的 action key 在入库时都经过 listActions 校验。此外，skills/zapier-sdk 以 agentskills.io 规范分发，zapier-sdk-explorer 子代理可在写代码前对活目录解析精确的 app/action/field ID，sdk.fetch 则作为任意 HTTP API 的逃逸通道。

1. 需要跨多个 SaaS 打通流程的自动化工程师：不想为每个应用单独申请 OAuth 应用、维护刷新 token，可直接用 create-connection + run-action 串起 Notion、Gmail、Google Sheets、Airtable。
2. 编写代码助手的开发者：把 sdk@zapier 插件装进 Claude Code 或 Codex，让助手在生成代码前用 zapier-sdk-explorer 校验真实的 action key，避免编造方法名。
3. 做线索分发的团队：用 airtable findRecord 按邮箱查询记录，再把结果推送到 CRM 或其他目标，形成 lead-routing 模式。
4. 需要定时报表的场景：按 scheduled-report 模式，从 Google Sheets lookup_row 或 Gmail message 拉取数据后汇总输出。
5. 只想要 CLI 快速试验的运维/支持人员：在终端用 run-action 对已有连接执行查询，例如按 Gmail 查询语法检索来自某地址的邮件。
6. 构建智能体工具的团队：以 agentskills.io 兼容方式加载 zapier-sdk 技能，作为工具调用层接入自有 runtime。

如何安装或部署这个 Agent？

前置条件：Node.js 与 npm（CLI 与 SDK 均为 npm 包），需联网访问 Zapier。

1) 安装运行时与开发依赖（README 原样命令）：

npm install @zapier/zapier-sdk
npm install -D @zapier/zapier-sdk-cli @types/node typescript

2) 让 AI 编码助手代为安装（可选，注意 README 中的 marketplace 拼写与命令原样）：
Claude Code：

/plugin marketplace add zapier/marketplace
/plugin install sdk@zapier

OpenAI Codex：

codex plugin marketplace add zapier/marketplace
codex plugin add sdk@zapier

GitHub Copilot CLI：

copilot plugin marketplace add zapier/marketplace
copilot plugin install sdk@zapier

3) 不支持 agentskills.io 的工具：

git clone https://github.com/zapier/sdk.git

然后把 skills/zapier-sdk/SKILL.md 引入 .cursorrules、AGENTS.md、.github/copilot-instructions.md 等规则文件。

4) 登录：npx zapier-sdk login复制，凭据保存在本机，后续 createZapierSdk() 自动读取。

如何使用这个 Agent？

认证与查看身份：

npx zapier-sdk login
npx zapier-sdk get-profile

建立连接（每个应用会打开浏览器完成 OAuth）：

npx zapier-sdk list-connections
npx zapier-sdk create-connection notion
npx zapier-sdk create-connection gmail
npx zapier-sdk create-connection google-sheets
npx zapier-sdk create-connection airtable

执行 Action（返回 JSON）：

npx zapier-sdk run-action notion search page_by_title --inputs '{"title":"Meeting Notes","exact_match":"no"}'
npx zapier-sdk run-action gmail search message --inputs '{"query":"from:[email protected]"}'
npx zapier-sdk run-action google-sheets search lookup_row --inputs '{"spreadsheet":"<sheet-id>","worksheet":"<tab-id>","lookup_key":"Email","lookup_value":"[email protected]"}'
npx zapier-sdk run-action airtable search findRecord --inputs '{"applicationId":"<base-id>","tableName":"Leads","searchByField":"Email","searchByValue":"[email protected]"}'

在代码中使用：createZapierSdk() 会自动读取本地凭据；需要调任意 HTTP API 时用 sdk.fetch。更多单次调用示例见 examples/by-app/，字段与全量方法见 docs.zapier.com/sdk/reference，CLI 完整命令见 skills/zapier-sdk/references/cli-commands.md。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

[![FARS 评测](https://followagents.com/badge/sdk.svg?lang=zh)](https://followagents.com/zh/agents/sdk)

<a href="https://followagents.com/zh/agents/sdk"><img src="https://followagents.com/badge/sdk.svg?lang=zh" alt="FARS 评测"></a>

常见问题