К основному содержанию
скилл CX Codex

vercel-webhooks-events — скилл для Claude Code

Скилл vercel-webhooks-events для Claude Code, Codex, Cursor и других платформ обрабатывает события развёртывания Vercel с проверкой подписи HMAC.

MIT 1 установок ★ 2 935 обновлён 2026-11-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a claude-code
Открыть на GitHub

Что делает vercel-webhooks-events

Скилл предоставляет готовый обработчик вебхуков с верификацией подписей через crypto модуль. Внутри — функции для обработки событий типа deployment.created, deployment.ready и deployment.error, отправка уведомлений в Slack при успешном развёртывании в production, обработка ошибок. Включает механизм идемпотентности, чтобы не обработать одно событие дважды при повторной отправке от Vercel.

Для работы нужны HTTPS-эндпоинт, доступный из интернета, и секрет вебхука из панели Vercel. Скилл использует @vercel/node для типизации запросов и ответов. Локально можно тестировать через localtunnel или другой туннель-сервис, отправляя curl-запросы с правильной подписью.

Скилл работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Способ установки зависит от платформы: для Claude Code и Cursor — команда npx skills add, для GitHub Copilot — gh skill install, для Gemini CLI — отдельная строка с путём репозитория.

Какие задачи решает

  • настроить обработку вебхуков Vercel с проверкой подписи
  • отправить уведомление в Slack при успешном развёртывании
  • предотвратить дублирование обработки одного события
  • протестировать вебхук локально перед развёртыванием
  • различать события из Vercel Marketplace и project-level Deploy Hooks

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

  • Настрой обработку вебхуков Vercel с проверкой подписей в api/webhooks/vercel.ts
  • Реализуй отправку сообщения в Slack при событии deployment.ready для production
  • Добавь механизм идемпотентности, чтобы не обработать один вебхук дважды

Как установить vercel-webhooks-events

1Через Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a claude-code

2Вручную: положить файлы

~/.claude/skills/vercel-webhooks-events/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/vercel-webhooks-events/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о vercel-webhooks-events

Как установить vercel-webhooks-events в Claude Code?

Выполни команду npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a claude-code, затем открой файл ~/.claude/skills/vercel-webhooks-events/SKILL.md для просмотра деталей скилла.

Что делает vercel-webhooks-events?

Скилл обрабатывает события развёртывания Vercel (deployment.created, deployment.ready, deployment.error) с проверкой подписи HMAC-SHA1. Отправляет уведомления, предотвращает дублирование событий и предоставляет примеры интеграции со Slack.

На каких платформах работает этот скилл?

Скилл поддерживает Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Способ установки отличается: для одних — npx skills add, для других — gh skill install или прямая ссылка на репозиторий.

Исходный текст

SKILL.md · MIT
---
name: vercel-webhooks-events
description: 'Implement Vercel webhook handling with signature verification and event
  processing.

  Use when setting up webhook endpoints, processing deployment events,

  or building integrations that react to Vercel deployment lifecycle.

  Trigger with phrases like "vercel webhook", "vercel events",

  "vercel deployment.ready", "handle vercel events", "vercel webhook signature".

  '
allowed-tools: Read, Write, Edit, Bash(curl:*)
version: 1.18.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags:
- saas
- vercel
- webhooks
- events
- integration
compatibility: Designed for Claude Code
---
# Vercel Webhooks & Events

## Overview

Handle Vercel webhook events (deployment.created, deployment.ready, deployment.error) with HMAC signature verification. Covers both integration webhooks (Vercel Marketplace) and project-level deploy hooks.

## Prerequisites

- HTTPS endpoint accessible from the internet
- Webhook secret from Vercel dashboard or integration settings
- `crypto` module for HMAC signature verification

## Instructions

### Step 1: Register a Webhook

In the Vercel dashboard:

1. Go to **Settings > Webhooks**
2. Add your endpoint URL (must be HTTPS)
3. Select events to subscribe to
4. Copy the webhook secret for signature verification

Or for Integration webhooks, configure in the Integration Console at `vercel.com/dashboard/integrations`.

### Step 2: Verify Webhook Signature

```typescript
// api/webhooks/vercel.ts
import type { VercelRequest, VercelResponse } from '@vercel/node';
import crypto from 'crypto';

const WEBHOOK_SECRET = process.env.VERCEL_WEBHOOK_SECRET!;

function verifySignature(body: string, signature: string): boolean {
  const expectedSignature = crypto
    .createHmac('sha1', WEBHOOK_SECRET)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

export default async function handler(req: VercelRequest, res: VercelResponse) {
  if (req.method !== 'POST') {
    return res.status(405).json({ error: 'Method not allowed' });
  }

  // Get raw body for signature verification
  const rawBody = JSON.stringify(req.body);
  const signature = req.headers['x-vercel-signature'] as string;

  if (!signature || !verifySignature(rawBody, signature)) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  // Process the event
  const event = req.body;
  await handleEvent(event);

  res.status(200).json({ received: true });
}
```

