exa-search

📁 tdimino/claude-code-minoan 📅 8 days ago

总安装量

周安装量

#21316

全站排名

安装命令

npx skills add https://github.com/tdimino/claude-code-minoan --skill exa-search

Agent 安装分布

opencode 16

antigravity 16

claude-code 16

github-copilot 16

codex 16

kimi-cli 16

Skill 文档

Exa Search Skill

5 specialized scripts for Exa AI search APIâneural search, content extraction, similar pages, research with citations, and async pro research.

Prerequisite: EXA_API_KEY environment variable. Get key at https://dashboard.exa.ai

Token-Efficient Search

Inspired by Anthropic’s dynamic filteringâalways filter before reasoning. ~24% fewer tokens, ~11% better accuracy.

The Principle: Search Cheaply â Filter â Extract Selectively â Reason

DO:

# Step 1: Search with --no-text (titles/URLs only â cheapest)
python3 ~/.claude/skills/exa-search/scripts/exa_search.py "query" -n 20 --no-text

# Step 2: Evaluate titles, pick best 3-5 URLs

# Step 3: Extract only those URLs with bounded content
python3 ~/.claude/skills/exa-search/scripts/exa_contents.py URL1 URL2 --highlights --max-chars 3000

DON’T: Search with full text for 50 results, then reason over all of it.

Use API-Level Filters First (Free Filtering)

These reduce results at the API level before you ever see them:

--must-include "term" â results must contain this string
--must-exclude "term" â removes irrelevant results
--domains site1.com site2.com â restrict to authoritative sources
--category "research paper" â eliminate irrelevant content types
--after 2025-01-01 / --before â temporal filtering

Use Summaries Over Full Text

When you need the gist, not raw content:

# AI-distilled summaries â much smaller than full text
python3 ~/.claude/skills/exa-search/scripts/exa_search.py "query" --summary "Key findings" -n 5

Use Bounded Context for RAG

# Capped context string â prevents unbounded token usage
python3 ~/.claude/skills/exa-search/scripts/exa_search.py "query" --context --context-chars 5000

Post-Process with filter_web_results.py

Pipe Exa JSON output through the Firecrawl filter script for additional reduction:

python3 ~/.claude/skills/exa-search/scripts/exa_search.py "query" --json | \
  python3 ~/.claude/skills/firecrawl/scripts/filter_web_results.py \
  --fields "title,url,text" --max-chars 3000

Cost Tiers â Match to Task

Type	Latency	Cost	When
`--instant`	<150ms	Cheapest	Real-time lookups, autocomplete
`--fast`	~500ms	Low	Quick checks, confirmations
`auto` (default)	â	Medium	General search
`--deep`	Slowest	Highest	Comprehensive research

Available Scripts

1. exa_search.py â Neural Web Search

python3 ~/.claude/skills/exa-search/scripts/exa_search.py "query" [options]

Quick Example	Purpose
`... exa_search.py "AI frameworks"`	Basic search
`... exa_search.py "transformers" --category "research paper" -n 20`	Academic papers
`... exa_search.py "query" --deep --additional-queries "alt query"`	Deep search
`... exa_search.py "query" --domains docs.python.org`	Domain-filtered
`... exa_search.py "query" --after 2025-01-01 --category news`	Recent news
`... exa_search.py "query" --context --context-chars 10000`	RAG context
`... exa_search.py "query" --instant -n 5`	Sub-150ms lookup

Categories: company, research paper, news, pdf, github, tweet, personal site, people, financial report

2. exa_contents.py â URL Content Extraction

python3 ~/.claude/skills/exa-search/scripts/exa_contents.py URL [URL2...] [options]

Quick Example	Purpose
`... exa_contents.py "https://arxiv.org/abs/2307.06435"`	Extract paper
`... exa_contents.py URL --summary "Key methods" --highlights`	Summarized extraction
`... exa_contents.py URL --livecrawl always`	Fresh content
`... exa_contents.py URL --max-chars 5000`	Bounded extraction

3. exa_similar.py â Find Similar Pages

