exa-search · ejirocodes — скилл для Claude Code: что делает и как установить
Скилл exa-search помогает интегрировать веб-поиск Exa.ai, настроить нейронный поиск и извлечение текстов веб-страниц.
MIT 249 установок ★ 6 обновлён 2026-06-25
npx skills add ejirocodes/agent-skills --skill exa-search -a claude-codeЧто делает exa-search
Скилл содержит готовые шаблоны интеграции с API Exa.ai через библиотеки exa_py для Python и exa-js для TypeScript. Агент учится вызывать метод search_and_contents, управлять параметрами извлечения текста и настраивать поиск похожих страниц через find_similar_and_contents.
В инструкциях расписаны различия режимов поиска: auto подходит для типовых запросов, neural работает с поиском по смыслу, а keyword ищет точные совпадения и артикулы. Отдельное внимание уделено фильтрам по доменам, диапазонам дат и генерации кратких сводок через флаг summary.
Без переменной окружения EXA_API_KEY запросы к API не выполняются. По умолчанию Exa отдаёт только ссылки, поэтому для загрузки текстов страниц требуется обязательно передавать параметр text=True.
Какие задачи решает
- встроить поиск по веб-страницам в проект на Python или TypeScript
- настроить извлечение цитат и текста страниц через API Exa
- подобрать режим поиска между нейронным и ключевым
- найти похожие материалы по заданному URL с фильтрацией доменов
Примеры запросов агенту
- Напиши функцию на Python с библиотекой exa_py для поиска статей по квантовым вычислениям с извлечением текста
- Сделай запрос через exa-js с фильтрацией по доменам techcrunch.com и venturebeat.com за 2024 год
- Как через Exa найти похожие статьи для указанной ссылки и исключить исходный сайт?
Как установить exa-search
1Через Skills CLI (Vercel)
npx skills add ejirocodes/agent-skills --skill exa-search -a claude-code2Вручную: положить файлы
~/.claude/skills/exa-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/exa-search/
1Через Skills CLI (Vercel)
npx skills add ejirocodes/agent-skills --skill exa-search -a codex2Вручную: положить файлы
.agents/skills/exa-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ejirocodes/agent-skills --skill exa-search -a cursor2Вручную: положить файлы
.cursor/skills/exa-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ejirocodes/agent-skills exa/skills/exa-search2Вручную: положить файлы
.github/skills/exa-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add ejirocodes/agent-skills --skill exa-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/ejirocodes/agent-skills --path exa/skills/exa-searchВручную: положить файлы
.devin/skills/exa-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ejirocodes/agent-skills --skill exa-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об exa-search
Как установить exa-search в Claude Code?
Выполните команду npx skills add ejirocodes/agent-skills --skill exa-search -a claude-code. Файлы скилла сохранятся в каталоге ~/.claude/skills/exa-search/.
Что делает скилл exa-search?
Он даёт ИИ-агенту правила и рабочие примеры кода для работы с поисковым API Exa.ai, включая выбор режимов, фильтрацию по датам и выгрузку текстового содержимого.
Почему поиск не возвращает текст страниц?
API Exa по умолчанию возвращает только URL и заголовки. Чтобы получить содержимое сайтов или фрагменты текста, в параметры запроса нужно явно передать text=True или highlights=True.
Исходный текст
SKILL.md · MIT
---
name: exa-search
description: "Exa.ai search API integration for neural and keyword web search with content retrieval. Use when implementing web search features, integrating Exa SDK (exa_py, exa-js), or retrieving web content. Triggers on: Exa, exa_py, exa-js, neural search, web search API, search_and_contents, searchAndContents, find_similar, findSimilar, domain filtering, date filtering, text extraction, page summaries, highlights, search auto mode, fast search, search categories, livecrawl, excluding domains, include text, exclude text, EXA_API_KEY."
license: MIT
metadata:
author: ejirocodes
version: '1.0.0'
---
# Exa Search Integration
## Quick Reference
| Topic | When to Use | Reference |
|-------|-------------|-----------|
| **Search Modes** | Choosing between auto, neural, and keyword search | [search-modes.md](references/search-modes.md) |
| **Filters** | Domain, date, text, and category filtering | [filters.md](references/filters.md) |
| **Contents** | Text extraction, highlights, summaries, livecrawl | [contents.md](references/contents.md) |
| **SDK Patterns** | Python (exa_py) and TypeScript (exa-js) usage | [sdk-patterns.md](references/sdk-patterns.md) |
## Essential Patterns
### Basic Search (Python)
```python
from exa_py import Exa
exa = Exa(api_key="your-api-key") # or set EXA_API_KEY env var
results = exa.search_and_contents(
"latest developments in quantum computing",
type="auto",
num_results=10,
text=True,
highlights=True
)
for result in results.results:
print(f"{result.title}: {result.url}")
print(result.text[:500])
```
### Basic Search (TypeScript)
```typescript
import Exa from "exa-js";
const exa = new Exa(process.env.EXA_API_KEY);
const results = await exa.searchAndContents(
"latest developments in quantum computing",
{
type: "auto",
numResults: 10,
text: true,
highlights: true,
}
);
results.results.forEach((result) => {
console.log(`${result.title}: ${result.url}`);
});
```
### Search with Filters
```python
results = exa.search_and_contents(
"AI startup funding rounds",
type="neural",
num_results=10,
include_domains=["techcrunch.com", "venturebeat.com"],
start_published_date="2024-01-01",
text={"max_characters": 2000},
summary=True
)
```
### Find Similar Links
```python
similar = exa.find_similar_and_contents(
"https://example.com/interesting-article",
num_results=10,
exclude_source_domain=True,
text=True
)
```
## Search Mode Selection
| Mode | When to Use | Notes |
|------|-------------|-------|
| `auto` | Default for most queries | Exa optimizes between neural/keyword automatically |
| `neural` | Natural language, conceptual queries | Best for "what is...", "how to...", topic exploration |
| `keyword` | Exact matches, technical terms, names | Best for specific product names, error codes, proper nouns |
## Common Mistakes
1. **Using `keyword` for conceptual queries** - Neural search understands intent better; use `auto` or `neural` for natural language questions
2. **Not setting `text=True`** - Search returns URLs only by default; explicitly request content with `text=True`
3. **Ignoring `highlights`** - Use `highlights=True` for relevant snippets without downloading full page text
4. **Missing API key** - Set `EXA_API_KEY` environment variable or pass explicitly to constructor
5. **Over-filtering initially** - Start with broad searches, then add domain/date filters to refine
6. **Not using `summary`** - For RAG applications, `summary=True` provides concise context without full page text
7. **Expecting scores in auto mode** - Relevance scores are only returned with `type="neural"`; auto mode doesn't include them
© ejirocodes · MIT · ejirocodes/agent-skills
Похожие скиллы
Все скиллы по теме «ИИ и ML» →Сначала — exa-search от других авторов.