Spiral gives your agent every tool with one account. Browse the tools →

Claude · Web

How to Use Firecrawl web research in Claude

Firecrawl web research returns structured JSON gathered from websites it searches and navigates. Use it to assemble research across pages when finding the sources is part of the job.

Prompts to try with Firecrawl web research in Claude

Copy an example into Claude, or ask in your own words.

Use Firecrawl web research to compare the collaboration features described on Notion, Asana, and Trello's official websites. Give me a table with supporting links.

Firecrawl web researchClaude
Try asking
  • Use Firecrawl web research to find 15 arXiv papers about retrieval-augmented generation published in the last 30 days. Return titles, abstracts, publication dates, and links.

  • Use Firecrawl web research to compare opening hours and accessibility information from the official websites of the Field Museum, Shedd Aquarium, and Adler Planetarium in Chicago.

  • Use Firecrawl web research to collect the product names and technical specifications of Sony's current full-frame mirrorless cameras from its US website.

  • Use Firecrawl web research to find 20 Y Combinator W24 companies. Return each company's name, official website, and product description.

How to set up Firecrawl web research in Claude

Pick the way that suits you. Each takes about two minutes.

Use the Claude connector

  1. Add Spiral to Claude

    Click Add Spiral in Claude above. Claude opens Add custom connector with Spiral and its URL filled in; check them and click Continue. Without the link: in Claude open Customize › Connectors › Add › Add custom connector and paste this URL:

    https://api.spiral.ai/mcp
  2. Keep the detected sign-in and click Add

    Claude finds Spiral's sign-in by itself: leave Sign in now and Use Claude's published identity selected.

  3. Click Connect

    The connector page opens. Connect takes you to Spiral in your browser.

Use the Spiral skill

  1. Send Claude this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Firecrawl web research

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "firecrawl",
        "model": "firecrawl/agent",
        "input": {
          "prompt": "<prompt>"
        }
      }'

Then paste one of the prompts above: Claude finds Firecrawl web research on Spiral, shows the price and runs it.

Firecrawl web research providers and prices

Spiral runs Firecrawl web research through Firecrawl. Open a card for today's price, with every fee included.

FirecrawlWeb

Settings you can ask for

Firecrawl web research works from your prompt. Ask Claude for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Modeextract or chatextract

extract returns the complete structured result in data every turn. chat lets a follow-up that asks for no new data get a short reply in message instead of a re-run. exchange.requireApproval needs chat on the same request. Omitted on a follow-up turn keeps the thread's mode.

Safeon or off

When true, every web search the agent makes during the run filters explicit content, the same filter as the search endpoint's safe option. Pages the agent scrapes or opens in a browser are not filtered. Omit to keep the default behavior, which does not apply the filter. Omitted on a follow-up turn keeps the thread's setting; false turns it off.

Modelspark-2, spark-1-mini, or spark-1-prospark-2

The model to use for the agent task. spark-2 is the default and the model every run executes on. The Spark 1 model names remain accepted for backwards compatibility but are deprecated and route to spark-2.

Effortlow, medium, or high

Reasoning budget for the agent task. Every run executes on spark-2, so effort can be sent with or without model.

Max creditsa number

Maximum credits to spend on this agent task. Defaults to 2500 if not set. Values above 2,500 are always billed as paid requests.

Strict constrain to URLson or off

If true, agent will only visit URLs provided in the urls array

Every API field of Firecrawl Agent · Web Research is on its tool page: open its card above.

What can you do with Firecrawl web research in Claude?

Get a comparison of public product features with links to the pages behind each finding. Firecrawl can research across websites and organize the results into structured records for a chat app to explain.

Compare documented product features

Gather feature descriptions from Notion, Asana, and Trello's public product pages, then build a comparison with supporting URLs.

Prepare a software migration

Collect migration instructions and documented breaking changes from Next.js documentation before planning updates to an application.

Build a focused research bibliography

Collect titles, abstracts, publication dates, and links for a bounded set of arXiv papers on retrieval-augmented generation.

Check a public product catalog

Extract product names, specifications, and listed availability from public manufacturer pages for a purchasing shortlist.

Maintain a company directory

Research company names, official websites, product descriptions, and industries for a defined Y Combinator batch.

Follow product announcements

Collect dated announcements from public company blogs and compare each scheduled collection with earlier results.

Compare visitor information

Gather opening hours, locations, and accessibility information from official Chicago museum websites for a trip-planning brief.

Questions about Firecrawl web research in Claude

Can Claude use Firecrawl web research?

Yes. Add Spiral to Claude as an MCP server, and Claude can find and run Firecrawl web research like any built-in tool.

How much does Firecrawl web research cost in Claude?

$0.001746 per unit of work the agent does, up to the run's limit ($4.36475 by default). You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude plan is separate.

Do I need a Firecrawl account to use Firecrawl web research in Claude?

No. Spiral runs Firecrawl web research on its own Firecrawl account. You sign in to Spiral once and never paste a key.

How long does it take to set up Firecrawl web research in Claude?

About two minutes: add Spiral to Claude, then keep the detected sign-in and click Add, then click Connect.

Does Claude wait while Firecrawl web research runs?

Firecrawl web research runs in the background. Claude starts the run, checks on it and gives you the json when it's ready.

Where does Firecrawl get its research data?

Agent searches and navigates across websites to gather the requested information. Its documented scope includes discovering sources across multiple domains and pages.

Can Firecrawl read listings spread across multiple pages?

Firecrawl describes Agent as handling pagination, infinite scroll, and dynamic JavaScript content. That capability does not establish that a particular extraction contains every listing.

How many records can one research request return?

Firecrawl documents roughly 150 to 200 structured rows per Agent run. Treat that as an approximate output size when planning a collection.

How fresh and accurate is the information?

Firecrawl says it fetches live pages at query time by default. Its terms still disclaim responsibility for third-party content's timeliness and accuracy, so a newly retrieved page can contain outdated information.

Which regional version of a website does Firecrawl see?

Firecrawl Agent browses from the US by default. Specify the intended market in research requests where regional availability matters.

Get started

Start using Firecrawl web research in Claude

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude:

Set up Claude

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options