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.

Security Scan

The skill's code and instructions match its stated web-scraping purpose, but the registry metadata omits the required FIRECRAWL_API_KEY and the source/homepage is unknown — an inconsistency you should resolve before trusting it.

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.

What to consider before installing

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.

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.