Tavily

通过捆绑的 Node CLI 调用 Tavily 搜索 API，按查询词、结果数量、包含/排除域名检索网页；stdout 输出 JSON 结果，stderr 输出简单 URL 列表，用于快速收集来源、线索调研和带引用汇总。需要 TAVILY_API_KEY。

tylordius

热度 83.42

最近更新 2026-05-11 17:27:50

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 摘要总结

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add tavily-tool

Metadata

name: tavily
description: Use Tavily web search/discovery to find URLs/sources, do lead research, gather up-to-date links, or produce a cited summary from web results.
metadata: {"openclaw":{"requires":{"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}

Tavily

Use the bundled CLI to run Tavily searches from the terminal and collect sources fast.

Quick start (CLI)

The scripts require TAVILY_API_KEY in the environment (sent as Authorization: Bearer ...).

export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "best rust http client" --max_results 5

JSON response is printed to stdout.
A simple URL list is printed to stderr by default.

Common patterns

Get URLs only

export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "OpenTelemetry collector config" --urls-only

Restrict to (or exclude) specific domains

export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js \
  --query "oauth device code flow" \
  --include_domains oauth.net,datatracker.ietf.org \
  --exclude_domains medium.com

Notes

The bundled CLI supports a subset of Tavily’s request fields (query, max_results, include_domains, exclude_domains).
For API field notes and more examples, read: references/tavily-api.md.
Wrapper script (optional): scripts/tavily_search.sh.