How to Use Firecrawl web research in Windsurf
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 Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Firecrawl web research to find the official Next.js migration instructions relevant to the version in package.json. Create a checklist with affected APIs and source URLs.
Use Firecrawl web research to gather React's official guidance on useEffect cleanup. Compare it with this project's effects and propose changes supported by the documentation.
Use Firecrawl web research to collect the documented webhook retry behavior of Stripe and GitHub. Save a comparison with source URLs in docs/webhook-retries.md.
Use Firecrawl web research to find PostgreSQL's documented JSON indexing options. Compare them with our database migrations and suggest indexes for the queries in this repository.
Use Firecrawl web research to collect 20 recent arXiv papers about retrieval-augmented generation, including titles, abstracts, dates, and URLs. Save the returned records as a JSON fixture for our literature browser.
How to set up Firecrawl web research in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: Windsurf 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.
$0.001746 per unit of work the agent does, up to the run's limit ($4.36475 by default).
Settings you can ask for
Firecrawl web research works from your prompt. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Mode | extract or chat | extract |
|
| Safe | on or off | When | |
| Model | spark-2, spark-1-mini, or 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, or high | Reasoning budget for the agent task. Every run executes on spark-2, so effort can be sent with or without model. | |
| Max credits | a 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 URLs | on 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 Windsurf?
Build a migration checklist from the documentation that applies to your project's dependencies. Firecrawl can discover relevant pages and return structured findings for the coding agent to compare with project files.
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.
More on Firecrawl web research and Windsurf
Overview
Firecrawl web research in other agents
Questions about Firecrawl web research in Windsurf
Can Windsurf use Firecrawl web research?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Firecrawl web research like any built-in tool.
How much does Firecrawl web research cost in Windsurf?
$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 Windsurf plan is separate.
Do I need a Firecrawl account to use Firecrawl web research in Windsurf?
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 Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Firecrawl web research runs?
Firecrawl web research runs in the background. Windsurf 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.
Start using Firecrawl web research in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


