exa-research

name	exa-research
description	Use Exa AI for neural search, content retrieval, and automated deep research. Requires EXA_API_KEY.

Exa Research Skill

This skill leverages the Exa AI API for neural search, finding similar content, and autonomous research via their Research endpoint.

Setup

1. Dependencies: Requires exa-py and openai (for research endpoint compatibility).

   pip install exa-py openai python-dotenv
   

2. API Key Configuration: Requires EXA_API_KEY.

   # If the script fails due to a missing key, run the following:
   echo "It seems the Exa API key is not set up."
   read -p "Enter your Exa API key: " EXA_KEY
   echo "EXA_API_KEY=$EXA_KEY" >> .env
   if [ -f .gitignore ] && ! grep -q ".env" .gitignore; then echo ".env" >> .gitignore; fi
   echo "API key saved to .env."
   

Usage

The script scripts/exa_tools.py supports multiple operations.

1. Search and Contents

Perform a neural search and retrieve content or highlights.

python3 scripts/exa_tools.py search "<query>" [--num-results <N>] [--highlights]

Example:

python3 scripts/exa_tools.py search "innovative sustainable urban planning" --num-results 5 --highlights

2. Research (Automated)

Automate in-depth research and receive a structured report.

python3 scripts/exa_tools.py research "<query>" [--model <exa-research|exa-research-pro>]

Example:

python3 scripts/exa_tools.py research "Analyze the impact of quantum computing on cryptography" --model exa-research-pro

3. Find Similar

Find pages similar to a given URL.

python3 scripts/exa_tools.py find_similar "<url>"

Example:

python3 scripts/exa_tools.py find_similar "https://arxiv.org/abs/1706.03762"

Output

The script outputs results in JSON format.