カスタム / 高度な設定

最終更新 July 31, 2026

パワーユーザー、カスタムブラウザ、あるいは未加工の検索エンジン URL を受け付けるあらゆるもののために、Suede の正確な値をここに示す。

二つの URL

用途	URL
検索	`https://suede.io/search?q=%s`
サジェスト	`https://suede.io/api/autosuggest?q=%s`

%s は、ほとんどのブラウザが「検索エンジンを追加する」ダイアログで用いるクエリのプレースホルダーである。代わりに {searchTerms} を期待するブラウザもある(OpenSearch のプレースホルダー)。どちらも同じもの、つまりあなたのクエリの入る場所を指す。
検索 URL は、基本的な既定エンジンに必要なすべてである。
サジェスト URL は任意である。これは OpenSearch Suggestions JSON(application/x-suggestions+json)── 配列 [query, [completions], [descriptions], [urls]] ── を返すので、アドレスバーは入力中に補完を表示できる。 Suede はこれを プライベートに、メモリ内で、自前のコーパスから計算する。あなたにひも付くサジェスト履歴は保持しない。

OpenSearch ディスクリプタ

ブラウザが OpenSearch を読み取るなら、ディスクリプタを指し示せば、両方の URL を自動で取り込む:

TEXT

https://suede.io/opensearch.xml

ディスクリプタは各ページの <head> からも <link rel="search" …> を介して告知されるため、ほとんどのブラウザは自力でそれを見つける ── Android と自動検出を参照のこと。

キーワード / ショートカット検索

Chromium 系ブラウザでは、Suede に ショートカット(例: suede)を与えられる。ショートカットを打ち、Tab か スペース を押し、続いてクエリを入力すれば、Suede が既定でないときでも、必要に応じて Suede を検索できる。Suede の拡張機能は、キーワード suede をあらかじめ設定して提供される。

簡単な例

素の検索 URL(%s / {searchTerms} を、エンコード済みのクエリに置き換える):

TEXT

https://suede.io/search?q=open+source+search

プレフィックスのサジェストを取得する(OpenSearch の JSON 配列を返す):

Shell

curl "https://suede.io/api/autosuggest?q=quantum"