/ Каталог / Песочница / Tavily MCP
● Официальный tavily-ai 🔑 Нужен свой ключ

Tavily MCP

автор tavily-ai · tavily-ai/tavily-mcp

Tavily MCP предоставляет вашему агенту веб-поиск, извлечение страниц, карту сайта и сканирование — уже отформатированные для LLM, поэтому вы не тратите токены на очищенную разметку.

Tavily — это поисковый API, разработанный для агентов искусственного интеллекта: ответы возвращаются в виде чистого текста с источниками, а не 50 КБ HTML. Сервер MCP предоставляет четыре инструмента (поиск, извлечение, сопоставление, сканирование), которые вы можете использовать в реальных рабочих процессах исследования. Требуется бесплатный ключ API от tavily.com. Работает «из коробки» в Claude Desktop, Cursor, Windsurf, Claude Code — установка через npx.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

tavily-mcp.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tavily-mcp",
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "tavily-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "tavily-mcp@latest"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add tavily-mcp -- npx -y tavily-mcp@latest

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Tavily MCP

Ответьте на вопрос о том, что произошло после закрытия модели.

👤 Любой, кто использует Claude с вопросами, требующими свежей информации. ⏱ ~5 min beginner

Когда использовать: Вы спрашиваете о выпуске 2026 года, недавнем CVE, новой странице с ценами или сегодняшнем рынке — модель не знает и должна пойти посмотреть.

Предварительные требования
  • Ключ API Тавили — Зарегистрируйтесь на tavily.com (уровень бесплатного пользования = 1000 звонков в месяц)
  • Тавили MCP установлен — Вставьте приведенный выше блок конфигурации в настройки MCP вашего клиента.
Поток
  1. Спросите напрямую
    Что Anthropic добавила в Claude Sonnet 4.7 в этом месяце? Используйте Tavily, чтобы найти объявление и суммировать его с источниками.✓ Скопировано
    → Агент вызывает tavily_search и возвращает сводку со связанными источниками.
  2. Детализация по одному источнику
    Второй источник выглядит наиболее авторитетным — используйте tavily_extract, чтобы получить его полный текст и процитировать точную строку о контекстном окне.✓ Скопировано
    → Прямая цитата с URL + номером абзаца

Итог: Текущий, цитируемый ответ за один раз — без ручного поиска в Google.

Подводные камни
  • Поиск сначала выдал SEO-мусор — Добавьте подсказки к сайту: «... с anthropic.com или официального блога anthropic».
  • Резюме расходятся из источников — Требуйте прямых кавычек — «перефразируйте, но сохраняйте точно цифры, даты и имена».
Сочетать с: filesystem · memory

Выполните сканирование конкурентного продукта за один сеанс

👤 ПМ, основатели, маркетологи ⏱ ~30 min intermediate

Когда использовать: К концу дня вам понадобится одностраничное описание каждого конкурента в определенной категории функций.

Поток
  1. Откройте для себя конкурентов
    Используя Tavily, найдите 8 лучших продуктов, конкурирующих с нами в категории «CRM на основе искусственного интеллекта для малого и среднего бизнеса». Для каждого возвращайте имя, URL-адрес, однострочный текст и год основания.✓ Скопировано
    → Структурированная таблица из 8 строк со ссылками на источники
  2. Составьте карту каждого сайта
    Для каждого конкурента создайте tavily_map его сайт, чтобы найти страницы с ценами и функциями. Верните URL-адреса.✓ Скопировано
    → 2 URL-адреса на каждого конкурента
  3. Извлечь цены
    tavily_extract каждую страницу с ценами и создайте сетку сравнения: название плана, ежемесячная цена, 3 главных отличия.✓ Скопировано
    → Чистая сетка; ячейки содержат URL-адрес страницы с ценами

Итог: Бриф с источниками, которым можно поделиться. Готов к показу слайда PMM за 30 минут.

Подводные камни
  • Цены на JS-рендеринг и экстракт не учитывают это — Вернитесь к tavily_crawl с помощью render=on или напрямую нажмите на карту сайта /pricing.
Сочетать с: filesystem

Напишите руководство с проверенными ссылками.

