mcpField
T
tavily-search-and-fetch

tavily-search-and-fetch

github.com/rioiart生产力038 次安装37 周前更新
代码仓库

关于 tavily-search-and-fetch

通过 Tavily API 进行网页研究的命令行技能，适用于需要搜索、提取网页内容、发现站点 URL 或生成带引用报告的用户。不同脚本针对各项任务提供选项，包括域名和时间筛选及结构化输出。

主要功能

  1. 01按条件筛选网页搜索结果
  2. 02提取最多 20 个 URL 的内容
  3. 03通过 sitemap 发现站点 URL
  4. 04生成带引用的研究报告
  5. 05将结果保存为结构化文件

适用场景

  1. 01查询近期新闻主题
  2. 02收集指定文章的内容
  3. 03梳理文档站点页面
  4. 04生成带引用的比较报告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rioiart/tavily-skill --skill tavily-search-and-fetch

安装后在 Claude Code 中输入/tavily-search-and-fetch确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
references/
api_reference.md
scripts/
tavily_crawl.sh
tavily_extract.sh
tavily_research.sh
tavily_search.sh
tavily_sitemap.sh

详细介绍

Tavily Researcher

通过 Tavily 面向大模型优化的 API 进行网络研究：搜索、提取、站点地图和研究。

设置

需要设置 TAVILY_API_KEY 环境变量。在 https://app.tavily.com 获取免费密钥（每月 1000 点数）。

选择合适的工具

需求脚本
网络搜索结果tavily_search.sh
特定 URL 中的内容tavily_extract.sh
发现网站上的 URL（快速）tavily_sitemap.sh
带引用的 AI 综合报告tavily_research.sh

快速开始

搜索
scripts/tavily_search.sh "What is retrieval augmented generation?" --include-answer
新闻搜索
scripts/tavily_search.sh "AI regulation updates" --topic news --time-range week
从 URL 提取内容
scripts/tavily_extract.sh https://example.com/article1 https://example.com/article2
发现网站上的 URL
scripts/tavily_sitemap.sh https://docs.example.com --max-depth 2 --limit 100
AI 研究报告
scripts/tavily_research.sh "Compare LangGraph vs CrewAI for multi-agent systems" --model pro

脚本

tavily_search.sh

标准网络搜索。返回标题、URL、摘要片段，以及可选的 AI 答案。

关键选项：

  • --depth ultra-fast|fast|basic|advanced — 在速度和相关性之间权衡
  • --topic general|news|finance — 根据内容类型优化
  • --include-answer — 获取 AI 生成的摘要
  • --include-raw-content — 获取完整页面内容
  • --time-range day|week|month|year — 按时间范围筛选
  • --chunks-per-source N — 每个来源的内容块数（1-5，适用于 advanced/fast）
  • --include-domains / --exclude-domains — 筛选来源
tavily_extract.sh

从指定 URL 提取完整内容（一次最多 20 个）。

关键选项：

  • --depth basic|advanced — 对 JavaScript 较多的页面使用 advanced
  • --query TEXT — 按相关性重新排列内容块
  • --chunks-per-source N — 仅返回相关内容块（1-5，需使用 --query）
  • --format markdown|text — 输出格式
tavily_sitemap.sh

发现网站上的 URL，不提取内容。比抓取更快——可先用它了解网站结构。

关键选项：

  • --max-depth N — 抓取深度 1-5（从 1 开始）
  • --limit N — URL 总数上限（默认：50）
  • --instructions TEXT — 聚焦于特定类型的页面
tavily_research.sh

通过 AI 综合研究内容并提供引用。耗时 30-120 秒。

关键选项：

  • --model mini|pro|auto — mini 适用于聚焦查询，pro 适用于全面分析
  • --citation-format numbered|mla|apa|chicago
  • --output-schema JSON — 获取结构化 JSON 输出
  • --output-file PATH — 将结果保存到文件

成本优化

任务建议方式点数
快速核实事实tavily_search.sh --include-answer1
深入搜索tavily_search.sh --depth advanced2
完整文章内容tavily_extract.sh <urls>每 5 个 URL 1 点
发现网站 URLtavily_sitemap.sh1
AI 研究报告tavily_research.sh不定

特定领域搜索

# Only search specific sites
scripts/tavily_search.sh "async python" --include-domains docs.python.org,realpython.com

# Exclude unreliable sources
scripts/tavily_search.sh "health advice" --exclude-domains reddit.com,quora.com

API 参考

完整参数文档请参阅 references/api_reference.md。

评论

支持 Markdown