How do I install the Exa Tools skill?

Run npx skillmds@latest add bsamiee/exa-tools in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Exa Tools safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Exa Tools?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Exa Tools free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Exa Tools?

bsamiee (@bsamiee) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Exa Tools by bsamiee — Agent Skill

Name: Exa Tools
Author: bsamiee

Exa Tools

Executes semantic web search via Exa AI Python CLI. Use when searching for current information, code examples, API documentation, finding similar pages, or generating AI answers with citations. Supports fast/deep/neural search.

bsamiee d0f5c99 2 files · 8.9 KB Updated Sep 17, 2026

File contents

[H1][EXA-TOOLS]

Dictum: Semantic search surfaces relevant content.

Execute Exa AI search queries via Python CLI. API key auto-injected via 1Password.

[IMPORTANT] Exa 2.0 introduced three search tiers: fast (sub-350ms), auto (balanced), deep (agentic, highest quality). Default: auto.

[1][COMMANDS]

[CMD]	[ARGS]	[RETURNS]
search	`<query> [type] [num]`	Web results with text content
code	`<query> [num]`	GitHub code context
find-similar	`<url> [num]`	Pages similar to given URL
answer	`<query>`	AI-generated answer with sources

[2][USAGE]

# Web search (default: auto type, 8 results)
uv run .claude/skills/exa-tools/scripts/exa.py search "Vite 7 new features"

# Neural search for concepts
uv run .claude/skills/exa-tools/scripts/exa.py search "Effect-TS best practices" neural

# Fast search for quick lookups
uv run .claude/skills/exa-tools/scripts/exa.py search "React 19 release notes" fast 15

# Deep search for highest quality
uv run .claude/skills/exa-tools/scripts/exa.py search "Nx workspace optimization" deep

# Code context search (GitHub)
uv run .claude/skills/exa-tools/scripts/exa.py code "React useState hook examples"

# Code search with custom results
uv run .claude/skills/exa-tools/scripts/exa.py code "Effect pipe examples" 20

# Find similar pages
uv run .claude/skills/exa-tools/scripts/exa.py find-similar "https://effect.website/docs/guides/essentials/pipeline"

# AI answer with citations
uv run .claude/skills/exa-tools/scripts/exa.py answer "What are the breaking changes in Vite 7?"

[3][ARGUMENTS]

search: <query> [type] [num]

query — Search query (required)
type — Search type: auto, neural, keyword, fast, deep (default: auto)
num — Number of results (default: 8)

code: <query> [num]

query — Code search query (required)
num — Number of results (default: 10)

find-similar: <url> [num]

url — Source URL to find similar pages for (required)
num — Number of results (default: 10)

answer: <query>

query — Question to answer with web sources (required)

[4][OUTPUT]

Commands return: {"status": "success|error", ...}.

[INDEX]	[CMD]	[RESPONSE]
[1]	`search`	`{query, results[]}`
[2]	`code`	`{query, context[]}`
[3]	`find-similar`	`{url, results[]}`
[4]	`answer`	`{query, answer, sources[]}`

[5][ENVIRONMENT]

[VAR]	[REQUIRED]	[DESCRIPTION]
`EXA_API_KEY`	Yes	Exa API key (1Password injected)

[6][ERROR_HANDLING]

HTTP errors print [ERROR] <status>: <body> and exit 1
Rate limit (429): retry after Retry-After header value
Invalid API key: [ERROR] 401: Unauthorized
Empty results: returns {"status": "success", "results": []} (not an error)

---name: exa-toolsdescription: Executes semantic web search via Exa AI Python CLI. Use when searching for current information, code examples, API documentation, finding similar pages, or generating AI answers with citations. Supports fast/deep/neural search.---# [H1][EXA-TOOLS]>**Dictum:** *Semantic search surfaces relevant content.*<br>Execute Exa AI search queries via Python CLI. API key auto-injected via 1Password.[IMPORTANT] Exa 2.0 introduced three search tiers: `fast` (sub-350ms), `auto` (balanced), `deep` (agentic, highest quality). Default: `auto`.---## [1][COMMANDS]| [CMD] | [ARGS] | [RETURNS] || ------------ | ---------------------- | -------------------------------- || search | `<query> [type] [num]` | Web results with text content || code | `<query> [num]` | GitHub code context || find-similar | `<url> [num]` | Pages similar to given URL || answer | `<query>` | AI-generated answer with sources |---## [2][USAGE]```bash# Web search (default: auto type, 8 results)uv run .claude/skills/exa-tools/scripts/exa.py search "Vite 7 new features"# Neural search for conceptsuv run .claude/skills/exa-tools/scripts/exa.py search "Effect-TS best practices" neural# Fast search for quick lookupsuv run .claude/skills/exa-tools/scripts/exa.py search "React 19 release notes" fast 15# Deep search for highest qualityuv run .claude/skills/exa-tools/scripts/exa.py search "Nx workspace optimization" deep# Code context search (GitHub)uv run .claude/skills/exa-tools/scripts/exa.py code "React useState hook examples"# Code search with custom resultsuv run .claude/skills/exa-tools/scripts/exa.py code "Effect pipe examples" 20# Find similar pagesuv run .claude/skills/exa-tools/scripts/exa.py find-similar "https://effect.website/docs/guides/essentials/pipeline"# AI answer with citationsuv run .claude/skills/exa-tools/scripts/exa.py answer "What are the breaking changes in Vite 7?"```---## [3][ARGUMENTS]**search**: `<query> [type] [num]`- `query` — Search query (required)- `type` — Search type: `auto`, `neural`, `keyword`, `fast`, `deep` (default: `auto`)- `num` — Number of results (default: `8`)**code**: `<query> [num]`- `query` — Code search query (required)- `num` — Number of results (default: `10`)**find-similar**: `<url> [num]`- `url` — Source URL to find similar pages for (required)- `num` — Number of results (default: `10`)**answer**: `<query>`- `query` — Question to answer with web sources (required)---## [4][OUTPUT]Commands return: `{"status": "success|error", ...}`.| [INDEX] | [CMD] | [RESPONSE] || :-----: | -------------- | ---------------------------- || [1] | `search` | `{query, results[]}` || [2] | `code` | `{query, context[]}` || [3] | `find-similar` | `{url, results[]}` || [4] | `answer` | `{query, answer, sources[]}` |---## [5][ENVIRONMENT]| [VAR] | [REQUIRED] | [DESCRIPTION] || ------------- | ---------- | -------------------------------- || `EXA_API_KEY` | Yes | Exa API key (1Password injected) |---## [6][ERROR_HANDLING]- HTTP errors print `[ERROR] <status>: <body>` and exit 1- Rate limit (429): retry after `Retry-After` header value- Invalid API key: `[ERROR] 401: Unauthorized`- Empty results: returns `{"status": "success", "results": []}` (not an error)

Frequently asked questions