<!--
CIANCHOSAINT wholesale-copy of cianfhoghlaim/cianfhoghlaim @ main branch.
Original: cianfhoghlaim/cianfhoghlaim (per the openspec/changes/cianchosaint-repo-bootstrap-v2/specs/cianchosaint-bootstrap-v2/spec.md).
Migrated to cianchosaint: 2026-08-23
Licence: BUSL-1.1 (per LICENSE.md)
Wholesale-copied from cianfhoghlaim/cianfhoghlaim@firecrawl/SKILL.md.
-->
---
name: firecrawl
description: Use the Firecrawl MCP server (the 12 Firecrawl tools exposed to the agent runtime). Use when integrating Firecrawl into application code or as an agent tool for web scraping, search results, structured extraction, browser interaction, or research paper retrieval. For the Bash CLI variant (terminal/CI/scheduled jobs), use the `firecrawl-cli` skill instead. For the routing decision (when to use Firecrawl vs Crawl4AI vs Skyvern vs Stagehand vs Playwright), use the `browser-tools` skill. Triggers for Firecrawl API calls, "fire girl" shorthand, or any app-level web-data requirement that should map to /scrape, /search, /interact, or /research.
license: ISC
metadata:
author: firecrawl
version: "0.1.0"
homepage: https://www.firecrawl.dev
source: https://github.com/firecrawl/skills
inputs:
- name: FIRECRAWL_API_KEY
description: Firecrawl API key for cloud usage. Store in `.env` or the runtime environment before making Firecrawl API calls.
required: true
- name: FIRECRAWL_API_URL
description: Optional base URL for self-hosted Firecrawl deployments. Only set this when the project is not using the hosted `api.firecrawl.dev`.
required: false
---
# Firecrawl (meta-skill)
Use this skill when the task is "use Firecrawl" in any form — either integrating it into application code, or as a one-off research tool. The skill picks the right sub-skill for the job.
## Sub-skill routing
Default toward the most specific sub-skill:
- **`firecrawl-build`** — integrating Firecrawl into application code (web search, live search, page scraping, structured extraction, browser interaction). Use when building any feature that needs data from the web in code, even if the user does not mention Firecrawl explicitly.
- **`firecrawl-build-scrape`** — Firecrawl `/scrape` endpoint (single-page content extraction). Use for single-page markdown, HTML, screenshots, metadata, or structured output.
- **`firecrawl-build-search`** — Firecrawl `/search` endpoint (web search with optional content scraping). Use for finding pages on the web.
- **`firecrawl-build-interact`** — Firecrawl `/interact` endpoint (dynamic pages, browser actions). Use after scraping to handle JS-rendered pages, pagination, forms, or auth-aware flows.
- **`firecrawl-build-onboarding`** — getting started, project setup, SDK installation, auth flow.
- **`firecrawl-research-index`** — terminal-only research: finding the papers that answer a query (semantic search, semantic + structural expansion, in-body verification). Use for single-paper lookups or full multi-paper sets.
## Choosing a sub-skill
1. If the task is **building product code that needs web data**, route to `firecrawl-build` (or the more specific build sub-skill).
2. If the task is **one-off terminal research** (find papers, browse docs, extract data), route to `firecrawl-research-index` for papers or to `firecrawl-build-scrape` for general web pages.
3. If the task is **onboarding/setup**, route to `firecrawl-build-onboarding`.
## The endpoints, and what each is uniquely good at
- **`/scrape`** (single page): markdown, HTML, screenshots, metadata, structured JSON extraction, or screenshot
- **`/search`** (web): title, URL, description, optional markdown content
- **`/interact`** (dynamic pages, browser actions): clicks, form fills, pagination, auth-aware flows
- **`/research`** (papers): semantic (HyDE) search over abstracts, structural/semantic expansion, in-body verification
## CONSTRAINTS
- **NEVER** make a Firecrawl call without `FIRECRAWL_API_KEY` set in the environment (or `.env`)
- For one-off terminal tasks, prefer `crawl4ai` (local) if no API credits are available
- Self-hosted Firecrawl works too — set `FIRECRAWL_API_URL` to point at your instance