Xpersona
B

brave-api-search

CLAWHUB · Unverified

Real-time web search, autosuggest, and AI-powered answers using the official Brave Search API. Use for searching documentation, facts, current events, or any web content. Supports AI grounded answers with citations and query autosuggest. Requires BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY.

62
Rank
84
Safety
12k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 12.5K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s176tqmpjtkpkhfdzyb4m64qts83hexw:brave-api-search
  1. Install using `clawhub skill install s176tqmpjtkpkhfdzyb4m64qts83hexw:brave-api-search` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/broedkrummen/brave-api-search before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-broedkrummen-brave-api-search-i-search-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

120,418 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: 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 web content. Supports AI grounded answers with citations and query autosuggest. Requires BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY.
license: MIT
metadata:
  author: Broedkrummen
  version: 4.2.1
---

# Brave API Search v4.2.0 — Significant Update

## Native OpenClaw plugin

The same four tools are now available as a native plugin: [Brave API Search plugin](https://clawhub.ai/plugins/brave-api-search-plugin). Install it with `openclaw plugins install clawhub:brave-api-search-plugin`. This skill remains available for existing users.


Real-time web search, autosuggest, spellcheck, and AI-powered answers using the official Brave Search API. Four tools:
- `brave_search` — web results with titles, URLs, descriptions, optional AI summary
- `brave_suggest` — query autosuggestions as users type with optional rich metadata
- `brave_spellcheck` — spell correction and "Did you mean?" suggestions
- `brave_answers` — AI-grounded answers with inline citations powered by live web search
  | **NEW — v4.2.0:** Full entity extraction via `enable-entities` flag

## Setup

Set your Brave API keys in a local `.env` file (recommended):

```bash
# .env (do not commit)
BRAVE_SEARCH_API_KEY=your_key_here
BRAVE_ANSWERS_API_KEY=your_key_here
AUTOSUGGEST_API_KEY=your_key_here   # optional, for autosuggest only
BRAVE_SPELLCHECK_API_KEY=your_key_here   # optional, for spellcheck only
```

Get your keys at: https://api-dashboard.search.brave.com

**Key routing:**
- `brave_search` → `BRAVE_SEARCH_API_KEY`
- `brave_answers` → `BRAVE_ANSWERS_API_KEY`
- `brave_suggest` → `AUTOSUGGEST_API_KEY` → `BRAVE_AUTOSUGGEST_API_KEY` → `BRAVE_SEARCH_API_KEY` (tries in order)
- `brave_spellcheck` → `BRAVE_SPELLCHECK_API_KEY` → `BRAVE_SEARCH_API_KEY` (tries in order)

> Note: `brave_answers` uses streaming by default. Streaming is required for citations, entities, and research mode.

## When to Use This Skill

**Use `brave_search` when:**
- Searching for current information, news, or recent events
- Looking up documentation or technical references
- Need ranked results with URLs to follow up on
- Want an AI summary of search results

**Use `brave_suggest` when:**
- Power autocomplete in search interfaces
- Help users formulate better queries faster
- Need query completions as users type
- Want rich metadata (titles, descriptions, images) for suggestions

**Use `brave_answers` when:**
- Need a synthesized answer with cited sources
- Researching topics that benefit from multiple sources
- Want AI-grounded responses with inline citations
- Deep research mode needed (multi-search)

**Don't use this skill for:**
- Questions already answered from context or memory
- Tasks that don't require external information

## Tools

### brave_search

Web search returning ranked results with titles, URLs, and des

_meta.json

{
  "ownerId": "kn7b72aym67gcmwkp05van1d8s800a7m",
  "slug": "brave-api-search",
  "version": "4.2.1",
  "publishedAt": 1791011418894
}

skill-card.md

## Description:

Search the web, suggest and correct queries, and generate grounded answers with citations through the Brave Search API.

This skill is ready for commercial/non-commercial use.

## Publisher:

[broedkrummen](https://clawhub.ai/user/broedkrummen)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and other agent users use this skill to retrieve current web results, query suggestions, spelling corrections, and AI-grounded answers for research and information lookup.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Search terms, questions, and optional search context are sent to Brave under the user's API account.

Mitigation: Do not submit secrets or sensitive personal data as queries; use only if Brave's data handling is acceptable.

Risk: API calls may consume quota or incur charges, especially for Answers and paid rich suggestions.

Mitigation: Keep API keys in environment variables or an uncommitted .env file, and monitor account quota and costs.

Risk: Citation and entity behavior outside streaming mode is ambiguously documented, and Answers uses English internally.

Mitigation: Use streaming when citations or entities matter and check the returned sources before relying on answers.

## Reference(s):

- [Brave Search API](https://brave.com/search/api/)
- [Brave Search API dashboard](https://api-dashboard.search.brave.com)
- [Brave API Search native plugin](https://clawhub.ai/plugins/brave-api-search-plugin)
- [Brave API Search skill release](https://clawhub.ai/broedkrummen/skills/brave-api-search)

## Skill Output:

**Output Type(s):** [Text, Markdown]

**Output Format:** [Markdown-formatted search results, suggestions, corrections, or answers]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Answers can include citations and usage/cost details; streaming is required for full citation, entity, and research features.]

## Skill Version(s):

4.2.1 (source: ClawHub release metadata and skill frontmatter)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

skill.json

{
  "name": "brave-api-search-skill",
  "version": "4.2.1",
  "description": "Real-time web search, autosuggest, spellcheck, and AI-powered answers using the Brave Search API. Requires BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY environment variables.",
  "author": "Broedkrummen",
  "requiredEnv": [
    "BRAVE_SEARCH_API_KEY",
    "BRAVE_ANSWERS_API_KEY"
  ],
  "tools": [
    {
      "name": "brave_search",
      "description": "Search the web using Brave Search API. Returns ranked results with titles, URLs, and descriptions. Optionally fetches an AI summary of results.",
      "command": "node {{workspace}}/brave_search.js --query \"{{query}}\" --count {{count|10}} --country {{country|us}} --freshness {{freshness|}} --extra-snippets {{extra_snippets|false}} --summary {{summary|false}}",
      "args": {
        "query": {
          "type": "string",
          "description": "Search query. Supports operators: site:, \"exact phrase\", -exclude",
          "required": true
        },
        "count": {
          "type": "number",
          "description": "Number of results to return (1-20)",
          "default": 10
        },
        "country": {
          "type": "string",
          "description": "2-letter country code for geographic targeting (e.g. us, gb, de)",
          "default": "us"
        },
        "freshness": {
          "type": "string",
          "description": "Date filter: pd (24h), pw (7 days), pm (31 days), py (1 year)",
          "enum": [
            "pd",
            "pw",
            "pm",
            "py"
          ]
        },
        "extra_snippets": {
          "type": "boolean",
          "description": "Include up to 5 extra text excerpts per result",
          "default": false
        },
        "summary": {
          "type": "boolean",
          "description": "Fetch AI summarizer result for the search query",
          "default": false
        }
      }
    },
    {
      "name": "brave_suggest",
      "description": "Get search query autosuggestions as users type. Returns contextual suggestions based on partial input with optional rich metadata (titles, descriptions, images).",
      "command": "node {{workspace}}/brave_suggest.js --query \"{{query}}\" --count {{count|5}} --country {{country|US}} --rich {{rich|false}}",
      "args": {
        "query": {
          "type": "string",
          "description": "Partial query to get suggestions for",
          "required": true
        },
        "count": {
          "type": "number",
          "description": "Number of suggestions to return (1-10)",
          "default": 5
        },
        "country": {
          "type": "string",
          "description": "2-letter country code for geographic targeting",
          "default": "US"
        },
        "rich": {
          "type": "boolean",
          "description": "Include enhanced metadata (titles, descriptions, images, entity detection). Requires paid subscription.",
          "default": false
        }
      }
    },

Sponsored

Ads related to brave-api-search and adjacent AI workflows.