mcpField
B
brave-search

brave-search

github.com/alphaonedev生産性48 回インストール
リポジトリ

brave-search について

brave-search は、最新のウェブ情報を必要とするエージェント向けに、Brave Search を AI ワークフローで利用するスキルです。セーフサーチ、言語、国による絞り込みに対応し、タイトル、URL、説明を含む結果を返します。

主な機能

  1. 01Brave Search でウェブ検索
  2. 02結果数とオフセットの指定
  3. 03安全性、言語、国による絞り込み
  4. 04タイトル、URL、説明の抽出
  5. 05API キーによる認証

活用シーン

  1. 01回答用の最新ウェブ情報を検索
  2. 02地域や言語で検索結果を絞り込み
  3. 03セーフサーチで結果を制限

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill brave-search

インストール後、Claude Code で/brave-searchを入力して読み込まれたか確認します。

詳細

brave-search

目的

このスキルは、プライバシーを重視したウェブ検索 API である Brave Search を利用できます。追跡なしでウェブを検索でき、AI を活用したアプリケーション向けにフィルターやスニペット抽出にも対応しています。

使用する場面

AI ワークフローで、すばやくプライベートなウェブ検索が必要な場合に使用します。たとえば、回答用のリアルタイムデータの取得、ユーザーのクエリのデータ収集の回避、フィルター済みの結果を必要とするツールへの検索機能の統合（ファミリー向けコンテンツのセーフサーチなど）に利用できます。

主な機能

  • クエリ文字列、結果数（最大 50 件など）、セーフサーチ、言語（例：「en-US」）、国（例：「US」）のフィルターなどのパラメーターを指定して検索できます。
  • スニペットを抽出できます。API は各検索結果のタイトル、URL、説明の各フィールドを含む JSON を返します。
  • プライバシー機能：ユーザーを追跡せず、Brave のインデックスに基づく結果を返します。
  • レート制限：プランに応じて、API キーごとに 1 日最大 1000 リクエストです。

使用パターン

リクエストの認証には必ず $BRAVE_API_KEY 環境変数を使用してください。必要なパラメーターを指定して、エンドポイントに HTTP GET リクエストを送信します。クエリは URL エンコードされた文字列として構成します。AI エージェントでは、Python や curl などの言語やツールの HTTP クライアントを介して統合します。'offset' パラメーターを増やしながらループでテストし、ページネーションを確認します（例：0 から始めて、次に 10 を指定します）。

一般的なコマンド/API

エンドポイント： https://api.search.brave.com/res/v1/web/search
認証：ヘッダー 'X-Subscription-Token: $BRAVE_API_KEY' を含めます（環境で export BRAVE_API_KEY=your_key を実行して設定します）。
主なパラメーター：q（クエリ文字列）、count（結果数。例：10）、offset（ページネーション用。例：0）、search_lang（例：「en」）、country（例：「US」）、safe（セーフサーチの場合は「active」など）。
curl コマンドの例：

curl -H "X-Subscription-Token: $BRAVE_API_KEY" "https://api.search.brave.com/res/v1/web/search?q=AI+assistants&count=5&search_lang=en"

requests を使用した Python のスニペット：

import requests; import os;  
response = requests.get('https://api.search.brave.com/res/v1/web/search', headers={'X-Subscription-Token': os.environ['BRAVE_API_KEY']], params={'q': 'open source AI', 'count': 3})

設定形式：API キーを .env ファイルに BRAVE_API_KEY=your_key として保存し、python-dotenv などのライブラリで読み込みます。

統合に関する注意

API 呼び出しを AI エージェントのコードでラップして統合します。ブロッキングを避けるには、非同期リクエストを使用します。たとえば OpenClaw では、外部データを必要とする回答を生成する前に、このスキルを呼び出します。設定は $BRAVE_API_KEY のエクスポート、またはセキュアな保管庫からの読み込みで処理します。他の AI API と組み合わせる場合は、言語モデルなどのツールの後にこのスキルを連携させ、出力を充実させます（例：コンテキストを検索してから要約します）。ウェブコンテンツは変動しやすいため、結果を 1 時間を超えてキャッシュしないでください。

エラー処理

HTTP ステータスコードを確認します。成功は 200、API キーが無効な場合は 401（$BRAVE_API_KEY を確認してから再試行）、レート制限の場合は 429 です（指数バックオフを使用して待機後に再試行します。例：5～10 秒）。JSON レスポンスを解析し、"error": "Bad request" などのエラーを確認して、詳細をログに記録します。コードでは try-except ブロックを使用します。

try: response = requests.get(...)  
except requests.exceptions.RequestException as e: print(f"Error: {e}"); exit(1)

CLI では、出力を grep にパイプしてエラーパターンを検索し、失敗時にはゼロ以外のコードで終了します。

具体的な使用例

  1. 最新の AI ニュースを検索する：AI のトピックに関する見出しの取得に使用します。コマンド：curl -H "X-Subscription-Token: $BRAVE_API_KEY" "https://api.search.brave.com/res/v1/web/search?q=latest+AI+advancements&count=3&search_lang=en"。エージェントで最初の結果のスニペットを抽出し、回答に追加します。
  2. クエリ分析用にスニペットを抽出する：たとえば「best open source tools」のようなユーザーのクエリに対して、次を実行します：curl -H "X-Subscription-Token: $BRAVE_API_KEY" "https://api.search.brave.com/res/v1/web/search?q=best+open+source+tools&safe=active&country=US"。JSON を処理して説明を取得し、抽出したデータに基づくツールの推奨に AI の推論を使用します。

グラフの関係性

  • 関連先：ai-apis（クラスター）。他の AI ツール向けに検索機能を提供します。
  • 接続先：フォールバック用の ai-apis 内の他の検索 API、または結果分析用のデータ処理スキル。

コメント

Markdown 対応