mcpField
B
brave-search

brave-search

github.com/badlogic生産性2.6k1.4k 回インストール21 週間前に更新
リポジトリ

brave-search について

Brave Search API を使ってウェブ検索とページ内容の抽出を行うコマンドラインスキルです。ブラウザー操作なしで最新情報の検索やページ本文の取得を必要とする作業に向いています。

主な機能

  1. 01Brave Search API によるウェブ検索
  2. 02結果数と国の指定
  3. 03日付や期間による絞り込み
  4. 04Markdown 形式でのページ内容抽出

活用シーン

  1. 01ドキュメントや API リファレンスの検索
  2. 02最新の事実や情報の確認
  3. 03URL から読みやすい本文を取得

インストール

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

$npx skills add https://github.com/badlogic/pi-skills --skill brave-search

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
content.js
package-lock.json
package.json
search.js

詳細

Brave Search

公式の Brave Search API を使用して、ウェブ検索とコンテンツの抽出を行います。ブラウザーは不要です。

セットアップ

無料プランに登録した Brave Search API アカウントが必要です。無料プランの登録にはクレジットカードが必要ですが、請求は発生しません。

  1. https://api-dashboard.search.brave.com/register でアカウントを作成します
  2. 「Free AI」プランを作成します
  3. プランの API キーを作成します
  4. シェルのプロファイル（zsh の場合は ~/.profile または ~/.zprofile）に追加します： 
    export BRAVE_API_KEY="your-api-key-here"
  5. 依存関係をインストールします（1 回のみ実行）： 
    cd {baseDir}
npm install

検索

{baseDir}/search.js "query"                         # Basic search (5 results)
{baseDir}/search.js "query" -n 10                   # More results (max 20)
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" --freshness pw          # Results from last week
{baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
{baseDir}/search.js "query" --country DE            # Results from Germany
{baseDir}/search.js "query" -n 3 --content          # Combined options
オプション
  • -n <num> - 検索結果の件数（デフォルト：5、最大：20）
  • --content - ページのコンテンツを取得し、Markdown として含めます
  • --country <code> - 2 文字の国コード（デフォルト：US）
  • --freshness <period> - 期間で絞り込みます：
    • pd - 過去 1 日（24 時間）
    • pw - 過去 1 週間
    • pm - 過去 1 か月
    • py - 過去 1 年
    • YYYY-MM-DDtoYYYY-MM-DD - 任意の日付範囲

ページコンテンツの抽出

{baseDir}/content.js https://example.com/article

URL を取得し、読みやすいコンテンツを Markdown として抽出します。

出力形式

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Age: 2 days ago
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...

使用する場面

  • ドキュメントや API リファレンスの検索
  • 事実や最新情報の確認
  • 特定の URL からのコンテンツ取得
  • 対話型のブラウジングを使わずにウェブ検索が必要なあらゆるタスク

コメント

Markdown 対応