Tavily Search 极简版

【极简版省token】使用 Tavily API 执行网络搜索。专为 LLM 与 AI Agent 优化的搜索引擎。

Security Scan

The skill is internally coherent: it implements a simple Tavily API client, only requires a Tavily API key, and its files and runtime instructions match the stated purpose.

Purpose & Capability

Name/description (Tavily web search) aligns with the code and SKILL.md. The script calls https://api.tavily.com/search and exposes search-related options; requested env var TAVILY_API_KEY is appropriate.

Instruction Scope

SKILL.md and the CLI instruct running scripts/tavily_search.py and setting TAVILY_API_KEY. The script also attempts to read ~/.openclaw/.env for the key if the env var is not set — that file read is reasonable for convenience but is not declared in requires.config paths, so note the minor discrepancy.

Install Mechanism

No install spec; this is an instruction-only skill with a small Python script that uses the standard library (urllib). Nothing is downloaded or installed by the skill.

Credentials

Only TAVILY_API_KEY is required (appropriate). The code will also look for that key in ~/.openclaw/.env if the env var is not present — reasonable but worth noting because the config path was not listed in the metadata.

Persistence & Privilege

always:false and no code to modify other skills or system-wide settings. The skill does not request permanent elevated presence or extra privileges.

Assessment

This skill is a simple client for the Tavily search API and will send your queries and your TAVILY_API_KEY to https://api.tavily.com/search. If you install it, set the API key only if you trust Tavily; the script will look for the key in your environment or in ~/.openclaw/.env (so don’t store other secrets there). There is no installer and no extra network endpoints in the code. If you prefer not to share an API key with third-party skills, do not provide TAVILY_API_KEY or use an account/key you are willing to revoke.

Tavily Search

使用 Tavily API 在互联网上搜索并总结最新信息。本工具会向 https://api.tavily.com/search 发起网络请求。

配置环境变量与凭据

此脚本需要 Tavily API 密钥才能运行。请配置 TAVILY_API_KEY 环境变量（或将其写入 ~/.openclaw/.env）：

export TAVILY_API_KEY="your_api_key_here"

使用方法

python3 scripts/tavily_search.py --query "你的搜索词" [--search-depth advanced] [--max-results 5]

参数名	类型	必填	默认值	描述
query	string	是	-	搜索关键词
search-depth	string	否	basic	搜索深度：basic (基础, 1积分), advanced (高级, 2积分), fast (快速), ultra-fast (极速)
topic	string	否	general	主题分类：general (通用), news (新闻), finance (金融)
time-range	string	否	-	时间过滤：day, week, month, year (或简写 d, w, m, y)
start-date	string	否	-	起始日期，格式如 YYYY-MM-DD
end-date	string	否	-	结束日期，格式如 YYYY-MM-DD
max-results	int	否	5	返回结果数量限制（0-20）
include-images	bool	否	False	是否在结果中包含查询相关的图片
include-domains	string	否	-	仅搜索指定域名（多个用逗号分隔）
exclude-domains	string	否	-	排除指定域名（多个用逗号分隔）
chunks-per-source	int	否	3	每个来源提取的文本块数量 (1-3，仅在 depth 为 advanced/fast 时有效)
auto-parameters	bool	否	False	开启后，Tavily 会根据查询意图自动覆盖及配置搜索参数
format	string	否	raw	输出格式控制：raw (原始JSON), brave (极简JSON), md (人类可读)

License

MIT License - Feel free to use and modify.