SearXNGの検索構文：!bang・カテゴリ・:jaの使い方早見表

SearXNG の検索構文：早見表

SearXNG の検索構文は、検索語の前に半角の記号を置くだけで使えます。! でエンジンやカテゴリを選び、: で言語を選びます。!! で始まる2つの構文は外部サイトへ直接移動します。そのため、この2つでは SearXNG のプライバシー保護が効きません。

以下の早見表は、公式ドキュメントの Search syntax ページ（2026年10月6日に確認）に載っている構文だけで作りました。検索語の例は日本語に置き換えています。まだ自分のインスタンスがない場合は、VPS に SearXNG を立てる手順から始めてください。

• !wp 東京タワー：エンジンを1つ指定して検索する（例は Wikipedia）
• !wikipedia 東京タワー：ショートカットの代わりにエンジン名を書いても同じ
• !images 富士山：カテゴリを指定して検索する（画像）
• !map 京都駅：カテゴリを指定して検索する（地図）
• !map !ddg !wp 京都駅：指定は重ねられる。重ねると足し算になる
• :ja 量子コンピュータ：この検索だけ言語を日本語にする
• :ja !wp 量子コンピュータ：日本語版 Wikipedia を検索する
• !!wfr Wau Holland：DuckDuckGo 由来の外部 bang。外部サイトへ直接移動する（保護なし）
• !! 東京タワー 公式：最初の検索結果へ直接移動する（保護なし、移動先の確認なし）
• random uuid、avg 123 548 2.04 24.2、md5 lorem ipsum、sha512 lorem ipsum、user-agent：特殊クエリ

wp や ddg は公式ドキュメントに載っている例です。ショートカットはインスタンスごとに違います。使う前に、自分のインスタンスで確かめてください。確かめ方は後の節で説明します。

入力の前に：記号は半角、後ろに半角スペース

日本語入力（IME）がオンのまま打つと、! は全角の「！」に、: は全角の「：」になります。SearXNG が構文として読むのは半角の記号だけです。全角の記号は普通の文字として扱われます。そのため、エンジン指定にも言語指定にもなりません。

記号と検索語の間には半角スペースを入れます。日本語では単語をスペースで区切らないので、ここを間違えやすいです。!wp東京タワー と続けて打つと、SearXNG は wp東京タワー という名前のショートカットを探します。そんな名前のショートカットはないので、エンジン指定になりません。

公式ドキュメントの例は、どれも修飾子を検索語の前に置いています。順番に迷ったら、記号を先頭にまとめてください。

ブラウザの既定の検索エンジンを自分の SearXNG にしているなら、アドレスバーに !wp 東京タワー とそのまま打てます。ブラウザは入力した文字列をそのまま SearXNG に送り、構文の解釈は SearXNG 側で行われるからです。

! でエンジンを選ぶ：!wp と !wikipedia

! の後ろにエンジンのショートカットかエンジン名を書くと、その検索は指定したエンジンだけに送られます。公式ドキュメントの例は !wp paris と !wikipedia paris です。どちらも Wikipedia だけを検索します。wp がショートカットで、wikipedia がエンジン名です。

エンジンを指定すると、普段の検索で使うエンジンの組み合わせは使われません。普段は有効なエンジン全部の結果を混ぜて表示します。!wp を付けた検索では、Wikipedia の結果だけが出ます。調べたいサイトが決まっているときに使います。

自分のインスタンスの bang 一覧はどこで見るか

ショートカットは固定の規格ではありません。各エンジンのショートカットは settings.yml の shortcut: で決まり、管理者が自由に変えられます。ネット上の一覧表をそのまま信じると、自分のインスタンスでは別のエンジンに当たることがあります。エンジン指定にならないこともあります。

自分のインスタンスで確かめる手順です。

1. 自分の SearXNG を開き、画面上部の「設定」（英語 UI では Preferences）を開く。
2. 「エンジン」タブ（英語 UI では Engines）を開く。
3. カテゴリごとにエンジンの表が出る。!bang 列の文字列が、そのエンジンのショートカット。

settings.yml を直接読んでもかまいません。ただし、use_default_settings: true を使う設定ファイルには、自分で変えたエンジンしか書かれていません。残りは SearXNG 本体の既定値から読み込まれます。設定ページの表には実際に読み込まれた結果が出るので、こちらのほうが確実です。

自分で書く settings.yml のエンジン定義は、たとえば次の形です。

engines:
  - name: wikipedia
    engine: wikipedia
    shortcut: wp

! でカテゴリを選ぶ：!images と !map

