Exa Tools

Name: Exa Tools
Author: bsamiee

ASecurity

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.

2 stars

0 votes

0 copies

0 views

Added 9/19/2026

documentationpythonbashreactgitapidocumentation

Works with

cliapi

Security Analysis

A100/100

Scanned 9/19/2026

Install to Claude Code

$npx -y skills add bsamiee/Parametric_Portal --skill exa-tools --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Exa Tools?

Add the live security badge to your README — it updates automatically with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/bsamiee-exa-tools/badge)](https://www.skillsdirectory.com/skills/bsamiee-exa-tools)

More formats (shields.io, HTML) on the badges page.

Download Zip

Files

SKILL.md

---
name: exa-tools
user-invocable: false
description: >-
  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 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)

Attribution

bsamiee

View source More from bsamiee →

SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments (0)

No comments yet. Be the first to comment!

--- name: exa-tools user-invocable: false description: >- 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 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)