Brave Search 极简国内版

【极简版省token】使用 Brave API 执行网络搜索。针对国内代理环境做优化。

Security Scan

The skill largely does what it claims (wraps Brave Search via the Brave API using a local proxy) and only requests a Brave API key and a proxy port, but small inconsistencies and scope creep in the bundled docs/config guidance warrant caution before installing.

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).

What to consider before installing

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.

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.