← 返回 Skills 市场
142
总下载
0
收藏
1
当前安装
5
版本数
在 OpenClaw 中安装
/install brave-search-vpn
功能描述
【极简版省token】使用 Brave API 执行网络搜索。针对国内代理环境做优化。
使用说明 (SKILL.md)
Brave Search
使用 Brave API 在互联网上搜索最新信息。本工具会向 https://api.search.brave.com 发起网络请求。
配置环境变量与凭据
此脚本需要 Brave API 密钥和 VPN 环境才能运行。需要配置 BRAVE_SEARCH_API_KEY 和 HTTP_PROXY_PORT
export BRAVE_SEARCH_API_KEY="your_api_key_here"
export HTTP_PROXY_PORT="your_vpn_port_here"
使用方法
python3 scripts/brave_search.py --q "你的搜索词" [--country CN] [--count 20]
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
q |
string | 是 | - | 搜索关键词（最多50个词） |
country |
string | 否 | CN |
搜索国家代码，如 CN, US, ALL |
search_lang |
string | 否 | zh-hans |
语言偏好，如 zh-hans, en |
count |
int | 否 | 20 | 返回结果数量限制（1-20） |
offset |
int | 否 | 0 | 分页偏移量（0-9） |
safesearch |
string | 否 | moderate |
内容过滤：off, moderate, strict |
freshness |
string | 否 | - | 时间过滤：pd(1天内), pw(1周内), pm(1个月内), py(1年内) , YYYY-MM-DDtoYYYY-MM-DD(一定范围) |
text_decorations |
bool | 否 | true | 是否在结果中保留高亮标记 |
spellcheck |
bool | 否 | true | 是否自动纠正拼写 |
result_filter |
string | 否 | - | 过滤结果类型，如 web,news,videos |
goggles |
string | 否 | - | 自定义排序规则（URL 或 内联规则） |
extra_snippets |
bool/string | 否 | false |
是否获取每个结果的额外文本摘要（最多5个） |
License
MIT License - Feel free to use and modify.
安全使用建议
This skill's code matches its stated purpose and only asks for a Brave API key and a local proxy port — which is reasonable for a proxied Brave Search wrapper. Before installing: (1) verify the source/repository (homepage unknown); (2) be aware the bundle expects python3 and the 'requests' package but does not declare them — run in an environment where you control dependencies; (3) do not paste your API key into public places; (4) the README suggests changing global OpenClaw settings (disabling the built-in web_search) — avoid making system-wide changes unless you understand the impact; (5) if you want stronger assurance, review the script locally and test it in an isolated environment (or a throwaway agent) so you can confirm it only calls api.search.brave.com via your local proxy.
功能分析
Type: OpenClaw Skill
Name: brave-search-vpn
Version: 1.0.6
The skill is a legitimate wrapper for the Brave Search API, specifically designed to support local HTTP proxies for users in restricted network environments. It handles the API key securely via environment variables, communicates only with the official Brave API endpoint (api.search.brave.com), and contains no evidence of malicious execution, data exfiltration, or prompt injection. The code in scripts/brave_search.py is well-structured and performs standard data sanitization for its input parameters.
能力评估
Purpose & Capability
Name/description, SKILL.md, and scripts/brave_search.py all align: the code calls https://api.search.brave.com and uses BRAVE_SEARCH_API_KEY plus a local HTTP proxy port. The skill does not request unrelated credentials. Minor gap: the package does not declare Python/requests as a runtime dependency, though the script requires them.
Instruction Scope
SKILL.md runtime instructions are narrowly scoped to setting BRAVE_SEARCH_API_KEY and HTTP_PROXY_PORT and running the provided Python script (which only communicates with Brave). However README.md recommends modifying global OpenClaw settings (disabling the built-in web_search tool and editing openclaw.json) — that is scope creep because it instructs changing system/global agent behavior beyond this skill's own files.
Install Mechanism
No install spec (instruction-only) and no downloads — lowest install risk. However the bundle includes a Python script that depends on the 'requests' library and python3; those runtime requirements are not declared in metadata or SKILL.md.
Credentials
Declared required env vars are BRAVE_SEARCH_API_KEY and HTTP_PROXY_PORT, both justified by the code (API key for Brave, proxy port for a local proxy/VPN). No additional secrets or unrelated env vars are requested.
Persistence & Privilege
Skill does not request persistent or elevated privileges: always:false and it does not modify other skills or system-wide configs itself. Note: README suggests manual edits to global OpenClaw config (user-driven, not automatic).
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install brave-search-vpn - 安装完成后，直接呼叫该 Skill 的名称或使用
/brave-search-vpn触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.6
- No file changes detected in this version.
- No new features, fixes, or updates introduced.
v1.0.5
Version 1.0.5 of brave-search-vpn
- No file changes detected in this release.
- No user-facing updates or functionality changes included.
v1.0.2
- No code or documentation changes detected in this version.
- Version bump only; functionality and usage remain unchanged.
v1.0.1
- 更正文档说明，将“此脚本需要 Moonshot API 密钥才能运行”更新为“此脚本需要 Brave API 密钥和 VPN 环境才能运行”
- 其余内容保持不变
v1.0.0
- Initial release of brave-search-vpn skill.
- Enables Brave Search API queries with minimal token usage.
- Optimized for proxy environments in China.
- Requires HTTP proxy port and Brave Search API Key configuration.
- Supports extensive query parameters: country, language, safesearch, freshness, and more.
元数据
常见问题
Brave Search 极简国内版 是什么？
【极简版省token】使用 Brave API 执行网络搜索。针对国内代理环境做优化。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 142 次。
如何安装 Brave Search 极简国内版？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install brave-search-vpn」即可一键安装，无需额外配置。
Brave Search 极简国内版 是免费的吗？
是的，Brave Search 极简国内版 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Brave Search 极简国内版 支持哪些平台？
Brave Search 极简国内版 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Brave Search 极简国内版？
由 jhc888007（@jhc888007）开发并维护，当前版本 v1.0.6。
推荐 Skills