{"skill":{"slug":"mdgs-tavily-search-skill","displayName":"mdgs-tavily-search-skill","summary":"使用 Tavily API 进行网络搜索、网页内容提取、抓取、映射和研究。当用户需要搜索信息、获取网页内容、从网站抓取数据、绘制网站地图或进行深度研究时使用此技能。AI 应根据任务自动选择最合适的模式。","description":"---\nname: mdgs-tavily-search-skill\ndescription: 使用 Tavily API 进行网络搜索、网页内容提取、抓取、映射和研究。当用户需要搜索信息、获取网页内容、从网站抓取数据、绘制网站地图或进行深度研究时使用此技能。AI 应根据任务自动选择最合适的模式。\n---\n\n# Mdgs Tavily Search Skill\n\n使用 Tavily API 进行网络搜索和信息提取。\n\n## 快速开始\n\n### 前置要求\n\n首先安装依赖：\n```bash\nnpm install @tavily/core\n```\n\n设置 API Key：\n```bash\nexport TAVILY_API_KEY=\"tvly-your-api-key\"\n```\n\n### 初始化客户端\n\n```javascript\nconst { tavily } = require(\"@tavily/core\");\n\nconst apiKey = process.env.TAVILY_API_KEY;\nif (!apiKey) {\n  throw new Error(\"请配置 TAVILY_API_KEY 环境变量。访问 https://tavily.com 获取 API Key\");\n}\n\nconst tvly = tavily({ apiKey });\n```\n\n## 模式选择指南\n\nAI 应根据任务类型自动选择合适的模式：\n\n| 任务类型 | 推荐模式 | 说明 |\n|---------|---------|------|\n| 快速问答、信息检索 | search | 获取搜索结果和答案 |\n| 获取特定网页内容 | extract | 提取单个 URL 的主要内容 |\n| 批量抓取网站内容 | crawl | 抓取整个网站或多个页面 |\n| 了解网站结构 | map | 获取网站的页面地图 |\n| 深度研究主题 | research | 综合多个来源的深度研究 |\n\n## 模式详解\n\n### 1. 搜索网页 (search)\n\n适用于：快速问答、信息检索、新闻搜索\n\n```javascript\nconst response = await tvly.search(\"Who is Leo Messi?\");\nconsole.log(response);\n```\n\n**选项：**\n```javascript\nconst response = await tvly.search(\"Python 教程\", {\n  searchDepth: \"basic\", // \"basic\" 或 \"advanced\"\n  maxResults: 10,\n  includeAnswer: true,\n  includeRawContent: false,\n  includeImages: false\n});\n```\n\n### 2. 提取网页 (extract)\n\n适用于：获取特定网页的详细内容\n\n```javascript\nconst response = await tvly.extract(\"https://en.wikipedia.org/wiki/Artificial_intelligence\");\nconsole.log(response);\n```\n\n**选项：**\n```javascript\nconst response = await tvly.extract(\"https://example.com\", {\n  includeImages: true\n});\n```\n\n### 3. 抓取网页 (crawl)\n\n适用于：批量抓取网站内容、深度内容获取\n\n```javascript\nconst response = await tvly.crawl(\"https://docs.tavily.com\", { \n  instructions: \"Find all pages on the Python SDK\" \n});\nconsole.log(response);\n```\n\n**选项：**\n```javascript\nconst response = await tvly.crawl(\"https://example.com\", {\n  instructions: \"提取所有产品页面\",\n  maxDepth: 2,\n  maxPages: 10\n});\n```\n\n### 4. 绘制网页映射 (map)\n\n适用于：了解网站结构、发现相关页面\n\n```javascript\nconst response = await tvly.map(\"https://docs.tavily.com\");\nconsole.log(response);\n```\n\n**选项：**\n```javascript\nconst response = await tvly.map(\"https://example.com\", {\n  depth: 2,\n  maxPages: 20\n});\n```\n\n### 5. 创建研究任务 (research)\n\n适用于：深度研究、综合多来源分析\n\n```javascript\nconst response = await tvly.research(\"What are the latest developments in AI?\");\nconsole.log(response);\n```\n\n**选项：**\n```javascript\nconst response = await tvly.research(\"最新 AI 发展动态\", {\n  depth: \"extensive\", // \"basic\" 或 \"extensive\"\n  maxSources: 10\n});\n```\n\n## 使用脚本\n\n项目提供了封装好的脚本：\n\n### 搜索\n```bash\nnode scripts/tavily.js search \"搜索内容\" [--depth basic|advanced] [--max-results N]\n```\n\n### 提取\n```bash\nnode scripts/tavily.js extract \"https://example.com\"\n```\n\n### 抓取\n```bash\nnode scripts/tavily.js crawl \"https://example.com\" --instructions \"提取所有页面\"\n```\n\n### 映射\n```bash\nnode scripts/tavily.js map \"https://example.com\" [--depth N]\n```\n\n### 研究\n```bash\nnode scripts/tavily.js research \"研究主题\" [--depth basic|extensive]\n```\n\n## API Key 配置\n\n**重要：** 使用此技能前必须配置 API Key。\n\n1. 访问 [tavily.com](https://tavily.com) 注册账号\n2. 获取 API Key\n3. 设置环境变量：\n   ```bash\n   export TAVILY_API_KEY=\"tvly-your-actual-api-key\"\n   ```\n\n或在脚本/代码中直接传入：\n```javascript\nconst tvly = tavily({ apiKey: \"tvly-your-actual-api-key\" });\n```\n\n## 响应格式\n\n### search response\n```json\n{\n  \"answer\": \"回答文本\",\n  \"results\": [{ \"title\": \"\", \"url\": \"\", \"content\": \"\", \"score\": 0.95 }],\n  \"images\": []\n}\n```\n\n### extract response\n```json\n{\n  \"results\": [{ \"url\": \"\", \"content\": \"\", \"raw_content\": \"\" }]\n}\n```\n\n### crawl response\n```json\n{\n  \"results\": [{ \"url\": \"\", \"content\": \"\" }]\n}\n```\n\n### map response\n```json\n{\n  \"results\": [{ \"url\": \"\", \"title\": \"\" }]\n}\n```\n\n### research response\n```json\n{\n  \"answer\": \"综合研究报告\",\n  \"findings\": [{ \"content\": \"\", \"sources\": [] }]\n}\n```\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":673,"installsAllTime":25,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773304337952,"updatedAt":1778491852854},"latestVersion":{"version":"1.0.0","createdAt":1773304337952,"changelog":"# 更新日志\n\n## 开发者: 码道公社\n\n## [1.0.0] - 2026-03-12\n\n### Added\n- 初始版本发布\n- 支持 5 种 Tavily API 模式：\n  - 搜索 (search)\n  - 提取 (extract)\n  - 抓取 (crawl)\n  - 映射 (map)\n  - 研究 (research)\n- 提供命令行脚本\n- API Key 错误提示\n- AI 自动选择模式","license":"MIT-0"},"metadata":null,"owner":{"handle":"343195246","userId":"s17ew7yafs52d3pdjgyx5kq28s848rxq","displayName":"343195246","image":"https://avatars.githubusercontent.com/u/30712934?v=4"},"moderation":null}