← Back to Skills Marketplace
yash-kavaiya

Firecrawl CLI

by Yash Kavaiya · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
1597
Downloads
0
Stars
8
Active Installs
1
Versions
Install in OpenClaw
/install firecrawl-cli
Description
Web scraping, crawling, searching, and browser automation via the Firecrawl CLI (firecrawl). Use when scraping URLs to markdown/HTML, crawling entire website...
README (SKILL.md)

Firecrawl CLI

Installation & Auth

npm install -g firecrawl-cli
firecrawl login --browser        # Recommended for agents
# or
export FIRECRAWL_API_KEY=fc-YOUR-KEY
firecrawl --status               # Verify: shows credits + concurrency

Commands Summary

Command Purpose
firecrawl scrape \x3Curl> Scrape single URL
firecrawl search "\x3Cquery>" Web search (+ optional scrape)
firecrawl map \x3Curl> Discover all URLs on a site
firecrawl crawl \x3Curl> Crawl entire website (async job)
firecrawl browser Cloud browser sandbox automation
firecrawl agent "\x3Cprompt>" NL-driven web agent queries

Key Patterns

Scrape (most common):

firecrawl https://example.com --only-main-content          # Clean markdown
firecrawl https://example.com --format markdown,links      # Multiple formats → JSON
firecrawl https://example.com -o output.md                 # Save to file

Crawl a docs site:

firecrawl crawl https://docs.example.com --limit 50 --max-depth 2 --wait --progress -o docs.json

Browser automation (AI agents):

firecrawl browser launch-session
firecrawl browser execute "open https://example.com"
firecrawl browser execute "snapshot"     # Returns @ref IDs
firecrawl browser execute "click @e5"
firecrawl browser execute "scrape"
firecrawl browser close

AI agent query:

firecrawl agent "Find top 5 AI startups and funding" --wait
firecrawl agent "Compare pricing" --urls https://a.com,https://b.com --wait

Full Reference

See references/commands.md for all commands, options, and examples.

Tips

  • Use --only-main-content for clean article content (removes nav/footer)
  • crawl returns a job ID immediately — use --wait to block or poll with job ID later
  • Browser execute default mode is agent-browser (bash) — 40+ commands, best for agents
  • spark-1-mini (default) is 60% cheaper than spark-1-pro for agent queries
  • Check concurrency limit with --status before parallelizing scrape jobs
  • Self-hosted instances skip API key auth automatically when --api-url is set
Usage Guidance
This skill appears to be a wrapper around a third-party CLI that sends scraped pages and browser interactions to Firecrawl's cloud by default. Before installing or using it: 1) be aware the SKILL.md requires FIRECRAWL_API_KEY or interactive login even though the manifest lists no credentials — treat that as a red flag and don't blindly provide high-privilege credentials. 2) Prefer self-hosting (FIRECRAWL_API_URL) if you will scrape sensitive sites or want content to stay on-premises. 3) Vet the NPM package (publisher, package name, version, npmjs listing, GitHub repo and releases) before 'npm install -g', and avoid installing as root. 4) Assume web content and interactions will be transmitted to the service; do not run against sites that contain secrets, authentication cookies, internal URLs, or PII. 5) Consider creating a limited-scope API key for testing, set FIRECRAWL_NO_TELEMETRY=1 if you want to disable CLI telemetry, and test with non-sensitive URLs first. 6) If you need to allow autonomous agent invocation, restrict which prompts/tasks it can run and monitor job outputs. If the publisher or package source is unknown or unverifiable, treat this as higher risk and ask for more publisher/source information before proceeding.
Capability Analysis
Type: OpenClaw Skill Name: firecrawl-cli Version: 1.0.0 The skill bundle provides a legitimate interface for the Firecrawl CLI, a tool used for web scraping, crawling, and browser automation. It includes comprehensive documentation for commands such as `scrape`, `crawl`, and `browser execute`, the latter of which allows for sandboxed code execution as part of its cloud automation features. While the tool handles sensitive data like API keys and possesses powerful network/execution capabilities, these are strictly aligned with its stated purpose as a web automation utility, and no evidence of malicious intent, data exfiltration, or prompt injection was found.
Capability Assessment
Purpose & Capability
The skill claims to provide Firecrawl CLI functionality (scrape, crawl, browser automation) which legitimately requires installing a CLI and authenticating with a FIRECRAWL_API_KEY or interactive login. However, the registry metadata lists no required environment variables or credentials. That omission is an incoherence: the skill will not function as described without external credentials or a self-hosted API URL, so the manifest under-declares its needs.
Instruction Scope
SKILL.md tells the agent to install and use the firecrawl CLI and to run commands that send target URLs and scraped content to Firecrawl's cloud (or to a self-hosted API). It includes browser sandbox automation and execution of Playwright/Python/Node snippets in remote sessions. Those capabilities allow arbitrary remote execution of page interactions and transmission of scraped content to an external service — a meaningful data-exfiltration surface. The instructions do not ask the agent to read unrelated local files, but they do rely on sending web content and potentially user-provided URLs to a third party.
Install Mechanism
This is an instruction-only skill (no install spec). The SKILL.md instructs users/agents to run 'npm install -g firecrawl-cli', which is a normal public-registry installation but is not automatically verified by the skill. Instruction-only avoids writing code to disk from the skill itself (lower risk), but installing a third-party npm package still carries supply-chain risk and should be vetted by the user.
Credentials
The documentation references FIRECRAWL_API_KEY, FIRECRAWL_API_URL, and FIRECRAWL_NO_TELEMETRY, but the skill manifest lists no required env vars/credentials. Requesting an API key (or doing an interactive login) is expected for this functionality, but the manifest's failure to declare these credentials is an inconsistency that impairs an informed security decision. Requiring an API key is proportionate to the purpose, but the skill could be used to send sensitive page content to the vendor unless the user self-hosts.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent platform privileges. Autonomous invocation (disable-model-invocation=false) is the platform default; by itself this is not flagged. The skill does not claim to modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install firecrawl-cli
  3. After installation, invoke the skill by name or use /firecrawl-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - scrape, crawl, search, map, browser, and agent commands
Metadata
Slug firecrawl-cli
Version 1.0.0
License MIT-0
All-time Installs 9
Active Installs 8
Total Versions 1
Frequently Asked Questions

What is Firecrawl CLI?

Web scraping, crawling, searching, and browser automation via the Firecrawl CLI (firecrawl). Use when scraping URLs to markdown/HTML, crawling entire website... It is an AI Agent Skill for Claude Code / OpenClaw, with 1597 downloads so far.

How do I install Firecrawl CLI?

Run "/install firecrawl-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Firecrawl CLI free?

Yes, Firecrawl CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Firecrawl CLI support?

Firecrawl CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Firecrawl CLI?

It is built and maintained by Yash Kavaiya (@yash-kavaiya); the current version is v1.0.0.

💬 Comments