Firecrawl Search Highlights

Firecrawl Search Highlights は、/v2/search の通常の説明文を、検索語に関連する一致ページの本文抜粋に置き換えます。既定で有効で、結果メタデータはそのままです。

概要

Firecrawl Search Highlights は、`/v2/search` 向けの検索出力機能で、通常のプレーンな Web サイト説明文を、ユーザーのクエリに関連するページ内の本文抜粋に置き換えます。検索結果リスト内で最も関連性の高いテキストを直接表示することで、結果をよりすぐに役立つものにすることが目的です。

Highlight は既定で有効で、別の出力形式や `scrapeOptions` の設定は必要ありません。検索レスポンスには引き続き結果の URL、タイトル、position、ranking が含まれ、ハイライトされたコンテンツは Web 結果では `description` に、ニュース結果では `snippet` に表示されます。

機能

検索語に関連する結果抜粋

一致するコンテンツが利用できる場合、通常の Web サイト説明文の代わりに検索語に関連する本文抜粋を返し、各ページを開かずに検索結果を評価しやすくします。

結果構造の保持

URL、タイトル、position、ranking など元の検索結果メタデータを保持しながら、説明文またはスニペット欄にハイライトされたテキストを差し込みます。

既定で有効

`/v2/search` では追加パラメータや `scrapeOptions` なしで既定で動作するため、highlight の出力は通常の検索利用に含まれます。

結果タイプに応じた出力

Web 結果とニュース結果の両方に対応します。Web 結果ではハイライトされたテキストを `description` に、ニュース結果では `snippet` に使用します。

適切なフォールバック動作

Firecrawl が highlight を生成できない場合は通常の説明文またはスニペットにフォールバックし、1 ページが利用できなくても他の結果はブロックしません。

任意でオプトアウト可能

通常の説明文やスニペットを使いたい場合は、`highlights: false` で無効にできます。

ユースケース

リサーチと結果の絞り込み
一般的なページ説明の代わりにクエリ一致の本文抜粋を読むことで、検索結果をより速く確認できます。1 つの質問やトピックに対して多数の結果を比較する場合に便利です。
技術ドキュメントの検索
自然言語クエリで検索し、結果リストに返されるハイライトされた本文抜粋を読むことで、Firecrawl が特定の技術的な質問にどう対応するかを確認できます。
自動化された検索ワークフロー
追加の highlight 専用設定を加えずに、Python、Node.js、cURL、CLI、または MCP ベースのワークフローで同じ検索フローを使用できます。
ニュースの監視と閲覧
最新の記事や発表を検索し、ニュース結果から関連する抜粋を直接読み取れます。ハイライトされたテキストは `snippet` に返されます。

Pros and Cons

Pros

関連する本文抜粋を検索結果に直接表示するため、各ページを開く必要を減らせます。
既定で有効なため、標準的な検索利用で別途セットアップは不要です。
URL、タイトル、position、ranking などの主要な検索メタデータを保持します。
Web 結果とニュース結果の両方のタイプに対応します。
通常のスニペットを優先したい場合は、`highlights: false` で簡単にオプトアウトできます。

Cons

この機能は `/v2/search` に紐づいているため、ここでは他の Firecrawl エンドポイントを一般的に置き換えるものとしては扱っていません。
Firecrawl が結果に対して highlight を生成できない場合、出力は常にハイライトされたテキストになるのではなく、通常の説明文またはスニペットにフォールバックします。

FAQ

Firecrawl の検索で Search Highlights はどのように機能しますか？

Search Highlights は `/v2/search` で既定で有効です。関連するページ本文が利用できる場合、Firecrawl は Web 結果では通常の説明文を、ニュース結果ではスニペットを、ページ内の検索語に関連する本文抜粋に置き換えます。

highlight を使うために何か設定する必要がありますか？

いいえ。ページでは、highlight は既定で有効であり、追加のパラメータ、出力形式、または `scrapeOptions` は不要と説明されています。`highlights` を `false` に設定すると無効にできます。

highlight を有効にすると検索結果のどの部分が変わりますか？

highlight が有効になると、検索結果のフィールド自体が変わります。Web 結果では関連コンテンツが `description` に、ニュース結果では `snippet` に返されます。URL、タイトル、position、ranking は保持されます。

ページを highlight できない場合はどうなりますか？

Firecrawl が結果に対して highlight を生成できない場合は、Web サイトの通常の説明文またはスニペットのままになります。1 件のページが利用できなくても、他の検索結果の返却は妨げられません。

どのインターフェースが Search Highlights をサポートしていますか？

ドキュメントには Python、Node.js、cURL、CLI、`firecrawl_search` MCP ツールの例が示されているため、Search Highlights はこれらのインターフェース全体で利用できます。

Quick Facts

製品: Firecrawl Search Highlights
カテゴリ: 開発者向けツール
主要エンドポイント: `/v2/search`
出力フィールド: Web 結果では `description`、ニュース結果では `snippet`
ソースドメイン: docs.firecrawl.dev