👤 Технические писатели, DevRel ⏱ ~25 min intermediate

Когда использовать: Вы публикуете инструкции, и сегодня каждая внешняя ссылка должна привести к нужному контенту.

Поток
  1. Собрать рекомендации кандидатов
    Используя tavily_search, найдите 5 лучших страниц канонической документации для «Потока OAuth 2.1 PKCE». Предпочитайте RFC и документацию поставщиков блогам.✓ Скопировано
    → 5 URL-адресов с кратким обоснованием каждый
  2. Проверьте каждый
    tavily_extract each URL. For each, confirm the page still covers PKCE and flag any that look redirected or stale.✓ Скопировано
    → Per-URL live verdict
  3. Embed in the draft
    Rewrite my draft tutorial to cite only the verified URLs, with anchor text that matches the page's actual heading.✓ Скопировано
    → Updated draft; every link text matches the real page heading

Итог: Опубликованное руководство с нулевыми мертвыми ссылками и точным якорным текстом.

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

tavily-mcp + filesystem

Search, extract into disk, then analyze locally without re-fetching

Search Tavily for recent OWASP top-10 sources, extract them, save to /research/owasp/, then compare the content offline.✓ Скопировано
tavily-mcp + memory

Build a research journal that persists between sessions

For each Tavily search, save a one-line note and the URLs to memory under 'project:acme'. Next session, reuse.✓ Скопировано
tavily-mcp + context7

Tavily for web context + Context7 for library docs — don't confuse them

Use Context7 for docs questions; Tavily for news, blog posts, and anything not in library indexes.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
tavily_search query: str, max_results?: int, search_depth?: 'basic'|'advanced', include_domains?: str[] Primary tool — one query, LLM-ready snippets with URLs 1 API call
tavily_extract urls: str[], extract_depth?: 'basic'|'advanced' You already have a URL and want clean text — no HTML, no ads 1 API call per URL
tavily_map url: str, max_depth?: int, categories?: str[] Discover a site's structure — useful before extract/crawl 1 API call
tavily_crawl url: str, max_depth?: int, limit?: int, instructions?: str Broad ingest of a small site or doc section — expensive, prefer extract when you already know the URLs Multiple API calls (one per page)

Стоимость и лимиты

Во что обходится

Квота API
Free tier = 1,000 API calls/month; scaling plans from $30/mo
Токенов на вызов
Returns ~500–5000 tokens of clean content — much less than raw HTML would
Деньги
Free tier covers individual daily use; heavy workflows need paid
Совет
Prefer tavily_search over tavily_crawl — search is one call, crawl is N. Only crawl when you truly need breadth.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: TAVILY_API_KEY in env var (set in the MCP config's env block)
Исходящий трафик: Queries and URLs you pass are sent to api.tavily.com. Don't paste proprietary info into the query string.

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized

Double-check TAVILY_API_KEY in your MCP config. The env block lives inside the server config, not at top level.

Проверить: Call any Tavily tool; if the error persists, rotate the key in tavily.com dashboard
Empty results despite a real query

Switch search_depth from 'basic' to 'advanced' for niche topics; add include_domains to bias toward authoritative sources

Проверить: Repeat with search_depth: 'advanced'
tavily_extract returns paywalled gibberish

Tavily follows robots.txt and respects paywalls. For paywalled content, note it's unreachable — don't try to bypass.

429 Rate limit

Free tier = 60 RPM. Space out calls, or upgrade at tavily.com. The MCP auto-backs-off once, then surfaces the error.

Проверить: Check usage in tavily.com dashboard

Альтернативы

Tavily MCP в сравнении

АльтернативаКогда использоватьКомпромисс
exa-mcp-serverYou want Exa's neural/embedding-style search and similarityDifferent result quality on different query types; both are LLM-tuned
fetchYou have the URL and just want HTML → markdown, no searchNo search; no structured extract; you handle the URL discovery
perplexity-askYou want a research-level answer synthesized by Perplexity, not raw resultsHigher latency, higher cost, less composable — it's one big tool
firecrawl-mcp-serverYou need heavy crawling or JS rendering as a core workflowPricier; overkill for one-off lookups

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills