How to Use Firecrawl paper search in Factory Droid
Firecrawl paper search returns ranked papers with abstracts, authors, source IDs, dates, and relevance scores. Use it to find literature from PubMed, bioRxiv, medRxiv, and arXiv rather than ordinary web snippets.
Prompts to try with Firecrawl paper search in Factory Droid
Copy an example into Factory Droid, or ask in your own words.
Use Firecrawl paper search to find 15 papers on HNSW approximate nearest-neighbor search. Read our vector search design notes and add an abstract-based bibliography with titles, authors, and source IDs.
Use Firecrawl paper search to find 12 papers about retrieval-augmented generation answer faithfulness. Compare their abstracts with our evaluation plan and suggest papers to read before changing the tests.
Use Firecrawl paper search to find the paper Attention Is All You Need. Add its returned title, authors, abstract, and source identifier to our research notes.
Use Firecrawl paper search to find 10 papers about LoRA and QLoRA. Review our fine-tuning proposal and create a reading list grouped by the methods described in the abstracts.
Use Firecrawl paper search to find 15 papers about HumanEval code generation evaluation. Draft a bibliography for our benchmark documentation and identify candidate papers whose abstracts discuss evaluation limitations.
How to set up Firecrawl paper search in Factory Droid
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.
droid mcp add spiral https://api.spiral.ai/mcp --type http
- Sign in
Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.
- Check it
Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.
droid mcp list
Use the Spiral skill
- Send Factory Droid 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 paper search
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/research-search", "input": { "query": "<query>" } }'
Then paste one of the prompts above: Factory Droid finds Firecrawl paper search on Spiral, shows the price and runs it.
Firecrawl paper search providers and prices
Spiral runs Firecrawl paper search through Firecrawl. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Factory Droid for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| K | 1 to 500 | 40 | Maximum number of ranked papers to return. |
| Sort | relevance or date_desc | relevance | Result order. |
Every API field of Firecrawl Research · Paper Search is on its tool page: open its card above.
What can you do with Firecrawl paper search in Factory Droid?
Build a research bibliography beside the code that needs it, using Firecrawl's paper titles, abstracts, and identifiers. A coding agent can connect candidate papers to an implementation proposal and explain which claims come from abstracts.
Build a literature review shortlist
Find papers on retrieval-augmented generation evaluation, then organize their abstracts into retrieval quality, answer faithfulness, and benchmark design. Keep the returned paper identifiers beside each entry for later reading.
Find papers behind an engineering decision
Search for approximate nearest-neighbor methods before choosing an approach for a vector search project. Build a bibliography of candidate methods and summarize the tradeoffs described in their abstracts.
Prepare a journal club reading list
Find papers about CRISPR base-editing off-target effects and select abstracts that describe different experimental approaches. Return titles, authors, dates, and identifiers so the club can choose what to read.
Recover a paper from its description
Search for a remembered method, such as diffusion models outperforming GANs on image synthesis. Compare candidate titles and abstracts to identify the likely paper.
Find benchmark papers
Collect papers about MMLU or HumanEval and use their abstracts to separate benchmark introductions from papers applying those benchmarks. Produce a reading list for an evaluation project.
Maintain a topic digest
Repeat searches for wastewater-based epidemiology within recent date windows and compare returned paper IDs with earlier results. Summarize newly found abstracts as a selected reading digest.
Compare research approaches
Run separate searches for LoRA and full fine-tuning, then compare the methods and applications described in the returned abstracts. Use the comparison to choose papers for a deeper technical review.
More on Firecrawl paper search and Factory Droid
Firecrawl paper search in other agents
Questions about Firecrawl paper search in Factory Droid
Can Factory Droid use Firecrawl paper search?
Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run Firecrawl paper search like any built-in tool.
How much does Firecrawl paper search cost in Factory Droid?
$0.013 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Factory Droid plan is separate.
Do I need a Firecrawl account to use Firecrawl paper search in Factory Droid?
No. Spiral runs Firecrawl paper search 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 paper search in Factory Droid?
About two minutes: add the server, then sign in, then check it.
Does Factory Droid wait while Firecrawl paper search runs?
Firecrawl paper search runs in the background. Factory Droid starts the run, checks on it and gives you the json when it's ready.
Which research sources does Firecrawl cover?
The index contains roughly 43 million abstracts, around 90% biomedical and life sciences literature from PubMed, bioRxiv, and medRxiv. arXiv adds physics, mathematics, and computer science papers.
What does a paper search result include?
Results include the title, abstract, authors, source identifiers, creation and update dates, and a ranking score. These are ranked paper records rather than ordinary web snippets.
How many papers can one search return?
One search can return up to 500 ranked papers. That ceiling is a result limit, not a count of all literature matching the topic.
Does newest-first ordering list every recent paper?
No. Firecrawl orders the most relevant matches by creation date, so the result remains a relevance-selected list rather than a complete chronological feed.
Why might a known paper be missing?
Coverage outside PubMed, bioRxiv, medRxiv, and arXiv is thinner. Firecrawl specifically warns that papers available only behind publisher paywalls or in niche venues may not be indexed.
Start using Firecrawl paper search in Factory Droid
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Factory Droid:
set up https://spiral.ai/SKILL.md