### Step 3: Handle Deployment Events

```typescript
// lib/webhook-handlers.ts
interface VercelWebhookEvent {
  id: string;
  type: string;
  createdAt: number;
  payload: {
    deployment: {
      id: string;
      name: string;
      url: string;
      meta: Record<string, string>;
    };
    project: {
      id: string;
      name: string;
    };
    target: 'production' | 'preview' | null;
    user: { id: string; email: string; username: string };
  };
}

async function handleEvent(event: VercelWebhookEvent): Promise<void> {
  switch (event.type) {
    case 'deployment.created':
      console.log(`Deployment started: ${event.payload.deployment.url}`);
      // Notify Slack, update status board, etc.
      break;

    case 'deployment.ready':
      console.log(`Deployment ready: ${event.payload.deployment.url}`);
      // Run smoke tests against the deployment URL
      // Notify team of successful deploy
      if (event.payload.target === 'production') {
        await notifyProductionDeploy(event);
      }
      break;

    case 'deployment.error':
      console.error(`Deployment failed: ${event.payload.deployment.id}`);
      // Alert on-call engineer
      // Create incident ticket
      await notifyDeploymentError(event);
      break;

    case 'deployment.canceled':
      console.log(`Deployment canceled: ${event.payload.deployment.id}`);
      break;

    case 'project.created':
      console.log(`New project: ${event.payload.project.name}`);
      break;

    case 'project.removed':
      console.log(`Project removed: ${event.payload.project.name}`);
      break;

    default:
      console.log(`Unhandled event type: ${event.type}`);
  }
}
```

### Step 4: Idempotency — Prevent Duplicate Processing

```typescript
// lib/idempotency.ts
// Vercel may retry webhook delivery — track processed event IDs
const processedEvents = new Set<string>(); // Use Redis in production

async function processWebhookIdempotent(
  event: VercelWebhookEvent,
  handler: (e: VercelWebhookEvent) => Promise<void>
): Promise<boolean> {
  if (processedEvents.has(event.id)) {
    console.log(`Skipping duplicate event: ${event.id}`);
    return false;
  }

  await handler(event);
  processedEvents.add(event.id);
  return true;
}
```

### Step 5: Slack Notification Example

```typescript
// lib/notifications.ts
async function notifyProductionDeploy(event: VercelWebhookEvent): Promise<void> {
  const { deployment, project, user } = event.payload;

  await fetch(process.env.SLACK_WEBHOOK_URL!, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      text: `Production deploy complete`,
      blocks: [
        {
          type: 'section',
          text: {
            type: 'mrkdwn',
            text: [
              `*${project.name}* deployed to production`,
              `By: ${user.username}`,
              `URL: https://${deployment.url}`,
              `Commit: ${deployment.meta?.githubCommitMessage ?? 'N/A'}`,
            ].join('\n'),
          },
        },
      ],
    }),
  });
}

async function notifyDeploymentError(event: VercelWebhookEvent): Promise<void> {
  await fetch(process.env.SLACK_WEBHOOK_URL!, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      text: `Deployment FAILED for ${event.payload.project.name} — ${event.payload.deployment.id}`,
    }),
  });
}
```

### Step 6: Test Webhooks Locally

```bash
# Use the Vercel CLI to test webhook signatures
# Or use a tunnel service for local testing
npx localtunnel --port 3000
# Gives you a public URL like https://xxx.loca.lt

# Send a test webhook payload
curl -X POST http://localhost:3000/api/webhooks/vercel \
  -H "Content-Type: application/json" \
  -H "x-vercel-signature: $(echo -n '{"type":"deployment.ready","id":"test"}' | openssl dgst -sha1 -hmac 'your-secret' | awk '{print $2}')" \
  -d '{"type":"deployment.ready","id":"test"}'