! の後ろにはカテゴリ名も書けます。公式ドキュメントの例は !images Wau Holland（画像）と !map paris（地図）です。カテゴリを指定すると、そのカテゴリで有効なエンジン全部に検索が送られます。検索画面のカテゴリタブをクリックするのと同じ結果が、キーボードだけで得られます。

日本語 UI のタブには「画像」「地図」と表示されます。構文では、ドキュメントの例と同じ英語の名前で !images と打てば確実です。

指定を重ねると足し算になる

修飾子は重ねられます。公式ドキュメントの例 !map !ddg !wp paris は、地図カテゴリと DuckDuckGo と Wikipedia にまとめて検索を送ります。ここの !ddg は SearXNG のエンジンとしての DuckDuckGo です。問い合わせは SearXNG が中継するので、後で説明する外部 bang とは別物です。

大事なのは、重ねた指定が絞り込みではなく追加になることです。!images !wp 富士山 は「Wikipedia の画像」という意味ではありません。画像カテゴリのエンジン全部と Wikipedia に検索を送り、その結果を混ぜて表示します。結果が多すぎるときは、指定を1つに減らしてください。

:ja で日本語の結果を出す

: の後ろに言語コードを書くと、その検索の言語を指定できます。公式ドキュメントの例 :fr !wp Wau Holland は、フランス語版 Wikipedia で検索します。日本語の言語コードは ja です。

:ja !wp 量子コンピュータ

この形で、日本語版 Wikipedia に直接当たります。Wikipedia エンジンは、指定された言語に合わせて検索先の言語版を選ぶからです。ただし、言語指定に対応していないエンジンもあります。そのエンジンの結果には、他の言語が混じることがあります。

:ja が効くのは、その検索1回だけです。毎回日本語の結果がほしいなら、設定の「一般」タブで検索言語を日本語にしておくほうが楽です。既定を日本語にした人は、逆の使い方ができます。技術情報は英語の資料のほうが詳しいことが多いです。そこで :en !wp Unicode のように、その1回だけ英語に切り替えます。

!! の外部 bang でプライバシー保護が外れる理由

!! の直後に bang 名を続けると、DuckDuckGo の bang（外部サイトへのショートカット）が使えます。公式ドキュメントの例 !!wfr Wau Holland は、フランス語版 Wikipedia の検索ページへ移動します。

公式ドキュメントは、この機能について次のように書いています。

your search will be performed directly in the external search engine. SearXNG cannot protect your privacy with this.

「検索は外部の検索エンジンで直接行われる。この場合、SearXNG はプライバシーを守れない」という意味です。プライバシーのために SearXNG を選んだなら、この記事で一番大事な点はここです。

普段の !wp 検索では、外部のエンジンに問い合わせるのは VPS 上の SearXNG です。Wikipedia から見えるのは VPS の IP アドレスで、あなたのブラウザの Cookie は届きません。外部 bang では、この中継がなくなります。bang の一覧は DuckDuckGo のものですが、移動先は DuckDuckGo ではなく、bang が指す外部サイトです。SearXNG は自分では検索せず、移動先の URL をブラウザに返すだけです。その後はブラウザが外部サイトへ直接つながります。その結果、次のことが起きます。

• 外部サイトには、VPS ではなく、あなたの自宅や携帯回線の IP アドレスが見える。
• ブラウザに保存されたそのサイトの Cookie が送られる。ログイン中なら、検索がアカウントに結びつく。
• 検索語は移動先の URL に入るので、外部サイトのアクセスログに残る。
• 移動先のページが読み込む広告やトラッカーも、そのまま動く。

これは自分で確かめられます。ブラウザの開発者ツールでネットワークタブを開き、!!wfr test で検索してください。SearXNG への最初のリクエストには、リダイレクト（3xx）の応答が返ります。次のリクエストは、外部サイトのドメインへ直接向かいます。アドレスバーにも外部サイトの URL が出ます。

!wp と !!wp の違いは、記号1つだけです。前者は SearXNG が中継する検索です。後者は DuckDuckGo の bang 一覧から wp を探して、外部サイトへ移動する操作です。打ち間違えると、守られているつもりの検索が外に出ます。外部 bang は、この検索は外に出てよいと判断したときだけ使ってください。SearXNG が何を守り、何を守らないかの全体像は、SearXNG は本当に安全かという疑問への答えで整理しています。

単独の !! で最初の結果へ飛ぶときの注意

!! を単独で置き、前後に半角スペースを空けると、結果一覧を出さずに最初の結果へ直接移動します。Google の「I'm Feeling Lucky」と同じ動きです。

!! 東京タワー 公式

公式ドキュメントは、この機能にも警告を付けています。

the result you are being redirected to can't be verified for trustworthiness.

