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

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

Скилл firecrawl-webhooks-events настраивает приём вебхуков Firecrawl: валидацию подписи HMAC-SHA256, дедупликацию и синхронизацию статусов.

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

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

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

Скилл проектирует приём вебхуков Firecrawl как устойчивый автомат состояний. Он регламентирует проверку подписи X-Firecrawl-Signature до парсинга JSON и сайд-эффектов: берётся сырое тело запроса, сверяется префикс sha256= и выполняется безопасное по времени сравнение хэшей HMAC-SHA256. Если секрет не задан или подпись повреждена, запрос отклоняется не-2xx кодом без изменения состояния.

Конечная точка обязана ответить 2xx в течение 10 секунд, потому что Firecrawl повторяет неудачные попытки только через 1, 5 и 15 минут, после чего прекращает доставку. Скилл запрещает ожидать несуществующие события crawl.failed или batch_scrape.failed — статус незавершённых задач предписывается забирать через опрос API провайдера.

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

  • Проверять HMAC-SHA256 подпись вебхуков Firecrawl до парсинга сырого тела
  • Дедуплицировать входящие события краулинга, батчей и мониторинга
  • Сверять финальные статусы задач через REST API при обрыве доставки

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

  • Настрой приёмник вебхуков Firecrawl для crawl.started, page и completed в src/api/webhooks.ts
  • Добавь безопасную валидацию X-Firecrawl-Signature и дедупликацию событий батчей
  • Спроектируй обработчик Firecrawl events с асинхронной очередью и сверкой статуса задач

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

Выполните команду npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-webhooks-events -a claude-code в терминале.

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

Он направляет агента при разработке надёжного приёма вебхуков Firecrawl: от валидации заголовка X-Firecrawl-Signature до очереди входящих сообщений и сверки статусов.

Как обрабатывать ошибки краулинга, если событий crawl.failed нет?

В протоколе Firecrawl отсутствуют события crawl.failed и batch_scrape.failed, поэтому скилл предписывает запрашивать актуальный статус задачи через официальный API.

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

SKILL.md · MIT
---
name: firecrawl-webhooks-events
description: >-
  Receive, verify, deduplicate, process, and reconcile current Firecrawl crawl, batch, extract, agent, and monitor webhooks. Use when building asynchronous event delivery. Trigger with "Firecrawl webhook", "X-Firecrawl-Signature", or "Firecrawl events".
allowed-tools: Read,Glob,Grep,Write,Edit
argument-hint: "<repository-path> <event-family>"
version: 1.12.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags: [saas, firecrawl, webhooks, security]
model: inherit
effort: high
compatibility: "Designed for Claude Code; Firecrawl Cloud work requires network access"
---
# Firecrawl Signed Webhook Processing

## Overview

Treat a webhook as an authenticated delivery hint into a durable state machine. Verify before parsing or side effects, acknowledge promptly, and reconcile through status APIs after missed delivery.

## Prerequisites

- The target repository or integration path and the requested operator outcome.
- The source authorization, data classification, and environment policy.
- Current Firecrawl documentation, credentials only when needed, and an owner for approvals.

## Current Contract

Firecrawl signs the raw request body with HMAC-SHA256 in X-Firecrawl-Signature formatted sha256=hex. The documented events are crawl.started/page/completed; batch_scrape.started/page/completed; extract.started/completed/failed; agent.started/action/completed/failed/cancelled; monitor.page and monitor.check.completed. Endpoints must return 2xx within 10 seconds; failed delivery retries after 1, 5, and 15 minutes, then stops.

## Authentication

For authenticated Cloud operations, inject FIRECRAWL_API_KEY from an approved
secret manager. REST requests use Authorization: Bearer with the key. Never print,
commit, transmit, or place a key in a URL. Keyless access is suitable only where
the current documentation explicitly allows it and the workload accepts its
limits; production workflows should make identity and team ownership explicit.

## Instructions

1. Register an HTTPS endpoint and choose only the events required for the workflow. Store the account webhook secret in an approved secret manager.
2. Capture the raw body before any JSON parser. Require one X-Firecrawl-Signature value, split and validate the sha256 prefix, hex-decode safely, and compare equal-length digests timing-safely.
3. Reject missing, malformed, or mismatched signatures before parsing, logging, queuing, or mutating state. Never treat a missing secret as verification success.
4. Parse the verified envelope, allowlist exact event types and schema, bind it to the expected team/job, and deduplicate by webhookId plus event/job context.
5. Persist an inbox record and respond with 2xx inside the deadline; process content and downstream writes asynchronously with tenant isolation and idempotency.
6. Handle page and terminal events according to their documented family. Do not wait for nonexistent crawl.failed or batch_scrape.failed events; reconcile job status and pagination.
7. Test signatures, raw-body mutation, duplicates, reordering, retry timing, unknown events, partial pages, crash recovery, and status reconciliation.

