[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Firecrawl paper search](https://spiral.ai/integrations/hermes/firecrawl-paper-search)

# How to Use Firecrawl paper search in Hermes

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.

|  |  |
| --- | --- |
| Model | Firecrawl paper search |
| Available through | Firecrawl |
| Category | Data |
| Price | $0.013 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Firecrawl paper search in Hermes

- Every Monday, use Firecrawl paper search to find up to 20 papers about retrieval-augmented generation evaluation dated within the preceding seven days. Show the newest relevant matches first and summarize papers whose IDs have not appeared in earlier digests.
- Each Friday, use Firecrawl paper search to find up to 15 papers about CRISPR base-editing off-target effects dated within the preceding month. Report newly found titles, authors, identifiers, and short abstract summaries.
- Every Wednesday, use Firecrawl paper search to find up to 20 papers about wastewater-based epidemiology dated within the preceding month. Group newly found abstracts by pathogen and study approach.
- On the first day of each month, use Firecrawl paper search to find up to 25 papers about quantum error correction dated within the previous month. Create a selected reading list with titles, dates, identifiers, and abstract summaries.
- Every Friday, use Firecrawl paper search to find up to 20 papers about HumanEval and code generation evaluation dated within the preceding month. Compare paper IDs with earlier runs and summarize newly found evaluation methods.

## How to set up Firecrawl paper search in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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 paper search**: 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/research-search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Hermes finds Firecrawl paper search on Spiral, shows the price and runs it.

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

## Firecrawl paper search tools and prices

- [Firecrawl Research · Paper Search](https://spiral.ai/tools/firecrawl/firecrawl/research-search) (Firecrawl): $0.013 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| k | 1 to 500 | 40 | Maximum number of ranked papers to return. |
| to |  | — | Inclusive upper bound on created/updated date. |
| from |  | — | Inclusive lower bound on created/updated date. |
| sort | relevance, date_desc | relevance | Result order. `relevance` (default) returns the most relevant papers first. `date_desc` returns the newest papers among the most relevant matches, newest first by created date, with undated papers last. It does not list every paper in a date range; use `from` and `to` for that. |
| authors |  | — | Author substring filter. Repeat or pass a comma-separated value; all filters must match. |
| categories |  | — | Paper category filter. Repeat or pass a comma-separated value; all filters must match. |

## What can you do with Firecrawl paper search in Hermes?

Produce a recurring reading digest of newly found papers on a defined research topic. Compare returned paper identifiers between runs and summarize abstracts, while keeping the digest clearly labeled as a selected list.

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

## Overview

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

## Firecrawl paper search in other agents

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

## More Hermes guides

- [Firecrawl government documents](https://spiral.ai/integrations/hermes/firecrawl-government-documents)
- [Firecrawl related research papers](https://spiral.ai/integrations/hermes/firecrawl-related-research-papers)
- [Bria editable ad layers](https://spiral.ai/integrations/hermes/bria-editable-ad-layers)
- [Firecrawl research paper metadata and passages](https://spiral.ai/integrations/hermes/firecrawl-research-paper-metadata-and-passages)
- [Bria Fibo structured image prompt](https://spiral.ai/integrations/hermes/bria-fibo-structured-image-prompt)
- [Gemini content classification](https://spiral.ai/integrations/hermes/gemini-content-classification)

## Questions about Firecrawl paper search in Hermes

**Can Hermes use Firecrawl paper search?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Firecrawl paper search like any built-in tool.

**How much does Firecrawl paper search cost in Hermes?**

$0.013 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

**Do I need a Firecrawl account to use Firecrawl paper search in Hermes?**

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

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while Firecrawl paper search runs?**

Firecrawl paper search runs in the background. Hermes 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.

