Skip to content

cianfhoghlaim/cianchosaint / .agents/skills/firecrawl-cli

firecrawl-cli

Verified


name: firecrawl-cli description: The Bash CLI variant of the Firecrawl skill. Use when running Firecrawl from a terminal, CI pipeline, or scheduled job (no agent runtime). Covers the firecrawl CLI binary + the 12 subcommands (scrape, crawl, search, extract, map, agent, deep-research, browser-sandbox, monitor, batch, download, feedback). Triggers: 'firecrawl CLI', 'firecrawl batch', 'firecrawl monitor', 'firecrawl browser-sandbox', 'firecrawl from terminal', 'firecrawl in CI'.

Firecrawl CLI — Bash Variant

This skill is the Bash CLI variant of the Firecrawl skill. The other variant is the MCP variant (see firecrawl/SKILL.md), which exposes Firecrawl as MCP tools for the agent runtime.

The two are functionally equivalent for the 4 core endpoints (scrape, crawl, search, extract). The CLI is preferred when:

  • Running in CI / scheduled jobs (no agent runtime).
  • Needing a specific endpoint the MCP doesn't expose (e.g. firecrawl monitor, firecrawl browser-sandbox).
  • Working from a terminal where you want the human-readable progress output (e.g. for ad-hoc research tasks).

Installation

# Install the Firecrawl CLI
npm install -g firecrawl-cli

# Or use the npx pattern (no install)
npx firecrawl --help

# Or via the Cianfhoghlaim mise task (preferred in Cianfhoghlaim)
mise run firecrawl:cli -- --help

Authentication

The CLI reads the FIRECRAWL_API_KEY from the environment. In Cianfhoghlaim, this is auto-hydrated via the Infisical dev-baile vault (set the env var to infisical://dev-baile/firecrawl/api_key).

# Check auth
firecrawl auth status

The 12 subcommands

Core (4 — covered by both CLI and MCP)

# 1. scrape — single page to markdown
firecrawl scrape https://example.com --format markdown --only-main-content

# 2. crawl — recursive crawl of a site
firecrawl crawl https://docs.example.com --limit 100 --include-paths /api

# 3. search — web search with content scraping
firecrawl search "Celtic education Ireland" --limit 10 --provider "sambanova"

# 4. extract — structured extraction with a JSON schema
firecrawl extract https://example.com/product \
  --schema '{"name":"string","price":"number","inStock":"boolean"}'

Advanced (8 — CLI only or CLI-primary)

# 5. map — sitemap discovery
firecrawl map https://example.com --search "API docs" --limit 50

# 6. agent — autonomous research
firecrawl agent \
  --goal "Identify all research papers on Irish NLP from 2020-2025" \
  --max-steps 10

# 7. deep-research — multi-step research with citations
firecrawl deep-research \
  --topic "Celtic curriculum knowledge graphs" \
  --max-depth 3 \
  --output-format "markdown+citations"

# 8. browser-sandbox — interactive browser session
firecrawl browser-sandbox --url https://example.com/login \
  --interactive --timeout 60000

# 9. monitor — recurring scrape with change detection
firecrawl monitor create --url https://example.com \
  --goal "Alert on breaking changes" --schedule "every 6 hours"

# 10. batch — scrape many URLs in parallel
firecrawl batch urls.txt --format markdown --concurrency 5

# 11. download — full-website capture
firecrawl download https://example.com --output ./snapshot --format html

# 12. feedback — submit endpoint-quality feedback
firecrawl feedback --job-id "abc-123" --rating good --note "Excellent"

Output formats (12)

FormatCostUse case
markdown1 creditDefault; LLM-ready content
summary1 creditConcise summary
html1 creditCleaned HTML
rawHtml1 creditUnmodified HTML
screenshot1 creditPage screenshot (URL expires in 24h)
links1 creditAll link URLs
json1 creditStructured JSON (with schema)
changeTrackingvariesPer-field diffs (JSON path → {previous, current})
branding5 creditsBrand identity (colors, fonts, design system)
product1 creditDeterministic product extraction
audio5 creditsMP3 from supported video URLs
video5 creditsBest-quality video from supported URLs

When to use CLI vs MCP

Use CLI when:

  • Running in CI / scheduled jobs (no agent runtime).
  • Needing a specific endpoint the MCP doesn't expose (firecrawl monitor, firecrawl browser-sandbox).
  • Working from a terminal where you want the human-readable progress output (e.g. for ad-hoc research tasks).
  • Needing a one-off ad-hoc invocation with custom flags (e.g. --proxy stealth, --zero-data-retention).

Use MCP (firecrawl/SKILL.md) when:

  • The agent runtime has the Firecrawl MCP server configured (the Cianfhoghlaim default; the MCP tools are visible in the agent's tool palette).
  • The agent needs to compose Firecrawl calls in a multi-step workflow.
  • You're building an agentic feature that needs Firecrawl as a tool (not a script).

Cross-references

  • The router skill: browser-tools/SKILL.md
  • The MCP variant: firecrawl/SKILL.md
  • The browser stack YAML files: bonneagar/stacks/browser/
  • The Infisical vault: dev-baile/firecrawl/* (8 secrets)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 193kUpdated Claude CodeCodexVerifiedInstall