firecrawl

Route web search, scraping, crawling, and extraction tasks through the installed Firecrawl CLI with safety gates.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/skills --skill firecrawl-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firecrawl
Source: https://github.com/leonardoacosta/skills/tree/main/firecrawl-kit/skills/firecrawl
Command: npx skills add https://github.com/leonardoacosta/skills --skill firecrawl-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Web research and scraping tasks often involve unsafe URL handling, leaked API keys, unbounded crawls, and ad hoc transport switching. This Skill enforces a disciplined, CLI-first workflow for Firecrawl operations with strict URL validation, secret handling, consent gates, and evidence scrubbing. ## Core Features & Use Cases - Intent-based command routing: Maps each request to the narrowest Firecrawl CLI command (search, scrape, map, crawl, interact, parse, monitor, research, agent, doctor) across four intent paths covering live data, shipped integrations, repeatable deliverables, and recovery. - Central URL and argv safety gate: Enforces no-shell literal argv, HTTPS-only URLs, DNS resolution checks against private or reserved ranges, and per-redirect revalidation to prevent SSRF. - Secret and evidence hygiene: Prohibits API keys in argv, mandates secure credential stores, and requires scrubbed, permission-restricted evidence files with retention and cleanup tracking. - Use Case: A user asks to collect every page in a site's /guides section for a market brief. The Skill selects the crawl path, validates all URLs through the safety gate, bounds the crawl scope, and retains only scrubbed source URLs and assertions as traceable evidence. ## Quick Start Ask the agent to scrape a known public URL with Firecrawl, and it will verify the installed CLI, apply the URL safety gate, and run the narrowest scrape command.

Frequently Asked Questions about firecrawl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape a URL with the Firecrawl CLI?

Run firecrawl scrape after inspecting the installed help for exact syntax. The Skill validates the URL first: HTTPS only, no userinfo, public DNS resolution, and literal argv without shell interpolation.

How do I choose between Firecrawl search, map, crawl, and scrape?

Use search when no URL is known, scrape for a known URL, map to locate pages within a known site, and crawl for bounded multi-page extraction. The Skill routes each intent to the narrowest supported command.

Can I use the Firecrawl SDK or MCP instead of the CLI?

An official SDK is allowed only in shipped application code, never for agent-side work. MCP or direct REST requires proof the CLI lacks the capability plus explicit named approval for one exact fallback.

Is it safe to pass the Firecrawl API key as a command argument?

No. API keys must never appear in argv, shell history, logs, or evidence. Use the CLI's secure credential store or an inherited environment variable from an approved secret mechanism.

What happens when a Firecrawl job fails?

The Skill enters its recovery path: run firecrawl doctor, optionally with the job ID, remediate through the CLI only, then retry the smallest failed operation. Missing product capabilities produce a gap report instead.

Does Firecrawl parsing of local files send data externally?

Yes, parsing uploads file contents to Firecrawl. The Skill requires disclosing this egress and obtaining explicit approval for confidential, personal, or regulated content before any upload.