dwsy/tavily-search-free

Tavily Search Skill

This skill utilizes the Tavily Search API, providing clean, real-time web search results optimized for LLMs and RAG pipelines.

执行环境

| 路径类型 | 路径 | 基准目录 | |---------|------|---------| | 技能目录 | ~/.pi/agent/skills/tavily-search-free/ | 固定位置 | | 主脚本 | ~/.pi/agent/skills/tavily-search-free/scripts/tavily_search.py | 技能目录 | | 使用方式 | pi 自动调用或手动执行 | 无需手动执行 |

安装

cd ~/.pi/agent/skills/tavily-search-free
pip install tavily-python python-dotenv

API Key 配置

需要 TAVILY_API_KEY。密钥已在 .env 中预配置。

使用方式

方式 1：通过 pi 自动调用（推荐）

pi 会自动调用此技能进行网络搜索，无需手动执行命令。

方式 2：手动执行

# 从技能目录执行
cd ~/.pi/agent/skills/tavily-search-free
python3 scripts/tavily_search.py --query "<query>" [--max-results <N>] [--search-depth <basic|advanced>]

# 或使用完整路径
cd /path/to/your/project
python3 ~/.pi/agent/skily-search-free/scripts/tavily_search.py --query "<query>"

参数说明

| 参数 | 必填 | 默认值 | 说明 | |-----|------|--------|------| | --query | 是 | - | 搜索查询内容 | | --search-depth | 否 | basic | 搜索深度：basic 或 advanced（更高质量但更慢） | | --max-results | 否 | 10 | 最大返回结果数量 |

示例

# 基本搜索
python3 ~/.pi/agent/skilly-search-free/scripts/tavily_search.py --query "latest AI trends"

# 深度搜索（高级）
python3 ~/.pi/agent/skilly-search-free/scripts/tavily_search.py --query "autonomous research agents comparison" --search-depth advanced

输出格式

脚本输出 JSON 格式，包含 results 数组，每个结果包含：

• url: 结果链接
• title: 标题
• content: 内容摘要

路径说明

• 脚本位置：~/.pi/agent/skills/tavily-search-free/scripts/tavily_search.py
• 配置位置：~/.pi/agent/skills/tavily-search-free/.env
• 依赖安装：需在技能目录中执行 pip install
• 项目上下文：搜索结果基于查询内容，与本地项目无关