Zapier SDK — скилл

Плагин со скиллом zapier-sdk: агент пишет код для более 9000 приложений Zapier, а ключи действий берет из живого каталога

269 ★ репозитория
Последний коммит 14 окт. 2026
MIT

Скилл Официальный

zapier/sdkАвтор:Zapier

Установка

Работает в: Claude Code
Codex
GitHub Copilot
Cursor
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/zapier-sdk

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Через подключенные OAuth-доступы агент может писать в Gmail, Slack, CRM и другие приложения от имени владельца аккаунта
Метод zapier.fetch отправляет HTTP-запрос на любой адрес с авторизацией выбранного подключения
Учетные данные clientId и clientSecret дают вход в SDK без браузера

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий zapier/sdk — официальный набор для Claude Code, Codex и GitHub Copilot CLI, который учит агента работать с Zapier SDK для TypeScript. В нем три части: скилл zapier-sdk, субагент zapier-sdk-explorer и корпус проверенных примеров. Скилл описывает вход в аккаунт, поиск приложения и действия в каталоге Zapier и запуск действия от имени пользователя. Главное правило скилла: память модели про этот SDK устарела, поэтому доверять ей нельзя. Агент сначала ищет ключ приложения командой zapier-sdk list-apps, затем действие командой list-actions, поля ввода командой list-action-input-fields, и только после этого пишет код. Субагент zapier-sdk-explorer работает только на чтение: сверяет идентификаторы с живым каталогом и ничего не запускает и не деплоит. Примеры лежат по приложениям, по доменам и по шаблонам: уведомления о событиях, синхронизация данных, маршрутизация лидов, регулярные отчеты. Если нужного действия в каталоге нет, скилл отправляет к zapier.fetch, обычному HTTP-запросу с авторизацией через подключение Zapier. Для запуска кода на инфраструктуре Zapier есть отдельная справка о воркфлоу, которые Zapier запускает у себя.

Для кого. Разработчикам, которые на TypeScript собирают бэкенд или агента с действиями в Gmail, Notion, Google Sheets или HubSpot и не хотят вести OAuth для каждого приложения отдельно.

Подходит, если

Скрипт на Node должен найти строку в Google Sheets и отправить письмо через Gmail, а токены каждого сервиса вести не хочется
Агент в Claude Code выдумывает ключи действий Zapier, и нужен субагент, который сверит их с живым каталогом
Лиды из Facebook Lead Ads надо раскладывать по HubSpot или Google Sheets, а в корпусе уже лежат примеры такой маршрутизации
Ежедневная сводка выручки должна уходить по расписанию: образец такого отчета лежит в каталоге примеров

Не подходит, если

Нужны вызовы приложений прямо из чата Claude Desktop или ChatGPT без кода: для этого у Zapier есть отдельный MCP-сервер
Политика компании запрещает передавать OAuth-доступы посреднику: подключения к приложениям хранит Zapier
Скрипт должен работать в закрытом контуре без выхода наружу: SDK обращается к платформе Zapier по HTTPS

Пример запроса к агенту

Напиши на TypeScript скрипт, который через Zapier SDK ищет в Notion страницы с названием «Meeting Notes» и печатает их список

Ограничения

Нужен аккаунт Zapier: вход npx zapier-sdk login открывает браузер, а условия и тариф описаны на zapier.com/sdk.
Доступ к каждому приложению подтверждает человек через OAuth. Агент может получить ссылку и показать ее, но нажать «разрешить» за вас не может.
Действия с пометкой is_hidden лежат вне стабильной поверхности: Zapier не обещает, что они продолжат работать.
Лимиты сторонних сервисов доходят до вашего кода как ошибка ZAPIER_ACTION_ERROR с паузой повтора в секундах, повторы и очереди пишете вы.

Как отключить. Плагин отключается в меню /plugin Claude Code, в Codex его выключает переключатель в /plugins. Пакеты проекта снимает npm uninstall @zapier/zapier-sdk. Список подключений, которые хранит Zapier, показывает команда npx zapier-sdk list-connections.

Частые вопросы

Как поставить Zapier SDK в Claude Code?

Две команды в Claude Code: /plugin marketplace add zapier/marketplace и /plugin install sdk@zapier. Плагин приносит скилл и субагента, а сам SDK ставится в проект отдельно через npm install @zapier/zapier-sdk. Для Codex и Copilot CLI команды той же формы: codex plugin add sdk@zapier и copilot plugin install sdk@zapier.

Что делать, если подключения к приложению еще нет?

Создайте его командой npx zapier-sdk create-connection notion, где вместо notion стоит нужное приложение: откроется браузер с OAuth. Агент по инструкции скилла берет ссылку командой get-connection-start-url, показывает ее вам и ждет окончания через wait-for-new-connection.

Как запустить код на сервере или в CI, где нет браузера?

Передайте в createZapierSdk учетные данные клиента: блок с полями clientId и clientSecret. Вход через браузер нужен только для локальной разработки.

