tavily-search-free

Tavily Search Skill（MCP ベース）

このスキルは Tavily MCP サーバーを利用し、LLM と RAG パイプライン向けに最適化された、クリーンでリアルタイムなウェブ検索結果を提供します。

実行環境

パスの種類	パス	基準ディレクトリ
スキルディレクトリ	~/.pi/agent/skills/tavily-search-free/	固定位置
メインスクリプト	~/.pi/agent/skills/tavily-search-free/executor.py	スキルディレクトリ
使用方法	pi が自動で呼び出すか、手動で実行	手動実行は不要

API Key の設定

複数の Key のローテーションに対応しており、リクエストの同時処理能力を高められます。

設定方法：.env ファイルで複数の Key をカンマ区切りで指定します：

TAVILY_API_KEY=key1,key2,key3

Key の状態を確認：

uv run executor.py --key-status

利用可能なツール

ツール	説明
tavily_search	ウェブ検索（ニュース、事実、データ）
tavily_extract	URL からコンテンツを抽出（markdown/text）
tavily_crawl	ウェブサイトをクロール（深度を設定可能）
tavily_map	ウェブサイトの構造をマッピング
tavily_research	包括的な調査（複数のソース）

使用方法

方法 1：pi による自動呼び出し（推奨）

pi がウェブ検索時にこのスキルを自動で呼び出すため、コマンドを手動で実行する必要はありません。

方法 2：手動で実行

# 从技能目录执行
cd ~/.pi/agent/skills/tavily-search-free

# 列出所有工具
uv run executor.py --list

# 搜索
uv run executor.py --call '{"tool": "tavily_search", "arguments": {"query": "搜索内容"}}'

# 提取 URL 内容
uv run executor.py --call '{"tool": "tavily_extract", "arguments": {"urls": ["https://example.com"]}}'

# 爬取网站
uv run executor.py --call '{"tool": "tavily_crawl", "arguments": {"url": "https://example.com", "max_depth": 2}}'

# 映射网站
uv run executor.py --call '{"tool": "tavily_map", "arguments": {"url": "https://example.com"}}'

# 综合研究
uv run executor.py --call '{"tool": "tavily_research", "arguments": {"input": "研究主题"}}'

パラメーターの説明

tavily_search

パラメーター	必須	デフォルト値	説明
query	はい	-	検索クエリ
max_results	いいえ	5	返される結果の最大数
search_depth	いいえ	basic	検索の深度：basic/advanced/fast/ultra-fast
time_range	いいえ	null	期間：day/week/month/year

tavily_extract

パラメーター	必須	デフォルト値	説明
urls	はい	-	URL のリスト
extract_depth	いいえ	basic	抽出の深度：basic/advanced
format	いいえ	markdown	出力形式：markdown/text

出力形式

スクリプトは、検索結果または抽出したコンテンツを含む JSON 形式で出力します。

モニタリングと統計

# 查看状态
uv run executor.py --status

# 查看统计
uv run executor.py --stats

# 查看日志
uv run executor.py --logs 100

パスの説明

• スクリプトの場所：~/.pi/agent/skills/tavily-search-free/executor.py
• 設定ファイルの場所：~/.pi/agent/skills/tavily-search-free/mcp-config.json
• 環境変数：~/.pi/agent/skills/tavily-search-free/.env
• 依存関係のインストール：uv sync を使用して自動管理

---

Tavily MCP サーバーをベースとし、5 つのツールに対応。段階的な読み込みによりコンテキストを節約します