skill

Firecrawl Scrape

Read a known webpage or execute a discovered workflow or data-provider capability. Use for page content or structured results once the URL or tool is selected.

firecrawl84,050+ installsVetted

About

# firecrawl scrape

Read a URL for page content, or execute a selected provider tool for structured data. Discover tools with `search` and inspect their inputs with `list` before execution. Multiple URLs can be scraped concurrently.

For structured datasets, first check for a suitable workflow or data provider using the [search skill](../firecrawl-search/SKILL.md). Read a known page directly; reuse a selected contract instead of repeating discovery.

## Quick start

```bash # Basic markdown extraction firecrawl scrape "<url>" -o .firecrawl/page.md

# Keep the whole page, including nav/footer (main content only is the default) firecrawl scrape "<url>" --full-page -o .firecrawl/page.md

# Wait for JS to render, then scrape firecrawl scrape "<url>" --wait-for 3000 -o .firecrawl/page.md

# A few URLs (markdown only; each saved to .firecrawl/; -o is ignored) firecrawl scrape https://example.com https://example.com/blog https://example.com/docs

# Get markdown and links together firecrawl scrape "<url>" --format markdown,links -o .firecrawl/page.json

# Ask a question about the page firecrawl scrape "https://example.com/pricing" --query "What is the enterprise plan price?" ```

Run `firecrawl scrape --help` for the full option list.

**Done when:** the page content or provider result has been checked for errors and inspected in bounded sections to answer the request. Preserve source links and disclose partial results.

## Structured JSON from a page

Pass a JSON schema with the `json` format to get typed fields instead of markdown:

```bash firecrawl scrape "<url>" --format json \ --schema '{"type":"object","properties":{"plan":{"type":"string"},"price":{"type":"string"}},"required":["plan"]}' \ -o .firecrawl/pricing.json

# Large schemas: keep them in a file firecrawl scrape "<url>" --format json --schema-file schema.json -o .firecrawl/page.json ```

The result is under `.json` in the output. `--schema` only applies when `json` is in `--format`; add other formats with commas (`--format markdown,json`). For the same schema across many URLs, use `batch-scrape --schema` below.

## Many known URLs

Use `firecrawl batch-scrape` for a list of known URLs when you need formats other than markdown, JSON extraction, a webhook, or a job you can check later. Keep the multi-URL `scrape` above for a few pages of markdown.

```bash # Start a job (prints a job ID), then check it later firecrawl batch-scrape https://example.com/a https://example.com/b firecrawl batch-scrape <job-id>

# Wait and save every document as JSON (urls.txt: one URL per line, # comments ok) firecrawl batch-scrape --urls-file urls.txt --format markdown,links --wait -o .firecrawl/batch.json

# Same extraction for every URL (--schema or --prompt adds the json format) firecrawl batch-scrape --urls-file urls.txt --wait \ --schema '{"type":"object","properties":{"title":{"type":"string"}}}' -o .firecrawl/batch.json ```

Results are in `.data[]`, one document per URL with `metadata.sourceURL`. Add `--webhook <url>` to get notified, `--ignore-invalid-urls` to skip bad entries, and `--cancel` with a job ID to stop a job. Run `firecrawl batch-scrape --help` for all options.

## Find tools, inspect inputs, and get help

Use the CLI help to check supported options rather than guessing:

```bash firecrawl search --help firecrawl list --help firecrawl scrape --help ```

Domain discovery with `--domain-tools` returns tool summaries by default. Add `--tool-detail full` for contracts upfront, or inspect one selected tool with `list` as shown below. Use `--tool-detail compact` for only provider, capability and description; inspect by those two IDs with `list`. Summary remains the default. Prefer full when several related contracts will be needed immediately.

For structured data, search for the task, inspect a matching tool's contract, then execute with the exact input fields it declares:

```bash # Web + domain matching + semantic tools firecrawl search '<user question>'

# Semantic tools only firecrawl search alexandria '<user question>'

# Categories → providers → tools → contract firecrawl list firecrawl list <category-id> --category firecrawl list <provider-id> firecrawl list <provider-id> <capability-id> --pretty

# Execute a tool firecrawl scrape <provider-id>/<capability-id> --options '<JSON matching the selected contract>' ```

Normal search includes web results and tool matches; `search alexandria` searches tools only. `list <provider> <capability> --pretty` shows the selected contract; use `--json` for machine-readable output. To browse progressively, use `list`, then `list <category> --category`, then `list <provider>`. Search and list do not execute the selected provider tool. Read only the contracts needed for the task; use returned identifiers rather than guessing them.

Read the expanded contract before building inputs or parsing results:

- `required: true` requires that input; each `requiresOneOf` group requires at least one member, not all of the

Install

Run this command

npx skills add firecrawl/cli

Works with

claude appclaude codeclaude apicursorcodexwindsurfclinezed

Manual steps

Install with `npx skills add firecrawl/cli`, or clone the repository and copy the `skills/firecrawl-scrape` folder into your Claude skills directory.

View source

Frequently asked questions

What is the Firecrawl Scrape skill?

Read a known webpage or execute a discovered workflow or data-provider capability. Use for page content or structured results once the URL or tool is selected.

How do I install Firecrawl Scrape?

Run this in your terminal:

npx skills add firecrawl/cli
Which AI tools does Firecrawl Scrape work with?

It works with claude_app, claude_code, claude_api, cursor, codex, windsurf, cline, zed.

Who made Firecrawl Scrape?

firecrawl.

Is Firecrawl Scrape free?

Yes, it is free to use.

Related assets

More curated picks in Content Creation.

All Firecrawl Scrape alternatives →

Audit before you install

Run any source through our checks - AI visibility, security, performance, and stack detection.

More in Content Creation