← Back to Skills Marketplace
Brave Api Search
by
Broedkrummen
· GitHub ↗
· v4.2.0
· MIT-0
9452
Downloads
2
Stars
39
Active Installs
12
Versions
Install in OpenClaw
/install brave-api-search
Description
Real-time web search, autosuggest, and AI-powered answers using the official Brave Search API. Use for searching documentation, facts, current events, or any...
Usage Guidance
Review before installing. Use only if you are comfortable sending searches, answer prompts, and any location context to Brave using your API keys. Avoid secrets or regulated data in queries, and prefer an OpenClaw runtime that executes tool commands with argv-style escaping rather than raw shell interpolation.
Capability Analysis
Type: OpenClaw Skill
Name: brave-api-search
Version: 4.2.0
The brave-api-search skill bundle is a well-implemented interface for the official Brave Search API, providing tools for web search, AI-powered answers, spellcheck, and autosuggestions. The code is clean, uses native Node.js 18+ features (no external dependencies), and communicates exclusively with official Brave API endpoints (api.search.brave.com). It includes robust utility functions for exponential backoff retries and in-memory caching, and it correctly handles sensitive API keys via environment variables without any evidence of exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
The skill coherently implements Brave web search, autosuggest, spellcheck, and AI answers against official Brave API endpoints; these capabilities fit the stated search purpose.
Instruction Scope
skill.json places user-controlled values such as query into quoted command strings for Node scripts. If the host executes these through a shell without strong escaping, crafted input could alter local command execution.
Install Mechanism
No package install, dependency tree, or remote installer is present. There is a minor metadata inconsistency: _meta.json reports version 3.0.2 while SKILL.md and skill.json report 4.2.0.
Credentials
Reading Brave API keys from environment variables and making outbound Brave API calls is proportionate for this skill, but queries and optional location-related parameters are external data flows users should understand.
Persistence & Privilege
No background service, privilege escalation, destructive action, persistent local index, or system configuration mutation was found; autosuggest caching is in-memory and short-lived.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install brave-api-search - After installation, invoke the skill by name or use
/brave-api-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v4.2.0
Brave API Search v4.2.0 — Major Update
- Added full entity extraction to the `brave_answers` tool via the new `enable-entities` flag (outputs an "Entities mentioned" section on streaming responses).
- Enhanced streaming output for answers with inline entity parsing alongside citations.
- Updated documentation to reflect new entity extraction capabilities and improved response formatting.
- Internal code improvements for entity parsing and output clarity.
v4.1.0
Brave API Search v4.1.0 adds spellchecking support:
- New tool: brave_spellcheck provides "Did you mean?" query corrections using the Brave Spellcheck API.
- Updated SKILL.md documentation to describe the new brave_spellcheck tool, its setup, API key handling, parameters, usage, and examples.
- Key routing clarified for spellcheck: uses BRAVE_SPELLCHECK_API_KEY if available, else falls back to BRAVE_SEARCH_API_KEY.
v4.0.0
**Brave API Search v4.0.0 — Major enhancements and reliability improvements**
- Added utils.js with reusable helpers for argument parsing, fetch retries (with exponential backoff), and in-memory TTL caching.
- brave_suggest now supports multi-key fallback for API keys (`AUTOSUGGEST_API_KEY` → `BRAVE_AUTOSUGGEST_API_KEY` → `BRAVE_SEARCH_API_KEY`) and uses a 60s cache for fast, spam-resistant results.
- brave_answers defaults to streaming output, enabling real-time answers with inline citations, token/cost reporting, and optional entity extraction.
- brave_search provides pagination hints via `offset` and returns a next-page prompt when more results are available.
- Improved API error handling throughout with automatic retries on rate limits and server errors.
- Documentation significantly expanded with detailed parameter lists, CLI usage, technical architecture notes, and new key routing logic.
v3.0.2
- Clarified API key usage: Added note that `brave_search` and `brave_suggest` use `BRAVE_SEARCH_API_KEY` while `brave_answers` requires `BRAVE_ANSWERS_API_KEY`.
- No code or feature changes—documentation update only.
v3.0.1
Version 3.0.1
- Updated version metadata from 2.2.0 to 3.0.0 in SKILL.md.
- No functional or behavioral changes to the API or usage; documentation only.
- Ensured SKILL.md content is current and consistent with the latest release.
v3.0.0
- Added support for Brave query autosuggestions via the new brave_suggest tool.
- Introduced the brave_suggest API for real-time query autocomplete with optional rich metadata.
- Documentation updated to describe brave_suggest parameters, usage, and best practices.
- Now offers three tools: brave_search, brave_answers, and brave_suggest for more comprehensive web search capabilities.
- Added note: rich autosuggest metadata requires a paid plan.
v2.1.2
v2.1.2 - Fixed metadata: declared required environment variables BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY
v2.1.1
Document .env-first key handling, add .env.example, and reinforce no plain-text key sharing.
v2.1.0
Fix metadata consistency: declare required env vars in registry manifest, add homepage, and tighten security/packaging notes in SKILL.md.
v2.0.1
Remove fixed free-tier claim; update docs to credit-based pricing guidance; bump metadata to 2.0.1.
v2.0.0
Fix manifest consistency: command paths, env var declaration, remove BRAVE_API_KEY fallback, align metadata versions.
v1.0.0
Initial release: real-time web search and AI answers via official Brave Search API. Includes brave_search (results + AI summary) and brave_answers (grounded answers with citations).
Metadata
Frequently Asked Questions
What is Brave Api Search?
Real-time web search, autosuggest, and AI-powered answers using the official Brave Search API. Use for searching documentation, facts, current events, or any... It is an AI Agent Skill for Claude Code / OpenClaw, with 9452 downloads so far.
How do I install Brave Api Search?
Run "/install brave-api-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Brave Api Search free?
Yes, Brave Api Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Brave Api Search support?
Brave Api Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Brave Api Search?
It is built and maintained by Broedkrummen (@broedkrummen); the current version is v4.2.0.
More Skills