[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Exa Search](https://spiral.ai/integrations/hermes/exa-search)

# How to Use Exa Search in Hermes

Exa Search brings ranked web results and relevant page excerpts into your Hermes research tasks. Use it to gather sources for a brief, compare companies, or investigate a question that needs several searches.

|  |  |
| --- | --- |
| Model | Exa Search |
| Available through | Exa |
| Category | Web |
| Price | $0.0091 per search with 10 results ($0.0052 lite or instant, $0.0156 deep, $0.0195 deep reasoning). Each result after 10: $0.0013. Summaries: $0.0013 per result. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Exa Search in Hermes

- Use Exa Search to find five news sources about battery recycling developments this month. Request relevant excerpts, group duplicate stories, and write a brief with a supporting link for each development.
- Use Exa Search in deep research mode to compare how Notion, Asana, and ClickUp describe their enterprise security controls. Request full page text and return a table with each claim, its source, and any missing evidence.
- Use Exa Search with the publications category to find eight papers comparing hybrid and semantic retrieval. Return relevant excerpts, then summarize the evaluation methods and where the findings disagree.
- Use Exa Search with the company category to find ten companies making warehouse inspection robots. My goal is a supplier shortlist. Request a structured result with company name, website, inspection application, and supporting evidence.
- Every Monday at 9am: search the web with Exa Search for the newest papers on small language models and cite each source.

## How to set up Exa 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 Exa 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": "exa",
    "model": "exa/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Hermes finds Exa Search on Spiral, shows the price and runs it.

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

## Exa Search tools and prices

- [Exa Search · Web Search](https://spiral.ai/tools/exa/exa/search) (Exa): $0.0091 per search with 10 results ($0.0052 lite or instant, $0.0156 deep, $0.0195 deep reasoning). Each result after 10: $0.0013. Summaries: $0.0013 per result.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| type |  | auto | The search mode to use. |
| context |  | — | Deprecated. Use `highlights` or `text` instead. Returns page contents as a combined context string. |
| category | company, publication, news, personal site, financial report, people | — | A data category to focus on. |
| contents |  | — | Content options for text, highlights, summary, extras, and freshness controls. |
| objective |  | — | The broader goal this search serves: the task the caller is working on, beyond the query itself. |
| compliance | hipaa | — | Enterprise-only compliance mode. Set to `hipaa` for HIPAA mode. Requires cache-only retrieval with supported parameters. See the HIPAA docs for details. |

## What can you do with Exa Search in Hermes?

Ask Hermes for a specific deliverable, such as a five-source briefing or a vendor comparison with supporting links. Specify the evidence you need, then request excerpts for a focused answer or full page text for a closer reading.

### Prepare a news briefing

Ask for a defined topic and time window, then have Hermes group overlapping coverage and attach evidence to each takeaway.

### Compare vendor claims

Name the vendors and the exact capabilities to compare. Request full page text and ask Hermes to mark gaps where the sources do not settle a question.

### Investigate conflicting findings

Use deep research for a question with competing explanations. Ask for the strongest evidence on each side and the questions that remain unresolved.

### Build a supplier shortlist

Define the product, application, and qualification criteria. Request company results and a structured comparison with evidence for each match.

### Review research papers

Focus on publications and ask Hermes to compare methods, datasets, and conclusions across a small set of papers.

### Check a claim before sharing it

Provide the exact claim and request supporting and conflicting sources. Ask Hermes to distinguish what the evidence establishes from what it merely suggests.

## Overview

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

## More Hermes guides

- [WaveSpeed Video Watermark Remover](https://spiral.ai/integrations/hermes/wavespeed-video-watermark-remover)
- [Exa cited web answer](https://spiral.ai/integrations/hermes/exa-cited-web-answer)
- [WaveSpeed Video Background Remover](https://spiral.ai/integrations/hermes/wavespeed-video-background-remover)
- [Exa similar web pages](https://spiral.ai/integrations/hermes/exa-similar-web-pages)
- [Wan 3.0 Text to Video](https://spiral.ai/integrations/hermes/wan-3-0-text-to-video)
- [Exa web page content](https://spiral.ai/integrations/hermes/exa-web-page-content)

## Questions about Exa Search in Hermes

**Can Hermes use Exa Search?**

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

**How much does Exa Search cost in Hermes?**

$0.0091 per search with 10 results ($0.0052 lite or instant, $0.0156 deep, $0.0195 deep reasoning). Each result after 10: $0.0013. Summaries: $0.0013 per result. 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 an Exa account to use Exa Search in Hermes?**

No. Spiral runs Exa Search on its own Exa account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Exa Search in Hermes?**

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

**Does Hermes wait while Exa Search runs?**

Exa Search runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**Does Exa Search return page text or just links?**

It can return relevant excerpts or full page text alongside search results. Choose excerpts for focused evidence and full text when you need the surrounding context.

**When should I use Exa Deep Search?**

Use it when the question needs several searches or the evidence needs further investigation. Deep Search can refine its approach when findings are incomplete or contradictory.

**Can Exa Search return structured research results?**

Yes. An output schema can request a synthesized answer or structured dataset, which is useful for comparisons and shortlists.

**How many results can Exa Search return?**

You can request up to 100 results. The response may contain fewer when fewer relevant pages are available.

**Can Exa Search focus on research papers?**

Yes. The publications category covers scholarly publications, including research papers, preprints, and journal articles.

