firecrawl-migration-deep-dive — скилл для Claude Code
Скилл firecrawl-migration-deep-dive помогает заменить Puppeteer, Playwright, Cheerio или другой скрейпер на Firecrawl v2 с проверкой паритета, политик, стоимости и отката.
MIT 1 установок ★ 2 935 обновлён 2026-10-29
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/firecrawl-migration-deep-dive/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/firecrawl-migration-deep-dive/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a codex2Вручную: положить файлы
.agents/skills/firecrawl-migration-deep-dive/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a cursor2Вручную: положить файлы
.cursor/skills/firecrawl-migration-deep-dive/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/firecrawl-migration-deep-dive2Вручную: положить файлы
.github/skills/firecrawl-migration-deep-dive/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/firecrawl-migration-deep-diveВручную: положить файлы
.devin/skills/firecrawl-migration-deep-dive/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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