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
• 项目上下文：搜索结果基于查询内容，与本地项目无关