Когда звать
- Когда агенту нужны свежие данные из интернета со ссылками на источники, а не пересказ по памяти.
- Когда есть адрес страницы или сайта и нужно достать оттуда чистый текст без меню и рекламы.
Что это
Tavily - сервис поиска в интернете, сделанный под AI-агентов. Для Claude Code и Codex у него есть две вещи, которые работают в паре:
- программа
tvlyдля терминала - она и ходит в интернет: ищет, достаёт текст страниц, обходит сайты; - набор скиллов
tavily-*- папки соSKILL.md, которые объясняют агенту, какую командуtvlyвзять под задачу и как её вызвать.
Скиллы без программы не работают: внутри них вызовы tvly. Поэтому ставятся оба, и официальная установка делает это одной командой.
В наборе восемь скиллов (по README репозитория на 28 сентября 2026 года):
- tavily-search - поиск по теме, с фильтром по сайтам и по свежести;
- tavily-extract - чистый текст с одной или нескольких страниц, в том числе с тех, что собираются скриптами;
- tavily-map - список всех адресов на сайте без скачивания текста;
- tavily-crawl - обход раздела сайта с сохранением страниц в файлы;
- tavily-research - долгое исследование по многим источникам, отчёт со ссылками, по README занимает 30-120 секунд;
- tavily-dynamic-search - отсеивает и убирает повторы в больших выдачах, чтобы не забить память агента;
- tavily-cli - общий: установка, вход, выбор команды;
- tavily-best-practices - справка для тех, кто встраивает Tavily в свой продукт.
Зачем он нам
Мы пользуемся Tavily в работе каждый день: когда агенту нужно что-то найти в интернете или прочитать конкретную страницу. Главное - агент отвечает со ссылками на источники, и каждую цифру можно открыть и проверить. Без такого инструмента агент либо отвечает по памяти, либо читает страницу целиком вместе с меню и подвалом и тратит на это память сессии.
Чаще всего нужны две команды: tvly search, чтобы найти страницы по теме, и tvly extract, чтобы достать текст с известного адреса. Долгий режим исследования берём редко и только под большие вопросы: он тратит больше кредитов.
Как поставить в Claude Code
Порядок сверен с README репозиториев tavily-ai/skills и tavily-ai/tavily-cli на 28 сентября 2026 года.
Одной командой (так советует сам Tavily). В терминале:
curl -fsSL https://cli.tavily.com/install.sh | bash
Установщик ставит программу tvly. На обычном компьютере он сам запускает настройку tvly init, если нет - запусти её руками:
tvly init --agent claude-code
Настройка делает три вещи: входит в аккаунт Tavily через браузер (или берёт уже сохранённый вход), ставит восемь скиллов в ~/.agents/skills и показывает их Claude Code, а в конце делает пробный поиск. Повторный запуск безопасен. После установки перезапусти сессию Claude Code.
Плагином из официального каталога. Tavily есть в каталоге плагинов claude-plugins-official, автор в карточке - Tavily Team. Плагин ставит те же скиллы, но саму программу tvly всё равно нужно поставить командой выше.
/plugin install tavily@claude-plugins-official
Без входа, чтобы попробовать. tvly search и tvly extract работают и без аккаунта, но с ограничением на частоту запросов. Поставить скиллы и не входить - tvly init --skip-auth. Для map, crawl и research вход нужен.
Другой способ поставить только скиллы - npx skills add https://github.com/tavily-ai/skills, программу тогда ставят отдельно: uv tool install tavily-cli или pip install tavily-cli. Порядок установки любого скилла - в статье как установить скилл в Claude Code.
Как поставить в Codex
Так же, как в Claude Code: сначала программа, потом настройка с выбором Codex.
curl -fsSL https://cli.tavily.com/install.sh | bash
tvly init --agent codex
По README настройка сама находит Claude Code, Codex и Cursor. Если стоят несколько, можно поставить во все найденные сразу: tvly init --all --yes. Скиллы ложатся в ~/.agents/skills - это та папка, где Codex ищет личные скиллы. После установки перезапусти Codex. Как в Codex устроены скиллы - в статье Codex skills.
Как звать и что писать
Отдельно звать не нужно: скиллы срабатывают сами, когда задача про интернет. Примеры запросов из документации Tavily:
Найди свежие новости про регулирование AI за неделю
Обойди документацию Stripe API и сохрани её к себе в папку
Можно позвать и явно, по имени скилла: /tavily-search, /tavily-extract, /tavily-crawl, /tavily-research.
Совет из самого скилла tavily-cli: начинать с простого и усложнять по необходимости. Нет адреса - поиск. Есть адрес - извлечение текста. Большой сайт, нужную страницу не найти - сначала список адресов, потом нужная страница. Нужен весь раздел - обход. И только для большого вопроса со многими источниками - исследование.
Чтобы ответ был полезнее, говори агенту, на какие сайты опираться и за какой срок: у поиска есть фильтр по сайтам и по времени.
Найди, что изменилось в ценах Claude за последний месяц.
Бери только официальные страницы Anthropic, к каждому пункту дай ссылку.
Что держать в голове
- Поиск платный, но с бесплатным запасом. По странице кредитов Tavily на 28 сентября 2026 года - 1 000 бесплатных кредитов в месяц без карты. Сверх этого - платные тарифы. Обычный поиск стоит 1 кредит, подробный - 2, извлечение текста - 1 кредит за каждые 5 страниц. Исследование - от 4 до 250 кредитов за один запрос, в зависимости от режима.
- Цифры с чужих сайтов - это то, что заявлено на сайте, а не проверенный факт. Tavily находит и приносит страницу, но не проверяет, правду ли на ней пишут.
- Скиллы привязаны к версии программы. Чтобы обновить скиллы, по README сначала
tvly update, потом сноваtvly init.
Вопросы и ответы
Это скилл, плагин или MCP? Всё сразу, по-разному. Основа - программа tvly и набор скиллов к ней, в Claude Code их можно поставить и плагином из официального каталога. Отдельно у Tavily есть MCP-сервер и коннектор для приложения Claude - это другой способ подключения, на этой странице речь о скиллах.
Нужен ли ключ API? Для пробы нет: поиск и извлечение текста работают без входа с ограничением. Для постоянной работы - вход через браузер командой tvly init или tvly login. Вход ключом тоже есть: tvly login --api-key.
Где хранится вход? По документации программы ключ, введённый через tvly login --api-key, лежит в ~/.tavily/config.json, доступном только твоему пользователю. Выйти - tvly logout.
Зачем он, если у агента есть свой поиск? Tavily умеет больше, чем найти страницу: достаёт чистый текст, фильтрует по сайтам и срокам, обходит сайты целиком и составляет отчёт по многим источникам. И ставится одинаково в Claude Code и в Codex.
Автор и источник
Набор чужой, автор - компания Tavily, лицензия MIT у обоих репозиториев. Описание и команды сверены с README tavily-ai/skills и tavily-ai/tavily-cli, с документацией Tavily про скиллы для агентов, программу tvly и кредиты, а наличие плагина - с каталогом claude-plugins-official на 28 сентября 2026 года. Инструмент обновляется, поэтому детали сверяй по первоисточнику.