python3 ~/.claude/skills/exa-search/scripts/exa_similar.py URL [options]

Quick Example	Purpose
`... exa_similar.py "https://stripe.com" --category company --exclude-source`	Find competitors
`... exa_similar.py "https://arxiv.org/abs/..." -n 15`	Related papers
`... exa_similar.py URL --summary "How different?"`	Comparison summaries

4. exa_research.py â AI-Powered Research

python3 ~/.claude/skills/exa-search/scripts/exa_research.py "question" [options]

Quick Example	Purpose
`... exa_research.py "React vs Vue differences?" --sources`	Research with citations
`... exa_research.py "query" --stream`	Real-time streaming
`... exa_research.py "query" --domains docs.python.org`	Authoritative sources
`... exa_research.py "query" --markdown`	Markdown with citations
`... exa_research.py "query" --answer-only`	Pipe-friendly output

5. exa_research_async.py â Async Pro Research

python3 ~/.claude/skills/exa-search/scripts/exa_research_async.py "question" [options]

Quick Example	Purpose
`... exa_research_async.py "Compare AI frameworks" --pro --wait`	Pro model
`... exa_research_async.py "Quick overview" --fast`	Fast model
`... exa_research_async.py "query" --schema '{...}'`	Structured output
`... exa_research_async.py status r_abc123`	Check job
`... exa_research_async.py list`	List jobs

Script Selection Guide

Task	Best Script
Web search with filters	`exa_search.py`
Research papers	`exa_search.py --category "research paper"`
Company/startup info	`exa_search.py --category company`
GitHub repos/code	`exa_search.py --category github`
Extract known URL content	`exa_contents.py`
Find competitors	`exa_similar.py --exclude-source`
Quick answers with citations	`exa_research.py --sources`
Complex structured research	`exa_research_async.py --pro`
Real-time search	`exa_search.py --instant`
RAG context building	`exa_search.py --context`

Exa vs Firecrawl vs Native Claude Tools

Need	Best Tool	Why
Semantic/neural search	Exa `exa_search.py`	AI-powered relevance
Find research papers	Exa `--category "research paper"`	Academic index
Quick research answer	Exa `exa_research.py`	Citations + synthesis
Find similar pages	Exa `exa_similar.py`	Semantic similarity
Single page â markdown	Firecrawl `scrape --only-main-content`	Cleanest output
Crawl entire site	Firecrawl `crawl --wait --progress`	Link following
Autonomous data finding	Firecrawl `agent`	No URLs needed
Search + scrape combined	Firecrawl `search --scrape`	One operation
Claude API agent building	Native `web_search_20260209`	Built-in dynamic filtering
Twitter/X content	`jina URL`	Only tool that works

Common Workflows

Research a Topic

python3 ~/.claude/skills/exa-search/scripts/exa_research.py "How does RAG work?" --sources --markdown

Literature Review

# Find papers, then find similar to best hit
python3 ~/.claude/skills/exa-search/scripts/exa_search.py "transformer optimization" --category "research paper" -n 20 --summary "Key contributions"
python3 ~/.claude/skills/exa-search/scripts/exa_similar.py "https://arxiv.org/abs/1706.03762" --category "research paper" -n 15

Documentation Research

python3 ~/.claude/skills/exa-search/scripts/exa_search.py "React useEffect cleanup" --domains react.dev developer.mozilla.org --context

Build RAG Context

python3 ~/.claude/skills/exa-search/scripts/exa_search.py "Python async patterns" --context --context-chars 15000 --domains docs.python.org

Reference Documentation

File	Contents
`references/exa-scripts-reference.md`	Full parameter reference for all 5 scripts, cost table, MCP comparison, test suite

Test Suite

python3 ~/.claude/skills/exa-search/scripts/test_exa.py --quick       # Quick validation
python3 ~/.claude/skills/exa-search/scripts/test_exa.py               # Full suite
python3 ~/.claude/skills/exa-search/scripts/test_exa.py --endpoint search  # Specific endpoint

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台