Tavily integrations
Tavily is a search engine specifically designed for AI agents, providing search, extract, crawl, and map APIs so developers can connect their applications to real-time online information. Tavily's primary mission is to deliver factual and reliable information from trusted sources, enhancing the accuracy and reliability of AI-generated content and reasoning.
The @langchain/tavily package exposes Tavily Search, Extract, Crawl, Map, and Research endpoints as LangChain tools.
Installation and setup
Install the Tavily integration package for LangChain JavaScript:
npmyarnpnpm
npm install @langchain/tavily @langchain/coreyarn add @langchain/tavily @langchain/corepnpm add @langchain/tavily @langchain/coreSet up a Tavily API key and set it as an environment variable named TAVILY_API_KEY:
export TAVILY_API_KEY="your-api-key"Tools
TavilySearch
A search tool that returns real-time, LLM-ready results from Tavily's Search API.
See a usage example.
import { TavilySearch } from "@langchain/tavily";TavilyExtract
A tool that returns the cleaned, parsed content of one or more URLs.
See a usage example.
import { TavilyExtract } from "@langchain/tavily";TavilyCrawl
A tool that performs a structured web traversal from a base URL, with optional natural-language instructions and path/domain filters.
See a usage example.
import { TavilyCrawl } from "@langchain/tavily";TavilyMap
A tool that discovers the URL structure of a site without extracting page content.
See a usage example.
import { TavilyMap } from "@langchain/tavily";TavilyResearch
A tool that runs structured research tasks and returns synthesized results (optionally streamed).
import { TavilyResearch } from "@langchain/tavily";TavilyGetResearch
A tool that retrieves research output by request_id from a prior TavilyResearch invocation.
import { TavilyGetResearch } from "@langchain/tavily";Components reference
| Class | Abstraction | Import path | Description |
|---|---|---|---|
TavilySearch | Tool | import { TavilySearch } from "@langchain/tavily" | Returns search results from the Tavily Search API. |
TavilyExtract | Tool | import { TavilyExtract } from "@langchain/tavily" | Extracts cleaned content from one or more URLs. |
TavilyCrawl | Tool | import { TavilyCrawl } from "@langchain/tavily" | Crawls a site starting from a base URL with depth and breadth controls. |
TavilyMap | Tool | import { TavilyMap } from "@langchain/tavily" | Discovers the URL structure of a site without extracting page content. |
TavilyResearch | Tool | import { TavilyResearch } from "@langchain/tavily" | Runs structured research tasks against the Tavily Research API. |
TavilyGetResearch | Tool | import { TavilyGetResearch } from "@langchain/tavily" | Fetches research results by request_id. |