# tavily-mcp

Даёт агенту инструменты поиска, извлечения данных, карты сайта и обхода страниц через Tavily. Пригодится, когда нужен свежий веб-контекст прямо в редакторе.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 2454
- Автор: tavily-ai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/tavily-ai/tavily-mcp
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/tavily-mcp

## Что делает

tavily-mcp подключает к ассистенту четыре инструмента: `tavily-search` ищет в вебе, `tavily-extract` вытаскивает данные со страниц, map строит структуру сайта, crawl обходит его по ссылкам. Работает как локально через `npx -y tavily-mcp`, так и удалённо — по адресу `https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>`. Второй вариант не требует ничего ставить на машину.

Для локального запуска нужен Node.js v20 или выше и ключ Tavily. Ключ передаётся переменной `TAVILY_API_KEY`; через неё же можно задать `DEFAULT_PARAMETERS` — JSON с параметрами по умолчанию для всех запросов, например `{"include_images":true, "search_depth": "basic", "max_results": 10}`. Удалённый сервер умеет OAuth: добавьте его без ключа в URL, откройте `/mcp` в Claude и пройдите авторизацию. Без ключа и без OAuth инструменты не заработают.

Если ключей в аккаунте несколько, OAuth возьмёт тот, что назван `mcp_auth_default`; личный приоритетнее командного. Сбросить сохранённые учётные данные можно командой `rm -rf ~/.mcp-auth` — это пригодится, когда авторизация зависла на старом ключе.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `TAVILY_API_KEY`, `DEFAULT_PARAMETERS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env TAVILY_API_KEY=<TAVILY_API_KEY> --env DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> --transport stdio tavily-mcp -- npx -y tavily-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add tavily-mcp --env TAVILY_API_KEY=<TAVILY_API_KEY> --env DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> -- npx -y tavily-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tavily-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "tavily-mcp"
            ],
            "env": {
                "TAVILY_API_KEY": "<TAVILY_API_KEY>",
                "DEFAULT_PARAMETERS": "<DEFAULT_PARAMETERS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tavily-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "tavily-mcp"
            ],
            "env": {
                "TAVILY_API_KEY": "<TAVILY_API_KEY>",
                "DEFAULT_PARAMETERS": "<DEFAULT_PARAMETERS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e TAVILY_API_KEY=<TAVILY_API_KEY> -e DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> tavily-mcp npx -y tavily-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти свежую документацию по библиотеке, которой нет в обучающих данных модели
- вытащить текст и таблицы с чужой страницы без ручного копирования
- построить карту разделов сайта перед парсингом
- обойти сайт по ссылкам и собрать нужные страницы
- подключить веб-поиск к агенту в Cursor или Claude

## Примеры запросов агенту
- Найди через tavily-search, как в последней версии Next.js настраивается middleware.
- Извлеки tavily-extract оглавление и цены с этой страницы.
- Построй карту сайта docs.example.com и покажи разделы про авторизацию.

## Похожие
- [tavily-dynamic-search](https://affpapa.org/nevibecode/skills/tavily-dynamic-search.md) — скилл · 13500 установок
- [tavily-usage](https://affpapa.org/nevibecode/skills/tavily-usage.md) — скилл · 758 установок
- [tavily-search](https://affpapa.org/nevibecode/skills/tavily-search.md) — скилл · 36100 установок
- [web-search-tavily](https://affpapa.org/nevibecode/skills/web-search-tavily.md) — скилл · 1100 установок
- [tavily](https://affpapa.org/nevibecode/skills/tavily.md) — скилл · 627 установок
- [web-search](https://affpapa.org/nevibecode/skills/web-search.md) — скилл · 110000 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md