spellcheck について
spellcheckは、検索アプリやクエリの入力を整えるツール向けのBrave Search APIエンドポイントです。文脈を考慮した修正候補を返し、検索前に単独で利用できます。
主な機能
- 01クエリのスペルチェック
- 02文脈に応じた修正候補
- 03言語と国の設定に対応
- 04候補がない場合は空の結果
活用シーン
- 01検索前のクエリ整形
- 02画面での修正候補の提示
- 03ユーザー入力の一括正規化
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ brave/ brave-search-skills --skill spellcheckインストール後、Claude Code で/spellcheckを入力して読み込まれたか確認します。
詳細
Spellcheck
API キーが必要です:https://api.search.brave.com で取得してください。
プラン:Spellcheck プランに含まれています。https://api-dashboard.search.brave.com/app/subscriptions/subscribe をご覧ください。
クイックスタート(cURL)
curl -s "https://api.search.brave.com/res/v1/spellcheck/search" \
-H "Accept: application/json" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
-G \
--data-urlencode "q=artifical inteligence" \
--data-urlencode "lang=en" \
--data-urlencode "country=US"
エンドポイント
GET https://api.search.brave.com/res/v1/spellcheck/search
認証:X-Subscription-Token: <API_KEY> ヘッダー
パラメーター
| パラメーター | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
q | string | はい | — | スペルチェックするクエリ(1~400 文字、最大 50 語) |
lang | string | いいえ | en | 言語設定(2 文字以上の言語コード。例:en、fr、de、pt-br、zh-hans)。51 種類のコードに対応 |
country | string | いいえ | US | 検索対象の国(2 文字の国コードまたは ALL) |
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
type | string | 常に "spellcheck" |
query.original | string | 送信された入力クエリ |
results | array | スペルを修正した候補。修正が見つからない場合は空になることがあります |
results[].query | string | 修正されたクエリ |
レスポンスの例
{
"type": "spellcheck",
"query": {
"original": "artifical inteligence"
},
"results": [
{
"query": "artificial intelligence"
}
]
}
ユースケース
- 検索前のクエリ整理:呼び出す検索エンドポイントを決める前にスペルを確認します
- 「もしかして?」UI:検索を実行する前に、修正候補をユーザーに表示します
- クエリの一括正規化:ユーザー入力をまとめて整理します
注意事項
- 組み込みの代替手段:Web Search と LLM Context では、デフォルトで
spellcheck=trueが設定されています。検索前に修正が必要な場合にのみ、この単独のエンドポイントを使用してください - 文脈を考慮:個々の単語だけでなく、クエリ全体の文脈を考慮して修正します
コメント
Markdown 対応