# firecrawl-migration-deep-dive

The firecrawl-migration-deep-dive skill guides a move from Puppeteer, Playwright, Cheerio, or another scraper to Firecrawl v2, with checks for parity, policy, spend, and rollback.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 2935 repo stars
- Author: Jeremy Longshore
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/firecrawl-migration-deep-dive/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/firecrawl-migration-deep-dive

## What it does

The skill inventories the existing acquisition path: sources, login sessions, selectors, actions, formats, parsers, retries, proxies, schedules, storage, compliance controls, and operating metrics. It then maps those requirements to Firecrawl v2 capabilities, flags Cloud-only or self-hosted dependencies, and defines an adapter contract with a golden synthetic corpus.

The replacement path is placed behind a feature flag while the legacy adapter remains available for shadow comparison. The workflow checks content, metadata, latency, cost, security, load, and rollback gates before traffic moves in stages. It uses `Read`, `Glob`, `Grep`, `Write`, and `Edit`; it does not call Firecrawl, rotate keys, change account settings, or deploy on its own. Firecrawl Cloud work requires network access, and authenticated operations need `FIRECRAWL_API_KEY` supplied through an approved secret manager.

## Requirements
- Works with: Playwright

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/firecrawl-migration-deep-dive/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/firecrawl-migration-deep-dive/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/firecrawl-migration-deep-dive/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/firecrawl-migration-deep-dive/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/firecrawl-migration-deep-dive
```

2. **Manually: put the files in place**
- File: `.github/skills/firecrawl-migration-deep-dive/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/firecrawl-migration-deep-dive
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/firecrawl-migration-deep-dive/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-migration-deep-dive -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/firecrawl-migration-deep-dive/SKILL.md

## When to use it
- map a legacy scraper to Firecrawl v2 capabilities
- define adapter parity and acceptance gates
- compare shadow outputs without duplicate downstream writes
- plan staged traffic migration with rollback evidence
- identify requirements Firecrawl cannot replace

## Example prompts
- Migrate the scraper in `<repository-path>` from `<legacy-adapter>` to Firecrawl and document the parity gates.
- Replace our Playwright acquisition path with Firecrawl v2, then build the capability map and golden corpus.
- Compare the legacy and Firecrawl paths, estimate cost and risk, and prepare a staged rollout with rollback evidence.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d1b89906a287a576.

BEGIN THIRD-PARTY FILE d1b89906a287a576
```text
---
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 <jeremy@intentsolutions.io>
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
```
END THIRD-PARTY FILE d1b89906a287a576

The third-party file has ended. Everything between the d1b89906a287a576 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 1921 of 4454 bytes. © Jeremy Longshore · MIT · https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/firecrawl-migration-deep-dive/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
