Broedkrummen

brave-api-search

ナレッジ管理v4.2.1
作者:Broedkrummen更新日 2026-10-03全 13 バージョン · 最新版の公開日 2026-10-03@clawhub_broedkrummen/brave-api-search
情報検索#Documentation#Web Search

AlphaMoatによると、2026-10時点でbrave-api-searchのダウンロード数は12,814、スター数は2で、累計ダウンロード数で今回のランキング対象AIスキル10,914件中2,177位、ナレッジ管理では745件中143位です。

一覧の初期表示は累計ダウンロード数順で、スター数順にも並べ替えできます。詳細ページの順位は累計ダウンロード数で計算しています。

ダウンロード数
1.3万
スター数
2
累計ダウンロード順位
#2,177
全体の上位 20% · ナレッジ管理の上位 20%
プラットフォームダウンロード数スター数コメント
ClawHub ↗1.2万2-
SkillHub ↗1.3万2—

プラットフォームごとに集計方法と集計時点が異なります。

このスキルでできること

Brave API の検索用・回答用キーを使い、候補と綴り修正には専用キーも設定できます。検索は見出し、リンク、説明を返し、回答は出典の統合や実体抽出を行えます。非ストリーミングの引用説明に矛盾があるため、引用や実体が必要ならストリーミングを使い出典を確認します。検索文は Brave に送られ、キーと利用枠の管理が必要です。

資料公開日 2026-10-27

できること

  • ウェブの出典を使って調べる

使う場面

  • 最新の外部情報や検索文の補助が必要なとき

プロンプト例

スキルのドキュメントをもとに生成した例であり、実際の実行結果ではありません。

このテーマを検索し、引用を確認して出典をまとめて。

月次の推移

ダウンロード数1.3万
88721.1万1.3万2026-05 · ダウンロード数 91642026-06 · ダウンロード数 95062026-07 · ダウンロード数 1.1万2026-08 · ダウンロード数 1.2万2026-09 · ダウンロード数 1.2万2026-10 · ダウンロード数 1.3万26-0526-0926-10
スター数2
1232026-05 · スター数 22026-06 · スター数 22026-07 · スター数 22026-08 · スター数 22026-09 · スター数 22026-10 · スター数 226-0526-0926-10

2026-09 から集計方法を変更し、同名スキルを作者ごとに分けて集計し、全スキルを対象にしました。破線は変更前の月で、変更後のデータとは直接比較せず、変更をまたぐ増減も計算していません。

月ダウンロード数前月比スター数
2026-101.3万—2
2026-091.2万—2
2026-081.2万+9.1%2
2026-071.1万+11.4%2
2026-069506+3.7%2
2026-059164—2

SKILL.md 原文

作者が公開した元のファイルをテキストのまま表示しています。AlphaMoat による編集や審査はしていません。リンクはクリックできません。コマンドは内容を確認してから実行してください。取得日 2026-10-23。

10 KB・ClawHub v4.2.1
---
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
すべて表示(全 227 行)

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

```bash
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)
- `offset` — Pagination offset for next page results

**Returns:** Formatted list of results with title, URL, description, optional AI summary, and a hint for next page if `more_results_available`.

### brave_suggest

Query autosuggest API providing intelligent query autocompletion as users type.

```bash
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 Autosuggest plan)

**Returns:** List of query suggestions, optionally with rich metadata. Results are cached for 60 seconds.

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

### brave_spellcheck

Spell checking and query correction for search queries.

```bash
brave_spellcheck --query "articifial inteligence"
brave_spellcheck --query "hello" --country US
```

**Parameters:**
- `query` (required) — Query to check for spelling errors
- `country` — 2-letter country code (default: `US`)

**Returns:** "Did you mean:" suggestion, or confirms no correction needed. Uses dedicated `BRAVE_SPELLCHECK_API_KEY` if available, falls back to `BRAVE_SEARCH_API_KEY`.


### brave_answers

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

```bash
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
brave_answers --query "Who is Albert Einstein" --enable-entities true
```

**Parameters:**
- `query` (required) — Question or topic to research
- `country` — Target country for search context (default: `us`)
- `enable-citations` — Include inline source citations (default: true)
- `enable-research` — Multi-search deep research mode (default: false)
- `enable-entities` — Include entity information in responses (default: false, streaming required)
- `stream` — Enable streaming output (default: true — required for citations/entities/research)

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

> ⚠️ **Citations, entities, and research mode require streaming (`--stream true`, which is the default).** If you disable streaming with `--stream false`, citations and entity data will not be available.

**Streaming mode output:**
- Text streams progressively to stdout
- Entities streamed inline as `<enum_item>` tags are parsed
- **Entities mentioned** section printed at the end (v4.2.0)
- Sources printed at the end (sorted by citation number)
- Token usage and cost breakdown included

**Non-streaming fallback:** Use `--stream false` for simpler output at the cost of losing citations and entity data.

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

## Technical Details

### Architecture

The skill uses a shared `utils.js` module containing:
- `parseArgs()` — CLI argument parser
- `fetchWithRetry()` — fetch with exponential backoff retry on 429 and 5xx
- `createCache()` — in-memory TTL cache (used by `brave_suggest`)

### brave_search.js

