# Send Brave Api Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "brave-api-search",
    "name": "Brave Api Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Broedkrummen/brave-api-search",
    "canonicalUrl": "https://clawhub.ai/Broedkrummen/brave-api-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/brave-api-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=brave-api-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "brave_answers.js",
      "brave_search.js",
      "brave_suggest.js",
      "skill.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/brave-api-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/brave-api-search",
    "downloadUrl": "https://openagent3.xyz/downloads/brave-api-search",
    "agentUrl": "https://openagent3.xyz/skills/brave-api-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/brave-api-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/brave-api-search/agent.md"
  }
}
```
## Documentation

### Brave API Search

Real-time web search, autosuggest, and AI-powered answers using the official Brave Search API. Three tools:

brave_search — web results with titles, URLs, descriptions, optional AI summary
brave_suggest — query autosuggestions as users type with optional rich metadata
brave_answers — AI-grounded answers with inline citations powered by live web search

### Setup

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

# .env (do not commit)
BRAVE_SEARCH_API_KEY=your_key_here
BRAVE_ANSWERS_API_KEY=your_key_here

Or export them in your shell session if needed.

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

Both keys can be the same if your plan supports both Search and AI Answers endpoints.

Note: brave_search and brave_suggest use BRAVE_SEARCH_API_KEY. brave_answers requires BRAVE_ANSWERS_API_KEY.

Note: This skill explicitly requires BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY. It does not use a generic BRAVE_API_KEY fallback.

### 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

### brave_search

Web search returning ranked results with titles, URLs, and descriptions.

brave_search(query="latest Node.js release", count=5)
brave_search(query="TypeScript generics", extra_snippets=true)
brave_search(query="current weather Copenhagen", freshness="pd")
brave_search(query="React Server Components", summary=true)

Parameters:

query (required) — Search query, supports operators: site:, "exact phrase", -exclude
count — Results to return (1-20, default: 10)
country — 2-letter country code (default: us)
freshness — Date filter: pd (24h), pw (7 days), pm (31 days), py (1 year)
extra_snippets — Include up to 5 extra text excerpts per result (default: false)
summary — Fetch Brave AI summarizer result (default: false)

Returns: Formatted list of results with title, URL, description, and optional AI summary.

### brave_suggest

Query autosuggest API providing intelligent query autocompletion as users type.

brave_suggest(query="hello")
brave_suggest(query="pyt", count=5, country="US")
brave_suggest(query="einstein", rich=true)

Parameters:

query (required) — Partial query to get suggestions for
count — Number of suggestions (1-10, default: 5)
country — 2-letter country code (default: US)
rich — Include enhanced metadata: titles, descriptions, images, entity detection (default: false, requires paid plan)

Returns: List of query suggestions, optionally with rich metadata.

Best Practices:

Implement debouncing (150-300ms) to avoid excessive API calls as users type
Load suggestions asynchronously without blocking the UI

### brave_answers

AI-powered answers grounded in live web search with inline citations.

brave_answers(query="How does React Server Components work?")
brave_answers(query="Compare Postgres vs MySQL for OLAP", enable_research=true)
brave_answers(query="Latest Python release notes", enable_citations=true)

Parameters:

query (required) — Question or topic to research
enable_citations — Include inline source citations (default: true)
enable_research — Multi-search deep research mode (default: false)
country — Target country for search context (default: us)

Returns: AI answer with cited sources extracted from the response, plus token usage.

### Pricing & Limits

Brave pricing is credit-based and can change. Do not assume a fixed free request count.

Current public guidance (verify in Brave dashboard/docs before production use):

Monthly trial credits may be offered (e.g. $5 in monthly credits)
Search and Answers consume credits differently
Rich suggestions require a paid Autosuggest plan
Answers may also include token-based costs
QPS limits depend on your plan tier

Always check your live limits and usage in:

https://api-dashboard.search.brave.com
https://brave.com/search/api/

### Security & Packaging Notes

This skill only calls Brave official endpoints under https://api.search.brave.com/res/v1.
It requires exactly two env vars: BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY (keep them in .env, not inline in commands/chats).
It does not request persistent/system privileges and does not modify system config.
It is source-file based (three local Node scripts), with no external install/download step.

### API vs Web Scraping

This skill uses the official Brave Search API — not web scraping. Benefits:

Reliable, structured JSON responses
Rate limit headers and proper error messages
Access to AI summarizer, AI answers, and autosuggest endpoints
Terms of service compliant
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Broedkrummen
- Version: 3.0.2
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/brave-api-search)
- [Send to Agent page](https://openagent3.xyz/skills/brave-api-search/agent)
- [JSON manifest](https://openagent3.xyz/skills/brave-api-search/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/brave-api-search/agent.md)
- [Download page](https://openagent3.xyz/downloads/brave-api-search)