「移動先の結果が信頼できるかどうかは確かめられない」という意味です。検索自体は、普段どおり SearXNG が中継します。問題は移動の部分です。普段は結果一覧でドメインを見てから、開くページを選びます。!! では、この確認の段階がまるごとなくなります。似たドメインの偽サイトやスパムページが1位にあれば、そのページがそのまま開きます。開いたページには、普通にクリックしたときと同じく、あなたの IP アドレスと Cookie が届きます。

!! は、行き先がはっきりしている検索だけに使ってください。銀行やログインが必要なサービスは、!! ではなくブックマークから開くほうが安全です。

!! の直後にスペースがないと、外部 bang の名前として読まれます。!!東京タワー は最初の結果への移動ではありません。東京タワー という名前の外部 bang を探す操作になります。

特殊クエリ：uuid、平均、ハッシュ、user-agent

決まったキーワードで始まる検索は、答えを結果ページに直接表示します。公式ドキュメントが挙げている例は次のとおりです。

• random uuid：ランダムな UUID を作る
• avg 123 548 2.04 24.2：数の平均を出す
• md5 lorem ipsum、sha512 lorem ipsum：文字列のハッシュ値を出す
• user-agent：ブラウザのユーザーエージェントを表示する

ハッシュと user-agent は、有効にしないと使えない場合があります。設定の「特殊クエリ」タブ（英語 UI では Special Queries）を開いてください。そのインスタンスで使えるキーワードの一覧と、機能ごとのオン・オフの切り替えがあります。

既定で無効なエンジンも bang で呼べる

settings.yml で disabled: true になっているエンジンは、普段の検索には加わりません。それでもショートカットは使えます。! で指定すれば、その検索1回だけそのエンジンが使われます。普段は結果を増やしすぎる専門的なエンジンを無効にしておき、必要なときだけ bang で呼ぶ使い方ができます。どのエンジンを常に有効にしておくかは、SearXNG で有効にするエンジンと無効にするエンジンの選び方で詳しく扱っています。

inactive: true のエンジンは別です。こちらはエンジン自体が読み込まれないので、bang で指定しても使えません。

VPS で bang の結果が空になるのはなぜか

VPS の IP アドレスはデータセンターのアドレスです。そのため、一部の検索エンジンは SearXNG からの問い合わせを bot と判断し、CAPTCHA を返します。SearXNG は CAPTCHA を検索結果として読めません。そのエンジンの結果はゼロになり、SearXNG はしばらくの間そのエンジンへの問い合わせを止めます。

普段の検索では、他のエンジンの結果が穴を埋めるので気付きにくいです。しかし bang でそのエンジンだけを指定すると、結果を出せるエンジンが他にありません。そのため結果ページは空になります。結果ページには、結果を取得できなかったエンジンの名前と理由が表示されます。

直し方はSearXNG のエンジンが CAPTCHA エラーを返すときの直し方にまとめています。特定のエンジンへの問い合わせだけを別の出口から送りたい場合は、エンジンのリクエストをプロキシ経由にする設定を参照してください。

FAQ

SearXNG の !bang 一覧はどこで確認できますか？

自分のインスタンスの「設定」を開き、「エンジン」タブ（英語 UI では Engines）を見てください。各エンジンの !bang 列に、そのインスタンスで使えるショートカットが出ています。ショートカットは各インスタンスの settings.yml で決まります。そのため、他のインスタンスやネット上の一覧とは一致しないことがあります。

!! の外部 bang を使うと、何が外部に伝わりますか？

外部 bang では、SearXNG は検索を中継せず、移動先の URL を返すだけです。ブラウザが外部サイトへ直接つながるので、そのサイトにはあなたの IP アドレス、そのサイトの Cookie、URL に入った検索語が届きます。公式ドキュメントも、この場合 SearXNG はプライバシーを守れないと書いています。

毎回 :ja を付けずに日本語の結果を出すにはどうしますか？

設定の「一般」タブで、検索言語を日本語にしてください。:ja はその検索1回だけに効く指定で、設定のほうは毎回の既定値になります。既定を日本語にしたうえで、英語の資料を探すときだけ :en を付ける使い方もできます。

bang を付けたのに効かない、または結果が0件になるのはなぜですか？

普通の検索結果が出てエンジン指定が効かない場合は、入力の問題です。全角の「！」を使っているか、ショートカットと検索語の間に半角スペースがありません。結果が0件の場合は、CAPTCHA が原因のことが多いです。データセンターの IP アドレスから問い合わせたため、エンジンが CAPTCHA を返し、SearXNG がそのエンジンを一時停止しています。普段の検索では他のエンジンが穴を埋めますが、bang で1つだけ指定すると、その穴がそのまま見えます。