chore(tavily): add README.md (#8030)

Author: benjamincburns

libs/langchain-tavily/README.md

@@ -0,0 +1,78 @@
+# `@langchain/tavily`
+
+[![NPM - Version](https://img.shields.io/npm/v/@langchain/tavily?style=flat-square&label=%20)](https://www.npmjs.com/package/@langchain/tavily)
+
+This package provides integrations for the [Tavily](https://tavily.com/) search engine within LangChain.js. Tavily is a search engine built specifically for AI agents (LLMs), delivering real-time, accurate, and factual results at speed.
+
+This package exposes two tools:
+- `TavilySearch`: Performs a search optimized for LLMs and RAG.
+- `TavilyExtract`: Extracts raw content from a list of URLs.
+
+## Installation
+
+```bash
+npm install @langchain/tavily
+```
+
+## Setup
+
+You need a Tavily API key to use these tools. You can get one [here](https://app.tavily.com). Set it as an environment variable:
+
+```typescript
+process.env.TAVILY_API_KEY = "YOUR_API_KEY";
+```
+
+## Usage
+
+### TavilySearch
+
+```typescript
+import { TavilySearch } from "@langchain/tavily";
+
+const tool = new TavilySearch({
+  maxResults: 5,
+  // You can set other constructor parameters here, e.g.:
+  // topic: "general",
+  // includeAnswer: false,
+  // includeRawContent: false,
+  // includeImages: false,
+  // searchDepth: "basic",
+});
+
+// Invoke with a query
+const results = await tool.invoke({
+  query: "what is the current weather in SF?"
+});
+
+console.log(results);
+```
+
+### TavilyExtract
+
+```typescript
+import { TavilyExtract } from "@langchain/tavily";
+
+const tool = new TavilyExtract({
+  // Constructor parameters:
+  // extractDepth: "basic",
+  // includeImages: false,
+});
+
+// Invoke with a list of URLs
+const results = await tool.invoke({
+  urls: ["https://en.wikipedia.org/wiki/Lionel_Messi"]
+});
+
+console.log(results);
+```
+
+## Documentation
+
+For more detailed information, check out the documentation pages:
+
+- **TavilySearch**: [http://js.langchain.com/docs/integrations/tools/tavily_search/](http://js.langchain.com/docs/integrations/tools/tavily_search/)
+- **TavilyExtract**: [http://js.langchain.com/docs/integrations/tools/tavily_extract/](http://js.langchain.com/docs/integrations/tools/tavily_extract/)
+
+## License
+
+This package is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.