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

• 项目上下文：搜索结果基于查询内容，与本地项目无关