← Back to Skills Marketplace
capt-marbles

Firecrawler

by captmarbles · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
3723
Downloads
2
Stars
9
Active Installs
1
Versions
Install in OpenClaw
/install firecrawler
Description
Web scraping and crawling with Firecrawl API. Fetch webpage content as markdown, take screenshots, extract structured data, search the web, and crawl documentation sites. Use when the user needs to scrape a URL, get current web info, capture a screenshot, extract specific data from pages, or crawl docs for a framework/library.
README (SKILL.md)

Firecrawl Web Skill

Scrape, search, and crawl the web using Firecrawl.

Setup

  1. Get your API key from firecrawl.dev/app/api-keys
  2. Set the environment variable:
    export FIRECRAWL_API_KEY=fc-your-key-here
    
  3. Install the SDK:
    pip3 install firecrawl
    

Usage

All commands use the bundled fc.py script in this skill's directory.

Get Page as Markdown

Fetch any URL and convert to clean markdown. Handles JavaScript-rendered content.

python3 fc.py markdown "https://example.com"
python3 fc.py markdown "https://example.com" --main-only  # skip nav/footer

Take Screenshot

Capture a full-page screenshot of any URL.

python3 fc.py screenshot "https://example.com" -o screenshot.png

Extract Structured Data

Pull specific fields from a page using a JSON schema.

Schema example (schema.json):

{
  "type": "object",
  "properties": {
    "title": { "type": "string" },
    "price": { "type": "number" },
    "features": { "type": "array", "items": { "type": "string" } }
  }
}
python3 fc.py extract "https://example.com/product" --schema schema.json
python3 fc.py extract "https://example.com/product" --schema schema.json --prompt "Extract the main product details"

Web Search

Search the web and get content from results (may require paid tier).

python3 fc.py search "Python 3.13 new features" --limit 5

Crawl Documentation

Crawl an entire documentation site. Great for learning new frameworks.

python3 fc.py crawl "https://docs.example.com" --limit 30
python3 fc.py crawl "https://docs.example.com" --limit 50 --output ./docs

Note: Each page costs 1 credit. Set reasonable limits.

Map Site URLs

Discover all URLs on a website before deciding what to scrape.

python3 fc.py map "https://example.com" --limit 100
python3 fc.py map "https://example.com" --search "api"

Example Prompts

  • "Scrape https://blog.example.com/post and summarize it"
  • "Take a screenshot of stripe.com"
  • "Extract the name, price, and features from this product page"
  • "Crawl the Astro docs so you can help me build a site"
  • "Map all the URLs on docs.stripe.com"

Pricing

Free tier includes 500 credits. 1 credit = 1 page/screenshot/search query.

Usage Guidance
This skill appears to be a thin wrapper over the Firecrawl SDK and behaves as advertised, but the registry metadata incorrectly omits the required FIRECRAWL_API_KEY and the skill's source/homepage is unknown. Before installing: (1) verify the publisher and the 'firecrawl' PyPI package (check project homepage, maintainers, and recent releases), (2) confirm you are comfortable providing your FIRECRAWL_API_KEY (it will be sent to the Firecrawl service), (3) review pricing/credit usage to avoid unexpected charges, and (4) avoid using the key in environments with sensitive internal-only URLs unless you trust the Firecrawl service and the skill source. If you want higher assurance, request the skill author to correct the metadata to declare the required env var and provide a homepage/source repository.
Capability Analysis
Type: OpenClaw Skill Name: firecrawler Version: 1.0.0 The skill is designed for web scraping and crawling using the Firecrawl API. The `SKILL.md` provides clear, benign instructions for the AI agent and user, with no evidence of prompt injection attempts. The `fc.py` script implements the stated functionality, primarily interacting with the `firecrawl` Python library and the Firecrawl API. It correctly handles API key retrieval from environment variables and performs file I/O (reading JSON schema, writing screenshots, and crawled markdown files) strictly within the scope of its stated purpose. There is no evidence of data exfiltration, malicious execution, persistence, or obfuscation.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md and fc.py all implement web scraping, screenshots, extraction, search, crawling and mapping via the Firecrawl API — capabilities are coherent with the stated purpose. However the registry metadata declared no required environment variables while both SKILL.md and fc.py require FIRECRAWL_API_KEY, which is an inconsistency.
Instruction Scope
Runtime instructions are limited to installing the firecrawl SDK, setting FIRECRAWL_API_KEY, and running the bundled fc.py to call the Firecrawl API. The instructions do not ask the agent to read unrelated system files, secrets, or transmit data to unexpected endpoints.
Install Mechanism
There is no install spec in the registry and the skill is instruction-only, but SKILL.md instructs users to pip3 install the public 'firecrawl' Python package. This is a normal installation method; no direct downloads from arbitrary URLs or archive extraction are present in the skill itself.
Credentials
The code and SKILL.md both require FIRECRAWL_API_KEY (used as the SDK credential) which is appropriate for this service. However the registry metadata lists 'Required env vars: none' and 'Primary credential: none' — a mismatch that hides the need for an API key. The skill does not request additional unrelated credentials.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It can be invoked autonomously (platform default), which increases blast radius if the API key is present, but this is expected for skills and not flagged alone.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install firecrawler
  3. After installation, invoke the skill by name or use /firecrawler
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - markdown, screenshot, extract, search, crawl, map
Metadata
Slug firecrawler
Version 1.0.0
License
All-time Installs 10
Active Installs 9
Total Versions 1
Frequently Asked Questions

What is Firecrawler?

Web scraping and crawling with Firecrawl API. Fetch webpage content as markdown, take screenshots, extract structured data, search the web, and crawl documentation sites. Use when the user needs to scrape a URL, get current web info, capture a screenshot, extract specific data from pages, or crawl docs for a framework/library. It is an AI Agent Skill for Claude Code / OpenClaw, with 3723 downloads so far.

How do I install Firecrawler?

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

Is Firecrawler free?

Yes, Firecrawler is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Firecrawler support?

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

Who created Firecrawler?

It is built and maintained by captmarbles (@capt-marbles); the current version is v1.0.0.

💬 Comments