How to Use Exa web search in Gemini CLI
Exa web search returns relevant web pages with titles, URLs, and optional page text, excerpts, or summaries. Use it to find sources for a question and read supporting passages in the same search.
Prompts to try with Exa web search in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Exa web search to find official Pydantic v2 migration guidance, then inspect this project's validation code and draft a checklist with supporting URLs and excerpts.
Use Exa web search to find PostgreSQL documentation on logical replication limitations and compare the returned passages with our database design.
Use Exa web search to find Stripe documentation about webhook signature verification, then review our webhook handler against the source text.
Use Exa web search to find React documentation about effect cleanup and check this project's subscriptions for missing cleanup.
Use Exa web search to find ClickHouse documentation about materialized views and prepare an implementation proposal grounded in the returned passages.
How to set up Exa web search in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 Exa web 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": "exa", "model": "exa/search", "input": { "query": "<query>" } }'
Then paste one of the prompts above: Gemini CLI finds Exa web search on Spiral, shows the price and runs it.
Exa web search providers and prices
Spiral runs Exa web search through Exa. Open a card for today's price, with every fee included.
$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
Exa web search works from your objective. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Category | company, publication, news, personal site, financial report, or people | A data category to focus on. | |
| Compliance | hipaa | Enterprise-only compliance mode. Set to | |
| Moderation | on or off | off | Enable content moderation to filter unsafe content from search results. |
| Number of results | 1 to 100 | 10 | Number of results to return. Limits vary by search type. The maximum public limit is 100 results. Contact sales ([email protected]) to discuss higher limits. |
Every API field of Exa Search · Web Search is on its tool page: open its card above.
What can you do with Exa web search in Gemini CLI?
Build a migration checklist tied to official documentation and the dependencies in your project. Exa supplies source URLs and relevant passages that a coding agent can compare with the implementation.
Find evidence for a technical decision
Search for PostgreSQL and ClickHouse documentation about analytical workloads, then compare the returned passages and link each recommendation to its source.
Prepare a software migration
Find Pydantic migration guides and release notes, then use the relevant passages to identify changes that affect a project's validation code.
Compare public product documentation
Find Stripe and Adyen documentation about webhook retries and build a comparison with a supporting URL for each behavior.
Build a research reading list
Search for papers evaluating retrieval-augmented generation, then organize the returned titles, URLs, and excerpts by evaluation method.
Follow company announcements
Search regularly for NVIDIA and AMD product announcements, compare returned URLs with previous searches, and summarize newly found pages.
Check sources for an article
Find government and company pages supporting a draft about electric vehicle charging, then map the returned passages to the claims they support.
Review public business positioning
Find Notion and Airtable product pages discussing project management, then compare how each company describes its workflows using source excerpts.
Collect background for a market briefing
Search for public reports and company announcements about battery recycling in the United States, then assemble a briefing with links to the returned sources.
More on Exa web search and Gemini CLI
Overview
Exa web search in other agents
Questions about Exa web search in Gemini CLI
Can Gemini CLI use Exa web search?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Exa web search like any built-in tool.
How much does Exa web search cost in Gemini CLI?
$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 Gemini CLI plan is separate.
Do I need an Exa account to use Exa web search in Gemini CLI?
No. Spiral runs Exa web 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 web search in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Exa web search runs?
Exa web search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.
How many pages can one Exa search return?
A search can return up to 100 results, with fewer returned when fewer relevant pages are available. Exa does not support pagination, so that result set is not an exhaustive export.
Can Exa read pages behind a login or paywall?
Exa's crawler does not bypass logins, paywalls, or CAPTCHAs. A search result should not be treated as access to the protected content behind it.
How fresh is content described as live?
Exa defines live content as a page copy fetched within the last 60 seconds. That describes the retrieved page copy, not when the publisher last updated its information.
Are Exa highlights generated summaries?
Highlights are extracted passages from the returned pages, selected for relevance to the query. They provide source wording rather than a generated overview.
Does Exa handle PDFs and pages that use JavaScript?
Exa's content extraction handles PDFs, JavaScript-rendered pages, and complex layouts. Its search coverage also spans multiple languages.
Start using Exa web search in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


