[Integrations](https://spiral.ai/integrations) › [Notion](https://spiral.ai/integrations/notion) › [Firecrawl web research](https://spiral.ai/integrations/notion/firecrawl-web-research)

# How to Use Firecrawl web research in Notion

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.

|  |  |
| --- | --- |
| Model | Firecrawl web research |
| Available through | Firecrawl |
| Category | Web |
| Price | $0.001746 per unit of work the agent does, up to the run's limit ($4.36475 by default). |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Firecrawl web research in Notion

- Every Monday, use Firecrawl web research to collect announcements published on Cloudflare's official blog during the previous seven days. Return titles, dates, summaries, and links.
- Each weekday, use Firecrawl web research to find up to 20 new arXiv papers about retrieval-augmented generation. Include titles, abstracts, dates, and links, and exclude papers already reported.
- Every Friday, use Firecrawl web research to collect the latest release notes from the official React, Next.js, and Vite websites. Report newly published entries with dates and links.
- Every month, use Firecrawl web research to collect the specifications listed for Sony's full-frame mirrorless cameras on its US website. Compare them with the previous collection and report changes with supporting links.
- Every Thursday, use Firecrawl web research to check the official Field Museum, Shedd Aquarium, and Adler Planetarium websites for visitor hours and temporary closures. Report changes from the previous check.

## How to set up Firecrawl web research in Notion

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

### Use the Spiral skill

1. **Send Notion 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 Spiral's MCP server

1. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

4. **Run Firecrawl web research in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Firecrawl web research, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
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.

```bash
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: Notion finds Firecrawl web research on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/notion

## Firecrawl web research tools and prices

- [Firecrawl Agent · Web Research](https://spiral.ai/tools/firecrawl/firecrawl/agent) (Firecrawl): $0.001746 per unit of work the agent does, up to the run's limit ($4.36475 by default).

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| mode | extract, chat | extract | `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. |
| safe |  | — | 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. |
| urls |  | — | Optional list of URLs to constrain the agent to |
| model | spark-2, spark-1-mini, spark-1-pro | spark-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. |
| effort | low, medium, high | — | Reasoning budget for the agent task. Every run executes on spark-2, so effort can be sent with or without model. |
| schema |  | — | Optional JSON schema to structure the extracted data |

## What can you do with Firecrawl web research in Notion?

Receive a weekly brief of product announcements from the companies you follow. Scheduled research can collect dated entries and source URLs, then compare them with previous collections.

### 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.

## Overview

- [Firecrawl](https://spiral.ai/providers/firecrawl)
- [All Notion guides](https://spiral.ai/integrations/notion)

## Firecrawl web research in other agents

- [Amp](https://spiral.ai/integrations/amp/firecrawl-web-research)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/firecrawl-web-research)
- [Claude](https://spiral.ai/integrations/claude-desktop/firecrawl-web-research)
- [Claude Code](https://spiral.ai/integrations/claude-code/firecrawl-web-research)
- [Cline](https://spiral.ai/integrations/cline/firecrawl-web-research)
- [Codex](https://spiral.ai/integrations/codex/firecrawl-web-research)
- [Cursor](https://spiral.ai/integrations/cursor/firecrawl-web-research)
- [Devin](https://spiral.ai/integrations/devin/firecrawl-web-research)
- [dots](https://spiral.ai/integrations/dots/firecrawl-web-research)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/firecrawl-web-research)
- [Gemini](https://spiral.ai/integrations/gemini/firecrawl-web-research)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/firecrawl-web-research)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/firecrawl-web-research)
- [goose](https://spiral.ai/integrations/goose/firecrawl-web-research)
- [Grok](https://spiral.ai/integrations/grok/firecrawl-web-research)
- [Grok Build](https://spiral.ai/integrations/grok-build/firecrawl-web-research)
- [Hermes](https://spiral.ai/integrations/hermes/firecrawl-web-research)
- [Instinct](https://spiral.ai/integrations/instinct/firecrawl-web-research)
- [Manus](https://spiral.ai/integrations/manus/firecrawl-web-research)
- [Muse](https://spiral.ai/integrations/muse/firecrawl-web-research)
- [Muse Code](https://spiral.ai/integrations/muse-code/firecrawl-web-research)
- [n8n](https://spiral.ai/integrations/n8n/firecrawl-web-research)
- [OpenClaw](https://spiral.ai/integrations/openclaw/firecrawl-web-research)
- [opencode](https://spiral.ai/integrations/opencode/firecrawl-web-research)
- [Perplexity](https://spiral.ai/integrations/perplexity/firecrawl-web-research)
- [Raycast](https://spiral.ai/integrations/raycast/firecrawl-web-research)
- [VS Code](https://spiral.ai/integrations/vscode/firecrawl-web-research)
- [Windsurf](https://spiral.ai/integrations/windsurf/firecrawl-web-research)
- [Zapier](https://spiral.ai/integrations/zapier/firecrawl-web-research)

## More Notion guides

- [Firecrawl web page content](https://spiral.ai/integrations/notion/firecrawl-web-page-content)
- [Firecrawl web search](https://spiral.ai/integrations/notion/firecrawl-web-search)
- [Firecrawl developer search](https://spiral.ai/integrations/notion/firecrawl-developer-search)
- [Firecrawl website URLs](https://spiral.ai/integrations/notion/firecrawl-website-urls)
- [Firecrawl batch web scraping](https://spiral.ai/integrations/notion/firecrawl-batch-web-scraping)
- [Firecrawl website content](https://spiral.ai/integrations/notion/firecrawl-website-content)

## Questions about Firecrawl web research in Notion

**Can Notion use Firecrawl web research?**

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

**How much does Firecrawl web research cost in Notion?**

$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 Notion plan is separate.

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

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 Notion?**

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while Firecrawl web research runs?**

Firecrawl web research runs in the background. Notion 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.