Подойдет ли скилл для Cursor?

Да, но без плагина. Скилл соответствует agentskills.io, поэтому после git clone https://github.com/zapier/sdk.git ссылку на skills/zapier-sdk/SKILL.md добавляют в .cursorrules или AGENTS.md.

Можно ли вызвать API, которого нет среди действий Zapier?

Да, через zapier.fetch: он отправляет HTTP-запрос с авторизацией выбранного подключения и попадает в тот же журнал аудита, что и runAction.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Zapier MCP

Официальный

Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier

ПлагинШирокий доступ453

Chat SDK

Скилл chat-sdk от Vercel: агент пишет ботов для Slack, Teams, Discord и Telegram на одном коде и подбирает нужные адаптеры.

СкиллРасширенный доступ2,5 тыс.

Awesome Claude Skills от Composio

Awesome Claude Skills

Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio

СкиллШирокий доступ78,9 тыс.

Kody CLI skill

Скилл дает агенту CLI Kody для локального выполнения кода с общей памятью, пакетами и данными облачного аккаунта.

СкиллШирокий доступ909

recruiting-copilot

Скиллы для HR: требования к вакансии, поиск на BOSS Zhipin и Liepin, оценка резюме, интервью и реестр кандидатов

СкиллШирокий доступ109

AI Agent Skills от sanjay3290

AI Agent Skills

Набор кроссплатформенных скиллов: запросы только на чтение к PostgreSQL, MySQL и MSSQL, Google Workspace, Jira, Telegram, озвучка и исследования

СкиллШирокий доступ452

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

Инструмент	Официальный	Авторизация	Звезды репозитория	Главное отличие
Zapier SDK (эта карточка)	да		269
Zapier MCP	да	OAuth	453	тот же Zapier, но вызовы идут инструментами MCP в чате без написания кода
Composio	нет		30 950	сторонняя платформа интеграций с собственным SDK, CLI и MCP, не каталог Zapier

Коротко о README

README открывается быстрым стартом: два npm-пакета, вход, создание подключения и запуск действия через CLI. Дальше идут каталог примеров в трех разрезах, схема обращения кода к платформе Zapier и способы поставить плагин в разные ассистенты. Условия самого сервиса README отдает в Terms of Service Zapier.

Бейдж для README

Исходный SKILL.md

---
name: zapier-sdk
description: |
  Zapier SDK for TypeScript. Programmatic access to 9,000+ apps on a user's behalf via Zapier's OAuth
  and audit layer. Use when writing code that needs to run actions in third-party apps (send an email,
  upsert a CRM record, look up a spreadsheet row, post to a chat) without managing per-app OAuth or
  vendor SDKs. Triggers: "zapier sdk", "zapier-sdk", "@zapier/zapier-sdk", "runAction",
  "run zapier action", "connect to app via zapier", "zapier connection", "zapier tables",
  "list actions for zapier app", "getActionInputFieldsSchema", "createZapierSdk".
metadata:
  author: zapier
---

# Zapier SDK

Connect your app, agent, or backend to 9,000+ integrations with a few lines of code. Run actions, manage user connections, chain apps together. The SDK handles token refresh, retries, and API differences.

## When to use the SDK

The Zapier SDK is the **code interface** to Zapier. It gives coding agents and AI builders programmatic, governed access to 9,000+ apps, running inside editors like Cursor, Claude Code, or VS Code.

Two sibling interfaces share the same capabilities:

- **Zapier CLI** (`@zapier/zapier-sdk-cli` package): terminal interface (`npx zapier-sdk ...`) for one-off commands, exploration, scripting. Read [`references/cli.md`](references/cli.md) when the user wants shell access instead of code.
- **Zapier MCP** (https://zapier.com/mcp): LLM interface (tool-calling inside Claude, ChatGPT, or any MCP client, no code required).

Pick the SDK when the deliverable is code. If the user wants ad-hoc tool calls in an AI chat interface, point them to MCP.

**Two SDK shapes to distinguish:**

- **Plain SDK script** (this file): the user's own code calls the SDK. Runs wherever their code runs (Node script, Next.js route, Lambda, CLI).
- **Durable workflow** (`@zapier/zapier-durable`): the user *deploys* a workflow that Zapier's infrastructure runs on a trigger (webhook, poll, schedule). Retries stay idempotent via `ctx.step`. Read [`references/workflows.md`](references/workflows.md) when the user wants deployment on Zapier's infrastructure instead of running the code themselves.

## Prerequisites

The SDK ships two packages: a TypeScript library and a CLI. Install whichever you need.

Check what's already installed:

```bash
# Is the SDK library present?
ls node_modules/@zapier/zapier-sdk 2>/dev/null && echo "SDK installed" || echo "SDK not installed"

# Is the CLI available?
npx zapier-sdk --version 2>/dev/null && echo "CLI installed" || echo "CLI not installed"

Сообщить о проблеме