```

## Webhook Event Types

| Event | Trigger |
|-------|---------|
| `deployment.created` | New deployment started building |
| `deployment.ready` | Deployment build completed successfully |
| `deployment.error` | Deployment build failed |
| `deployment.canceled` | Deployment was canceled |
| `project.created` | New project created |
| `project.removed` | Project deleted |
| `domain.created` | Domain added to project |
| `integration.configuration.removed` | Integration uninstalled |

## Output

- Webhook endpoint with HMAC signature verification
- Event handlers for deployment lifecycle events
- Idempotent processing preventing duplicates
- Slack notifications for production deploys and failures

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| `401 Invalid signature` | Wrong webhook secret or body mismatch | Verify secret matches dashboard, use raw body for HMAC |
| Webhook not received | Endpoint not publicly accessible | Ensure HTTPS, check firewall rules |
| Duplicate processing | Webhook retried by Vercel | Implement idempotency with event ID tracking |
| `504 timeout` on webhook endpoint | Handler takes too long | Return 200 immediately, process async in background |
| Missing `x-vercel-signature` | Not a real Vercel webhook | Reject requests without the signature header |

## Examples

### Process a deployment webhook exactly once

Verify the raw-body HMAC signature before parsing the event, reject absent or invalid signatures with a generic response, and persist the event ID in an idempotency store before any side effect. Acknowledge quickly and hand longer work to a controlled background queue. Test duplicate delivery and an invalid signature with synthetic events in preview, and keep notification payloads free of tokens, environment values, and customer request data.

## Resources

- [Vercel Webhooks API](https://vercel.com/docs/webhooks/webhooks-api)
- [Setting Up Webhooks](https://vercel.com/docs/webhooks)
- [Deploy Hooks](https://vercel.com/docs/deploy-hooks)
- [Integration Webhooks](https://vercel.com/docs/integrations/create-integration)

## Next Steps

For performance optimization, see `vercel-performance-tuning`.

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
vercel-webhooks hookdeck Скилл vercel-webhooks для приёма и проверки вебхуков Vercel прямо в коде. Помогает при настройке обработчиков, отладке проверки подписей и реагировании на события развёртывания и проектов. CX Codex +1 204установок slack-webhooks hookdeck Скилл slack-webhooks помогает настроить приём вебхуков Slack Events API, пройти проверку url_verification и настроить валидацию подписи запросов. CX Codex +1 128установок inngest-events inngest Скилл inngest-events помогает проектировать событийные воркфлоу Inngest: имена событий, идемпотентность по id, fan-out и системные события. CX Codex +1 4 000установок vercel membrane Скилл для работы с Vercel через Membrane: создавайте проекты, управляйте развёртываниями, переменными окружения и доменами прямо из агента. Нужен аккаунт Membrane (поддерживается бесплатный тариф). CX Codex +1 258установок vercel-overview bobmatnyc Скилл vercel-overview для Claude Code описывает проекты Vercel, CLI, Git-интеграцию, переменные окружения, REST API и вебхуки. Помогает планировать деплой и изучать настройки проекта. CX Codex +1 346установок Webhook Automation Claude Office Skills Скилл Webhook Automation для Claude Code: приём событий вебхука, проверка подписи, маршрутизация и преобразование payload. Связывает платежи, GitHub и Slack с внутренними сервисами. CX Codex +1 4 800установок

Из того же набора139

Весь набор →
cursor-usage-analytics Скилл cursor-usage-analytics для Cursor анализирует запросы, модели, расходы и вовлечённость команды. Собирает отчёты и помогает контролировать квоты. CX Codex +1 1установок customerio-cost-tuning Скилл customerio-cost-tuning ищет переплату в Customer.io: лишние профили, неактивные аккаунты, дубли событий. Показывает, что можно убрать, не тронув доставку. CX Codex +1 1установок apollo-core-workflow-a Скилл apollo-core-workflow-a настраивает пайплайн лидогенерации через Apollo.io: ищет компании и контакты, а затем обогащает выбранные лиды телефонами и почтой. CX Codex +1 1установок firecrawl-migration-deep-dive Скилл firecrawl-migration-deep-dive помогает заменить Puppeteer, Playwright, Cheerio или другой скрейпер на Firecrawl v2 с проверкой паритета, политик, стоимости и отката. CX Codex +1 1установок vercel-reference-architecture Скилл vercel-reference-architecture разворачивает эталонную архитектуру для Next.js на Vercel. Помогает настроить слои edge и serverless, структурировать API и защитить роуты. CX Codex +1 1установок vercel-policy-guardrails Скилл vercel-policy-guardrails добавляет проверки для Vercel-проектов: ESLint-правила, поиск секретов, CI-проверки и контроль защищённых маршрутов. CX Codex +1 1установок gcs-lifecycle-policy Скилл gcs-lifecycle-policy для работы с политиками жизненного цикла в Google Cloud Storage. Включается сам, когда в запросе упоминается gcs или lifecycle policy. CX Codex +1 1установок gcs-bucket-config Скилл gcs-bucket-config настраивает бакеты Google Cloud Storage через CLI и генерирует конфигурации. Срабатывает в Claude Code при упоминании GCS и команд gcloud. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой