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

firecrawl-migration-deep-dive — скилл для Claude Code

Скилл firecrawl-migration-deep-dive помогает заменить Puppeteer, Playwright, Cheerio или другой скрейпер на Firecrawl v2 с проверкой паритета, политик, стоимости и отката.

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

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

Что делает firecrawl-migration-deep-dive

Скилл разбирает текущий скрейпинговый адаптер: источники, сессии входа, селекторы, действия, форматы, парсеры, повторы, прокси, расписания, хранилище и метрики. Затем он сопоставляет эти требования с возможностями Firecrawl v2, отмечает Cloud-only и self-hosted-зависимости и задаёт контракт адаптера с эталонным синтетическим набором данных.

Новая ветка запускается за feature flag, а старая сохраняется для теневого сравнения. Скилл предлагает проверять контент, метаданные, задержку, стоимость, безопасность и откат до поэтапного перевода трафика. Он работает с Read, Glob, Grep, Write и Edit, но сам не вызывает Firecrawl, не меняет ключи и не запускает деплой. Для операций Firecrawl Cloud нужен сетевой доступ; для аутентифицированных запросов требуется FIRECRAWL_API_KEY из одобренного менеджера секретов.

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

  • сопоставить возможности старого скрейпера и Firecrawl v2
  • зафиксировать контракт адаптера и критерии паритета
  • сравнить результаты двух путей без повторной записи данных
  • подготовить поэтапный перевод трафика и откат
  • найти требования, для которых Firecrawl не подходит

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

  • Проведи миграцию на Firecrawl для репозитория <repository-path> и адаптера <legacy-adapter>.
  • Замени скрейпинг на Playwright и составь карту возможностей, эталонный набор данных и план теневого запуска.
  • Проверь, можно ли перейти на Firecrawl, сравни стоимость и подготовь доказательства для отката.

Как установить firecrawl-migration-deep-dive

1Через Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a claude-code

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

~/.claude/skills/firecrawl-migration-deep-dive/SKILL.md

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

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

Вопросы о firecrawl-migration-deep-dive

Как установить firecrawl-migration-deep-dive в Claude Code?

Выполните npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a claude-code, затем проверьте файл ~/.claude/skills/firecrawl-migration-deep-dive/SKILL.md.

Что делает firecrawl-migration-deep-dive?

Скилл помогает заменить существующий скрейпинговый адаптер на Firecrawl v2. Он собирает карту возможностей, задаёт критерии паритета, сравнивает старый и новый путь и формирует план раскатки с откатом.

Что нужно для миграции на Firecrawl Cloud?

Нужен сетевой доступ к Firecrawl Cloud. Для аутентифицированных операций ключ FIRECRAWL_API_KEY нужно передавать через одобренный менеджер секретов, не помещая его в URL или код.

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

SKILL.md · MIT
---
name: firecrawl-migration-deep-dive
description: >-
  Migrate a custom Puppeteer, Playwright, Cheerio, or third-party scraping workload to Firecrawl v2 with parity, policy, cost, and rollback evidence. Use when replacing an existing acquisition system. Trigger with "migrate to Firecrawl", "replace Playwright scraping", or "Firecrawl adoption".
allowed-tools: Read,Glob,Grep,Write,Edit
argument-hint: "<repository-path> <legacy-adapter>"
version: 1.12.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags: [saas, firecrawl, migration, architecture]
model: inherit
effort: high
compatibility: "Designed for Claude Code; Firecrawl Cloud work requires network access"
---
# Firecrawl Workload Migration

## Overview

Replace a scraper only after defining observable equivalence. Preserve the old adapter until the new path meets content, policy, performance, and recovery gates.

## 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 can replace rendering, crawl discovery, mapping, search, parsing, and typed extraction, but one endpoint is not equivalent to every legacy workflow. Scrape, crawl, map, batch, parse, JSON extraction, actions, Browser, and Cloud/self-hosted capabilities have different contracts and costs.

## 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. Inventory legacy sources, login/session behavior, selectors/actions, discovery rules, formats, parsers, retries, proxies, schedules, storage, compliance controls, metrics, and operating cost.
2. Create a source-to-Firecrawl capability map. Mark unsupported, Cloud-only, self-host-dependent, behavior-changing, and policy-sensitive requirements.
3. Define an adapter contract and golden synthetic corpus with provenance, normalized content hashes, required-field coverage, latency, cost, and accepted variance.
4. Implement the smallest v2 path behind a feature flag. Keep target authorization, explicit scope/limits, cache/retention, cancellation, and error typing visible.
5. Shadow both paths on approved canaries, compare content and metadata without duplicating downstream writes, and investigate meaningful differences.
6. Shift traffic in stages only after parity, security, spend, load, and rollback gates pass. Keep the old path available through the observation window.
7. Remove legacy code and secrets only after rollback expiry, archive the decision and evidence, and verify dependency and data cleanup.

## 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 replaying authenticated sessions, changing target behavior or proxies, enabling Cloud-only processing, increasing spend, shifting traffic, or deleting the legacy path.

## Output

Return the capability matrix, parity definition, adapter design, golden corpus, shadow results, cost and risk comparison, staged rollout, rollback evidence, and deferred gaps.

## Error Handling

- Required behavior has no Firecrawl equivalent: retain that legacy component or redesign explicitly.
- Shadow outputs contain sensitive differences: quarantine the comparison and use content-free metrics.
- Parity cannot be measured: block migration rather than accepting visual inspection alone.

## Examples

- "Replace our docs crawler" maps discovery, rendering, filters, retries, and indexing before shadowing.
- "Delete Playwright first" is rejected until Firecrawl parity and rollback are proven.

## 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

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

Все скиллы по теме «Браузер и парсинг» →
firecrawl-build-scrape firecrawl Скилл firecrawl-build-scrape помогает встроить вызов Firecrawl /scrape в код продукта для извлечения данных со страницы. Он пригодится, когда URL уже известен и нужен чистый markdown или метаданные. CX Codex +1 63 000установок 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установок Browser Automation Claude Office Skills Скилл Browser Automation для Claude Code управляет браузером через Puppeteer/Playwright: открывает страницы, нажимает элементы и извлекает данные. Включается для скрейпинга, проверок и автоматизации веб-сценариев. CX Codex +1 5 400установок firecrawl-scrape parcadei Скилл firecrawl-scrape для Claude Code, Codex, Cursor и других агентов: скрейпит страницы через Firecrawl MCP и отдаёт контент в markdown, HTML или тексте. Запускается по URL или поисковому запросу. CX Codex +1 495установок firecrawl-scraper davila7 Скилл firecrawl-scraper для Claude Code, который берёт страницы с интерактивным контентом, снимает скриншоты, разбирает PDF и обходит сайты пачками. Запускается через Firecrawl API — ключ нужно прописать заранее. CX Codex +1 407установок

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

Весь набор →
klingai-usage-analytics Скилл klingai-usage-analytics настраивает учёт генераций видео в Kling AI, считая потраченные кредиты и ошибки по логам JSONL. Помогает следить за расходами на видео. CX Codex +1 1установок 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установок vercel-webhooks-events Скилл vercel-webhooks-events для Claude Code, Codex, Cursor и других платформ обрабатывает события развёртывания Vercel с проверкой подписи HMAC. 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установок

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

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