← Back to Skills Marketplace
142
Downloads
0
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install brave-search-vpn
Description
【极简版省token】使用 Brave API 执行网络搜索。针对国内代理环境做优化。
README (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.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install brave-search-vpn - After installation, invoke the skill by name or use
/brave-search-vpn - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is Brave Search 极简国内版?
【极简版省token】使用 Brave API 执行网络搜索。针对国内代理环境做优化。 It is an AI Agent Skill for Claude Code / OpenClaw, with 142 downloads so far.
How do I install Brave Search 极简国内版?
Run "/install brave-search-vpn" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Brave Search 极简国内版 free?
Yes, Brave Search 极简国内版 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Brave Search 极简国内版 support?
Brave Search 极简国内版 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Brave Search 极简国内版?
It is built and maintained by jhc888007 (@jhc888007); the current version is v1.0.6.
More Skills