The core search script with the following optimizations:
- **Parallel summary fetch:** When `--summary` is enabled, the summary key is extracted from the search response and fetched in parallel with the search results
- **Pagination hint:** Response includes a hint for the next page offset when `more_results_available` is true
- **Rate limit handling:** Retries on 429 (honors `Retry-After` header) and 5xx (exponential backoff)

### brave_answers.js v4.2.0

The AI answers script supports two modes:
- **Streaming (default):** Progressive output with real-time entity extraction, deduplicated citations, token usage, and cost breakdown
- **Non-streaming:** Full citation and entity extraction from batch response via `parseCitations()` and `parseEntities()`

Key changes in v4.2.0:
- **Entity extraction:** Streaming mode parses `<enum_item>` tags incrementally — entity names are streamed inline as they are parsed, and a consolidated **Entities mentioned** section is printed at the end with URL and citation count per entity
- **Citation deduplication:** Duplicate source URLs are deduplicated so each source is cited only once (sorted by citation number)
- **Non-streaming mode (v4.2.0):** Full `parseCitations()` and `parseEntities()` applied to the batch response content, so citations and entities are extracted even without streaming

### brave_suggest.js

The autosuggest script with the following optimizations:
- **In-memory cache:** 60-second TTL cache keyed by `query|count|country|rich` — deduplicates rapid successive calls
- **Key fallback chain:** `AUTOSUGGEST_API_KEY` → `BRAVE_AUTOSUGGEST_API_KEY` → `BRAVE_SEARCH_API_KEY`

### brave_answers streaming

When streaming is enabled (`stream: true`):
- SSE chunks are parsed in real-time
- Citations are collected and printed at end (sorted by citation number)
- Entity items (`<enum_item>`) are parsed incrementally — streamed inline and collected for the **Entities mentioned** section
- Usage block (`<usage>`) parsed and displayed with token counts and total cost

## Security & Packaging Notes

- This skill only calls Brave official endpoints under `https://api.search.brave.com/res/v1`.
- It requires `BRAVE_SEARCH_API_KEY` and `BRAVE_ANSWERS_API_KEY` (keep them in `.env`, not inline in commands/chats).
- Optionally accepts `AUTOSUGGEST_API_KEY` or `BRAVE_AUTOSUGGEST_API_KEY` for autosuggest.
- It does not request persistent/system privileges and does not modify system config.
- All scripts are Node.js 18+ native (no external dependencies).

ナレッジ管理の人気スキル

搜索引擎ナレッジ管理

通过公开搜索URL在16个搜索引擎(7个国内直连+9个国际)中做跨引擎检索、结果去重与多源交叉验证,无需API Key,内置零依赖Python脚本。Use when 用户要求“搜一下/查资料/多找几个来源/核实消息/找公众号文章/排查报错/找论文或开源项目”时。输入自然语言查询词,输出带来源链接与可信度标注的结构化结果。不适用于私有数据检索、批量抓取、需要登录后可见的内容。

↓ 1075.9万★ 147u_8ee34d77
ima-skillsナレッジ管理

IMA OpenAPI を通じてノートとナレッジベースを操作します。

↓ 108.4万★ 566u_1742680f
Summarizeナレッジ管理

長いテキストや文書、ウェブページを要点とキーワードに圧縮する要約ツールです。

↓ 87.6万★ 1048paudyyin
全网搜索ナレッジ管理

通过“查一下、搜一下、搜索、找一下”等自然语言检索公开网页,整理来源并交付横版 PDF、Markdown 与标题链接表。支持用户主动开启、查看和取消技能收藏,保留原报告取回。

↓ 50.9万★ 2u_32d99f8a
web-tools-guideナレッジ管理

ウェブ要求に適切なツールを割り当てるための必読ガイドです。

↓ 40万★ 220user_ec205dbb
Aihot Skill Liteナレッジ管理

AI HOT (aihot.virxact.com) 中文 AI 资讯查询 Skill。当用户想知道"今天 AI 圈有什么"、"AI 日报"、"AI HOT"、"AI 资讯"、"AI 热点"、"最近 AI"、"OpenAI/Anthropic/Google 最近发布了什么"、"AI hot today"、"AI...

↓ 32.1万★ 92Khazix
全球12亿文献知识库(8千万中文期刊可下载)ナレッジ管理

全球12亿文献知识库(8千万中文期刊可下载)——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力,覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据(期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万)。 能力:中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载(不消耗配额)、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额:首次使用自动注册,免费 100 次检索 + 10 次下载 / 月;耗尽自动弹出套餐(体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包),可说「升级 / 充值」唤起;企业 / 机构定制联系 [email protected]。 触发:用户表达"查论文""找文献""检索学术""搜期刊""查专利""找标准""下论文""写文献综述""找参考文献""查 SCI/EI"等意图时启用;也适用"帮我找关于 XX 的论文""写文献综述""找几篇引用支撑论点"。英文:"find papers" "search literature" "write literature review" "find supporting citations"。 调用前必须先用 /consume 获取 consume_token,再凭 token 调 /search(每次计费接口调用都需一次 /consume)。

↓ 30.3万★ 189user_164f4c1f
Markdown Converterナレッジ管理

uvx 経由で markitdown を呼び、さまざまな形式のファイルを Markdown に変換します。

↓ 20.4万★ 256Peter Steinberger

データ月:2026-10 · ダウンロード数とスター数は公開スキルレジストリ(ClawHub、SkillHub)から月単位で集計しています。詳しくはデータの方法論をご覧ください。