firecrawl

🔥 Firecrawl CLI

Command-line interface for Firecrawl. Search, scrape, interact, crawl, map, and run agent jobs directly from your terminal.

Installation

npm install -g firecrawl-cli

Or set up everything in one command (install CLI globally, authenticate, and add skills across all detected coding editors):

npx -y [email protected] init -y --browser

• -y runs setup non-interactively
• --browser opens the browser for Firecrawl authentication automatically
• skills install globally to every detected AI coding agent by default

Setup Skills, Workflows, and MCP

If you are using an AI coding agent like Claude Code, you can also install the skills manually:

firecrawl setup skills
firecrawl setup workflows

These install globally across all detected coding editors by default. Use --agent <agent> to scope either command to one editor.

Scope setup to a single harness

By default skills route to every detected harness. To install and route to only one harness in a single command:

# One-shot from the install script (non-interactive, no TTY needed)
curl -fsSL https://firecrawl.dev/install.sh | bash -s -- --agent openclaw

# Or, once the CLI is installed
firecrawl init --agent openclaw          # only OpenClaw
firecrawl setup skills --agent openclaw
firecrawl setup workflows --agent openclaw

Any args after bash -s -- are forwarded to firecrawl init, so you can add things like --skip-auth for a skills-only, no-login setup. When you run firecrawl init interactively without --agent, it shows a checkbox of your detected harnesses (all selected by default) so you can pick a subset.

Harness	--agent value
Claude Code	claude-code
Codex	codex
Cursor	cursor
Windsurf	windsurf
OpenCode	opencode
OpenClaw	openclaw
OpenHands	openhands
Hermes Agent	hermes-agent

Agent skills

The init command installs all Firecrawl agent skill segments into AI coding agents (Cursor, Claude Code, Windsurf, etc.):

• CLI skills — teach agents how to use the Firecrawl CLI for live web work (search, scrape, interact, map, crawl, agent)
• Build skills — teach agents how to integrate Firecrawl into application code (choose endpoints, wire SDKs, set up API keys)
• Workflow skills — teach agents how to produce Firecrawl-powered deliverables such as research briefs, SEO audits, QA reports, lead lists, knowledge bases, and design-system extraction

To reinstall skills manually:

firecrawl setup skills
firecrawl setup workflows

To install the Firecrawl MCP server into your editors (Cursor, Claude Code, VS Code, etc.):

firecrawl setup mcp

To make Firecrawl the default web provider for supported AI agents:

firecrawl setup defaults    # or: firecrawl make default

This disables native web fetch/search where supported so agents route web work through Firecrawl. When run interactively, it asks harness by harness (Claude Code, Codex) so you can choose exactly which to change. Use -y to skip the picker and apply to all, or --agent to target one:

firecrawl setup defaults --agent codex      # only Codex
firecrawl setup defaults -y                  # all harnesses, no prompts

To undo those config changes (also interactive, harness by harness):

firecrawl setup defaults --undo              # pick which to restore
firecrawl setup defaults --undo --agent claude

Quick Start

Just run a command - the CLI will prompt you to authenticate if needed:

firecrawl https://example.com

Authentication

On first run, you'll be prompted to authenticate:

  🔥 firecrawl cli
  Search, scrape, and interact with the web

Welcome! To get started, authenticate with your Firecrawl account.

  1. Login with browser (recommended)
  2. Enter API key manually

Tip: You can also set FIRECRAWL_API_KEY environment variable

Enter choice [1/2]:

Authentication Methods

# Interactive (prompts automatically when needed)
firecrawl

# Browser login
firecrawl login

# Direct API key
firecrawl login --api-key fc-your-api-key

# Environment variable
export FIRECRAWL_API_KEY=fc-your-api-key

# Per-command API key
firecrawl scrape https://example.com --api-key fc-your-api-key

Self-hosted / Local Development

For self-hosted Firecrawl instances or local development, use the --api-url option:

# Use a local Firecrawl instance (no API key required)
firecrawl --api-url http://localhost:3002 scrape https://example.com

# Or set via environment variable
export FIRECRAWL_API_URL=http://localhost:3002
firecrawl scrape https://example.com

# Self-hosted with API key
firecrawl --api-url https://firecrawl.mycompany.com --api-key fc-xxx scrape https://example.com