## Tool Discipline

Use Read, Glob, and Grep to inspect code, configuration, tests, and evidence. Use
Write/Edit only for approved implementation or documentation changes. Do not call
Firecrawl, rotate keys, change account settings, scrape a target, or deploy merely
because this skill was invoked.

## Approval Boundaries

Require approval before creating the endpoint, storing a webhook secret, adding custom webhook headers/metadata, retaining page payloads, replaying production events, or changing event filters.

## Output

Return endpoint and event scope, secret reference, verification algorithm, schema/idempotency model, acknowledgment boundary, reconciliation path, test evidence, metrics, and replay/rollback controls.

## Error Handling

- Signature or raw body is unavailable: return a non-2xx rejection and perform no side effect.
- Processing fails after acknowledgment: retry from the durable inbox and reconcile provider state.
- Retries are exhausted or a terminal event is missing: poll the documented job status and paginate results.

## Examples

- "Add a crawl webhook" handles started/page/completed and reconciles status for failure.
- "Skip verification when the secret is unset" is explicitly rejected.

## Resources

Read [official Firecrawl evidence](references/official-docs.md) before relying on
an endpoint, SDK method, plan limit, price, retention option, or self-hosted release.

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

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

Все скиллы по теме «Бэкенд и API» →
scrapfly-webhooks hookdeck Скилл scrapfly-webhooks помогает настроить приём и проверку вебхуков Scrapfly для асинхронного скрапинга, скриншотов, извлечения данных и краулера. CX Codex +1 120установок firecrawl-build-scrape firecrawl Скилл firecrawl-build-scrape помогает встроить вызов Firecrawl /scrape в код продукта для извлечения данных со страницы. Он пригодится, когда URL уже известен и нужен чистый markdown или метаданные. CX Codex +1 63 000установок github-webhooks hookdeck Скилл github-webhooks для приёма и проверки вебхуков GitHub: подсказывает, как разобрать подпись и обработать события push, pull_request, issues и release. CX Codex +1 512установок firecrawl-build firecrawl Скилл firecrawl-build помогает встроить поиск, скрапинг и браузерные действия через Firecrawl прямо в код вашего приложения. CX Codex +1 5 400установок pp-firecrawl Hiten Shah Скилл pp-firecrawl управляет парсингом, краулингом и извлечением данных через Firecrawl CLI. Запускает поиск, сбор страниц и генерацию файлов LLMs.txt. CX Codex +1 641установок firecrawl-scrape parcadei Скилл firecrawl-scrape для Claude Code, Codex, Cursor и других агентов: скрейпит страницы через Firecrawl MCP и отдаёт контент в markdown, HTML или тексте. Запускается по URL или поисковому запросу. CX Codex +1 495установок

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

Весь набор →
fireflies-webhooks-events Скилл fireflies-webhooks-events проводит агента по сборке приёмника Fireflies Webhooks V2: проверка HMAC по сырому телу, белый список событий, дедупликация и быстрый ответ 2xx. CX Codex +1 1установок documenso-webhooks-events Скилл documenso-webhooks-events помогает настроить приём вебхуков сервиса Documenso. Пригодится при отслеживании подписания документов и передаче статусов во внешние сервисы. CX Codex +1 1установок windsurf-webhooks-events Скилл windsurf-webhooks-events для Claude Code создаёт расширения Windsurf на основе VS Code API и отправляет события рабочей области во внешнюю систему. Отслеживает сохранения, смену редактора и вывод терминала. CX Codex +1 1установок twinmind-webhooks-events Скилл twinmind-webhooks-events для обработки событий встреч TwinMind: завершение транскрипции, извлечение задач, уведомления о синхронизации календаря. CX Codex +1 1установок coderabbit-webhooks-events Скилл coderabbit-webhooks-events помогает спроектировать автоматизацию вокруг событий Git-провайдера, связанных с ревью CodeRabbit. Он пригодится для проверки подписей, фильтрации событий и безопасного тестирования обработчика. CX Codex +1 1установок posthog-webhooks-events Скилл posthog-webhooks-events создаёт вебхук-назначения PostHog через API, принимает их payload и делает ограниченные запросы к событиям через private API или HogQL. CX Codex +1 1установок instantly-webhooks-events Скилл instantly-webhooks-events помогает развернуть надёжный приёмник вебхуков Instantly API v2 с валидацией схем, дедупликацией событий и защитой секретов. CX Codex +1 1установок windsurf-data-handling Скилл windsurf-data-handling помогает описать потоки данных, настроить исключения контекста и собрать подтверждения для проверок приватности и соответствия. CX Codex +1 1установок

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

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