Firecrawl Search Highlights

認領

Firecrawl Search Highlights 以與查詢相關的頁面段落取代一般搜尋描述，預設啟用於 /v2/search，並保留原始結果中繼資料，同時提升搜尋結果脈絡。

AI開發者工具

AI網頁爬蟲

AI搜尋引擎

訪問網站

概述

Firecrawl Search Highlights 是一項適用於 `/v2/search` 的搜尋輸出功能，會以頁面中與使用者查詢相關的段落，取代一般網站描述。其目標是將最相關的文字直接顯示在結果清單中，讓搜尋結果更即時可用。

Highlights 預設啟用，不需要另外設定輸出格式或 `scrapeOptions`。相同的搜尋回應仍會包含結果 URL、標題、位置與排名，而 highlight 內容會在網頁結果的 `description` 與新聞結果的 `snippet` 中顯示。

功能

與查詢相關的結果段落

當有相符內容可用時，回傳與查詢相關的頁面段落，而不是一般網站描述，幫助使用者不必開啟每個頁面就能評估搜尋結果。

保留結果結構

保留原始搜尋結果中繼資料，包括 URL、標題、位置與排名，同時以 highlight 文字取代 description 或 snippet 欄位。

預設啟用

預設在 `/v2/search` 上運作，不需要額外參數或 `scrapeOptions`，因此 highlight 輸出會成為一般搜尋使用的一部分。

依結果類型輸出

支援網頁與新聞結果：網頁結果使用 `description` 顯示 highlight 文字，新聞結果使用 `snippet`。

優雅回退行為

當 Firecrawl 無法產生 highlight 時，會回退為一般描述或 snippet；即使某個頁面無法處理，也不會阻擋其他結果。

可選擇關閉

當偏好一般描述或 snippet 時，可使用 `highlights: false` 來停用。

使用情境

研究與結果篩選
以查詢匹配的段落取代一般頁面描述，更快檢視搜尋結果；在比較單一問題或主題的多個結果時特別實用。
技術文件查詢
使用自然語言查詢來搜尋，並閱讀結果清單中回傳的 highlight 段落，以檢視 Firecrawl 如何回答特定技術問題。
自動化搜尋工作流程
在 Python、Node.js、cURL、CLI 或以 MCP 為基礎的工作流程中使用相同的搜尋流程，而不需要額外加入與 highlight 相關的設定。
新聞監測與閱讀
搜尋即時文章或公告，並直接閱讀新聞結果中的相關摘錄；在這裡，highlight 文字會回傳於 `snippet`。

Pros and Cons

Pros

直接在搜尋結果中顯示相關段落，減少開啟每個頁面的需要。
預設啟用，因此標準搜尋使用不需要額外設定步驟。
保留核心搜尋中繼資料，例如 URL、標題、位置與排名。
支援網頁與新聞兩種結果類型。
當偏好一般 snippet 時，可透過 `highlights: false` 簡單關閉。

Cons

此功能綁定於 `/v2/search`，因此此處不將其視為其他 Firecrawl 端點的通用替代方案。
如果 Firecrawl 無法為某個結果產生 highlight，輸出會退回為一般描述或 snippet，而不是一律回傳 highlight 文字。

FAQ

Search Highlights 在 Firecrawl 搜尋中如何運作？

Search Highlights 預設啟用於 `/v2/search`。當有相關的頁面內容可用時，Firecrawl 會以與查詢相關的頁面段落，取代網頁結果的一般描述，或取代新聞結果的 snippet。

使用 highlights 需要先設定任何東西嗎？

不用。頁面說明指出 highlights 預設啟用，且不需要額外參數、輸出格式或 `scrapeOptions`。你可以將 `highlights` 設為 `false` 來關閉。

啟用 highlights 後，搜尋結果會改變哪一部分？

Search Highlights 會影響搜尋回應本身的欄位。對於網頁結果，相關內容會回傳在 `description`；對於新聞結果，則會回傳在 `snippet`。URL、標題、位置與排名都會保留。

如果頁面無法產生 highlight，會發生什麼事？

如果 Firecrawl 無法為某個結果產生 highlight，就會保留網站原本的描述或 snippet。即使某一個頁面無法處理，也不會影響其他搜尋結果的回傳。

哪些介面支援 Search Highlights？

文件展示了 Python、Node.js、cURL、CLI，以及 `firecrawl_search` MCP 工具的範例，因此 Search Highlights 可以在這些介面中使用。

Quick Facts

產品: Firecrawl Search Highlights
分類: 開發者工具
主要端點: `/v2/search`
輸出欄位: 網頁結果為 `description`，新聞結果為 `snippet`
來源網域: docs.firecrawl.dev