Exa Search Tool

​

Installation

pip install 'crewai[tools]'

​

Environment Variables

export EXA_API_KEY='your_exa_api_key'

​

Example Usage

import os
from crewai import Agent, Task, Crew
from crewai_tools import EXASearchTool

# Initialize the tool
exa_tool = EXASearchTool()

# Create an agent that uses the tool
researcher = Agent(
    role='Research Analyst',
    goal='Find the latest information on any topic',
    backstory='An expert researcher who finds the most relevant and up-to-date information.',
    tools=[exa_tool],
    verbose=True
)

# Create a task for the agent
research_task = Task(
    description='Find the top 3 recent breakthroughs in quantum computing.',
    expected_output='A summary of the top 3 breakthroughs with source URLs.',
    agent=researcher
)

# Form the crew and kick it off
crew = Crew(
    agents=[researcher],
    tasks=[research_task],
    verbose=True
)

result = crew.kickoff()
print(result)

​

Configuration Options

• type (str, optional): The search type to use. Defaults to "auto". Options: "auto", "instant", "fast", "deep".
• content (bool, optional): Whether to include full page content in results. Defaults to False.
• summary (bool, optional): Whether to include AI-generated summaries of each result. Requires content=True. Defaults to False.
• api_key (str, optional): Your Exa API key. Falls back to the EXA_API_KEY environment variable if not provided.
• base_url (str, optional): Custom API server URL. Falls back to the EXA_BASE_URL environment variable if not provided.

• search_query (str): Required. The search query string.
• start_published_date (str, optional): Filter results published after this date (ISO 8601 format, e.g. "2024-01-01").
• end_published_date (str, optional): Filter results published before this date (ISO 8601 format).
• include_domains (list[str], optional): A list of domains to restrict the search to.

​

Advanced Usage

# Get full page content with AI summaries
exa_tool = EXASearchTool(
    content=True,
    summary=True,
    type="deep"
)

# Use it in an agent
agent = Agent(
    role="Deep Researcher",
    goal="Conduct thorough research with full content and summaries",
    tools=[exa_tool]
)

​

Features

• Semantic Search: Find results based on meaning, not just keywords
• Full Content Retrieval: Get the full text of web pages alongside search results
• AI Summaries: Get concise, AI-generated summaries of each result
• Date Filtering: Limit results to specific time periods with published date filters
• Domain Filtering: Restrict searches to specific domains