360 Secure SkillHub
360 安全技能中心

Tavily Proxy Search

核心功能：向已部署的TavilyProxyManager实例发送认证搜索请求，兼容Tavily搜索参数，支持指定结果数量、是否返回摘要答案，输出含原始JSON、结构化JSON、Markdown列表等格式。典型场景：需要Tavily风格网页调研、信息收集，但希望使用自建代理而非官方API的场景。使用前需配置代理密钥，可自定义代理地址，通过命令行参数发起搜索，返回对应格式的搜索结果。

ugvfpdcuwfnh
ugvfpdcuwfnh
热度 49.92
最近更新 2026-05-11 17:41:32
分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 摘要总结

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add tavily-proxy-search
Metadata
name
tavily-proxy-search
description
Search the web through a self-hosted TavilyProxyManager instance using Bearer master-key authentication while preserving the familiar tavily-search parameter style. Use when the user wants Tavily-style web search, source gathering, quick research, or result summaries through a self-hosted proxy instead of the official Tavily API.

Tavily Proxy Search

Use the bundled script to search the web through an existing TavilyProxyManager /search endpoint.

This skill does not deploy TavilyProxyManager. It only sends authenticated search requests to a TavilyProxyManager instance that is already running. Project: https://github.com/xuncv/TavilyProxyManager

Requirements

Provide credentials via either:

  • environment variable: TAVILY_PROXY_MASTER_KEY
  • ~/.openclaw/.env line: TAVILY_PROXY_MASTER_KEY=...

Optional:

  • environment variable: TAVILY_PROXY_URL
  • ~/.openclaw/.env line: TAVILY_PROXY_URL=...
  • default URL: http://127.0.0.1:8080/search

Minimal example:

export TAVILY_PROXY_URL="http://127.0.0.1:8080/search"
export TAVILY_PROXY_MASTER_KEY="your-master-key"

Commands

Run from the OpenClaw workspace:

# raw JSON (default)
python3 {baseDir}/scripts/tavily_proxy_search.py --query "..." --max-results 5

# include short answer (if available)
python3 {baseDir}/scripts/tavily_proxy_search.py --query "..." --max-results 5 --include-answer

# stable schema (closer to web_search): {query, results:[{title,url,snippet}], answer?}
python3 {baseDir}/scripts/tavily_proxy_search.py --query "..." --max-results 5 --format brave

# human-readable Markdown list
python3 {baseDir}/scripts/tavily_proxy_search.py --query "..." --max-results 5 --format md

Output

raw (default)

  • JSON: query, optional answer, results: [{title,url,content}]

brave

  • JSON: query, optional answer, results: [{title,url,snippet}]

md

  • A compact Markdown list with title/url/snippet.

Common failures

  • Missing TAVILY_PROXY_MASTER_KEY

    • Cause: the proxy master key is not configured.
    • Fix: set TAVILY_PROXY_MASTER_KEY in the environment or ~/.openclaw/.env.

  • Tavily proxy returned HTTP 401

    • Cause: the Bearer master key is wrong, expired, or the endpoint expects a different auth setup.
    • Fix: verify the master key and confirm the target really is a TavilyProxyManager /search endpoint.

  • Tavily proxy request failed

    • Cause: the proxy URL is unreachable, refused, timed out, or DNS failed.
    • Fix: verify TAVILY_PROXY_URL, container status, reverse proxy, and network reachability.

  • Tavily proxy returned non-JSON

    • Cause: the configured URL is not the correct /search API endpoint, or an upstream proxy returned HTML/error text.
    • Fix: point TAVILY_PROXY_URL to the real TavilyProxyManager /search endpoint.

Notes

  • Keep max-results small by default (3–5) to reduce token and reading load.
  • Authentication is handled with Authorization: Bearer <TAVILY_PROXY_MASTER_KEY>.
  • Do not send TAVILY_API_KEY in the JSON body for this skill.
  • Preserve the familiar parameter style: --query, --max-results, --include-answer, --search-depth, --format.
  • advanced search depth depends on the capabilities of the deployed TavilyProxyManager instance and its upstream search configuration.