exa-tool

# Exa MCP Tool

This skill provides access to Exa's powerful search and research capabilities through the Exa MCP server.

## Available Tools

### General Purpose
- `exa-search <tool> '{"json":"args"}'` - Generic wrapper for any Exa MCP tool

### Specialized Wrappers
- `exa-web-search '{"query":"...", "count":10, "freshness":"pw", ...}'` - Web search with optional filters

## Full Tool List (via exa-search)

All tools from the Exa MCP server are available:

| Tool | Description |
|------|-------------|
| `web_search_exa` | Search the web for any topic, get clean content |
| `web_search_advanced_exa` | Advanced search with filters (domains, dates, content options) |
| `get_code_context_exa` | Find code examples, documentation, programming solutions |
| `crawling_exa` | Get full content of a specific webpage from a known URL |
| `company_research_exa` | Research any company for business information and news |
| `people_search_exa` | Find people and their professional profiles |
| `deep_researcher_start` | Start an AI research agent that writes detailed reports |
| `deep_researcher_check` | Check status and get results from deep research task |

## Setup

1. Get your Exa API key from https://dashboard.exa.ai/api-keys

2. Set the environment variable:
   ```bash
   export EXA_API_KEY="your_exa_api_key_here"
   ```

   Or add to your shell profile (`~/.bashrc` or `~/.zshrc`):
   ```bash
   export EXA_API_KEY="your_exa_api_key_here"
   ```

   Or create a `.env` file in your workspace:
   ```bash
   echo "EXA_API_KEY=your_exa_api_key_here" > ~/.openclaw/workspace/.env
   source ~/.openclaw/workspace/.env
   ```

3. Restart OpenClaw to load the skill:
   ```bash
   openclaw gateway restart
   ```

## Usage Examples

### Basic Web Search
```bash
exa-web-search '{"query":"Step-3.5 Flash benchmarks"}'
```

### Advanced Search with Filters
```bash
exa-search web_search_advanced_exa '{
  "query": "OpenClaw AI",
  "count": 10,
  "freshness": "pw",
  "includeDomains": ["github.co...

# OpenClaw Exa MCP Skill 🔍

[OpenClaw](https://github.com/openclaw/openclaw) skill for Exa MCP integration — advanced web search, code context, company research, and more.

## 🌐 Live Demo

**Documentation Site:** https://claireaicodes.github.io/openclaw-skill-exa-tool/

---

## Features

- ✅ **8 Exa MCP tools** in one unified interface
- ✅ **SSE streaming** handled automatically
- ✅ **Clean JSON output** for easy parsing
- ✅ **Agent-ready** — call from any OpenClaw agent
- ✅ **Secure** — API key managed via OpenClaw config

## Quick Start

### 1. Prerequisites

- OpenClaw 2026.2.9+
- Exa API key from [dashboard.exa.ai/api-keys](https://dashboard.exa.ai/api-keys)

### 2. Installation

Copy the `exa-tool` directory to your OpenClaw skills path:

```bash
# If using global node_modules (default)
cp -r exa-tool /path/to/openclaw/skills/
```

Or as a symlink:

```bash
ln -s /path/to/exa-tool /path/to/openclaw/skills/exa-tool
```

### 3. Configuration

Add to your `openclaw.json` config:

```json
{
  "skills": {
    "entries": {
      "exa-tool": {
        "apiKey": "your_exa_api_key_here"
      }
    }
  }
}
```

Then restart OpenClaw:

```bash
openclaw gateway restart
```

### 4. Usage

#### Basic Web Search

```bash
exec exa-search web_search_exa '{"query":"Step-3.5 Flash benchmarks"}'
```

Or use the simplified wrapper:

```bash
exec exa-web-search '{"query":"AI agents 2026"}'
```

#### Company Research

```bash
exec exa-search company_research_exa '{"companyName":"OpenAI"}'
```

#### Code Search

```bash
exec exa-search get_code_context_exa '{"query":"OpenClaw agent implementation"}'
```

#### Advanced Search

```bash
exec exa-search web_search_advanced_exa '{
  "query": "OpenClaw AI",
  "count": 10,
  "freshness": "pw",
  "includeDomains": ["github.com", "docs.openclaw.ai"]
}'
```

## Available Tools

| Tool | Description |
|------|-------------|
| `web_search_exa` | Basic web search with clean content |
| `web_search_advanced_exa` | Advanced filters: domains,...