tavily-usage — скилл для Claude Code: что делает и как установить
Скилл направляет агента искать данные в сети и извлекать текст страниц через MCP-сервер Tavily. Потребуется ключ API.
npx skills add fcakyon/claude-codex-settings --skill tavily-usage -a claude-codeЧто делает tavily-usage
Скилл координирует работу двух MCP-инструментов: mcp__tavily__tavily_search и mcp__tavily__tavily-extract. Сначала агент ищет релевантные страницы по ключевым словам. После этого он обращается к выбранным адресам для извлечения структурированного текста.
Внутри предусмотрен скрипт хука tavily_extract_to_advanced.py. Он переключает извлечение контента в продвинутый режим для повышения точности ответов. Для работы обязательно настроить ключ TAVILY_API_KEY в переменных окружения терминала.
Полноценный парсинг страницы стоит дороже обычного поиска. Из-за этого скилл предписывает сначала отбирать ссылки поисковым запросом и не запускать извлечение без необходимости.
Какие задачи решает
- найти информацию и ссылки в поисковой выдаче по ключевым словам
- извлечь структурированный текст с конкретной веб-страницы
- снизить расход запросов за счёт фильтрации адресов перед парсингом
Примеры запросов агенту
- Найди в сети свежие обновления библиотеки и покажи ссылки
- Извлеки подробный текст статьи по этому адресу
- Сделай поиск через Tavily по теме проекта и разбери найденные источники
Как установить tavily-usage
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill tavily-usage -a claude-code2Вручную: положить файлы
~/.claude/skills/tavily-usage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tavily-usage/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill tavily-usage -a codex2Вручную: положить файлы
.agents/skills/tavily-usage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill tavily-usage -a cursor2Вручную: положить файлы
.cursor/skills/tavily-usage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fcakyon/claude-codex-settings tavily-usage2Вручную: положить файлы
.github/skills/tavily-usage/SKILL.md1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill tavily-usage -a gemini-cli2Командой платформы
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/tavily-tools/skills/tavily-usageВручную: положить файлы
.devin/skills/tavily-usage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill tavily-usage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tavily-usage
Как установить tavily-usage в Claude Code?
Запустите команду npx skills add fcakyon/claude-codex-settings --skill tavily-usage -a claude-code. Она скопирует файлы скилла в конфигурацию окружения.
Что делает tavily-usage?
Он задаёт сценарий веб-поиска и выгрузки содержимого через Tavily MCP. Скилл помогает агенту сначала найти ссылки, а затем разобрать конкретные страницы.
Какие переменные нужны для запуска?
Перед работой необходимо экспортировать ключ TAVILY_API_KEY в командной оболочке. Без этого ключа запросы к MCP завершатся с ошибкой.
Исходный текст
SKILL.md · Apache-2.0
--- name: tavily-usage description: This skill should be used when user asks to "search the web", "fetch content from URL", "extract page content", "use Tavily search", "scrape this website", "get information from this link", or "web search for X". --- # Tavily Search and Extract Use Tavily MCP tools for web search and content retrieval operations. ## Tool Selection ### Tavily Search (`mcp__tavily__tavily_search`) Use for: - Keyword-based searches across the web - Finding relevant pages and content - Quick answer gathering - Multiple result discovery **Best for**: Initial research, finding sources, broad queries ### Tavily Extract (`mcp__tavily__tavily-extract`) Use for: - Getting detailed content from specific URLs - Deep analysis of page content - Structured data extraction - Following up on search results **Best for**: In-depth analysis, specific URL content, detailed information ## Hook Behavior `tavily_extract_to_advanced.py` hook automatically upgrades extract calls to advanced mode for better accuracy when needed. ## Integration Pattern 1. Use `mcp__tavily__tavily_search` for discovery phase 2. Analyze results to find relevant URLs 3. Use `mcp__tavily__tavily-extract` for detailed content on specific URLs 4. Process extracted content for user needs ## Environment Variables Tavily MCP requires: - `TAVILY_API_KEY` - API key from Tavily (tvly-...) Configure in shell before using the plugin. ## Cost Considerations - Search is cheaper than extract - Use search to filter relevant URLs first - Only extract URLs that are likely relevant - Cache results when possible
© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings