Firecrawl Search Highlights

Firecrawl Search Highlights 将普通搜索描述替换为与查询相关的页面段落。默认启用于 /v2/search，保留原始结果元数据，同时提升结果上下文。

概述

Firecrawl Search Highlights 是 `/v2/search` 的一种搜索输出功能，用页面中与用户查询相关的段落替换通常的普通网站描述。其目标是通过在结果列表中直接展示最相关的文本，让搜索结果更快、更实用。

Highlights 默认启用，不需要单独的输出格式或 `scrapeOptions` 设置。相同的搜索响应仍然包含结果 URL、标题、位置和排名，而高亮内容会在网页结果的 `description` 中、新闻结果的 `snippet` 中显示。

功能

与查询相关的结果段落

当存在匹配内容时，返回与查询相关的段落，而不是普通的网站描述，帮助用户无需打开每个页面即可评估搜索结果。

保留结果结构

保留原始搜索结果元数据，包括 URL、标题、位置和排名，同时用高亮文本替换描述或摘要字段。

默认启用

默认在 `/v2/search` 上工作，无需额外参数或 `scrapeOptions`，因此高亮输出是正常搜索使用的一部分。

按结果类型适配的输出

同时支持网页和新闻结果：网页结果使用 `description` 返回高亮文本，新闻结果使用 `snippet`。

优雅回退行为

当 Firecrawl 无法生成高亮时，会回退为普通描述或摘要；如果某一页面不可用，也不会阻塞其他结果。

可选关闭

当更偏好普通描述或摘要时，可使用 `highlights: false` 将其关闭。

使用场景

研究与结果筛选
用查询匹配的段落代替通用页面描述，更快地浏览搜索结果；当需要比较单个问题或主题的多个结果时尤其有用。
技术文档查询
使用自然语言查询搜索，并阅读结果列表中返回的高亮段落，以查看 Firecrawl 如何回答特定技术问题。
自动化搜索工作流
在 Python、Node.js、cURL、CLI 或基于 MCP 的工作流中使用相同的搜索流程，而无需添加额外的高亮专用配置。
新闻监测与阅读
搜索当前文章或公告，并直接阅读新闻结果中的相关摘录，其中高亮文本会在 `snippet` 中返回。

Pros and Cons

Pros

直接在搜索结果中展示相关段落，减少打开每个页面的需要。
默认启用，因此标准搜索使用无需单独设置步骤。
保留 URL、标题、位置和排名等核心搜索元数据。
同时支持网页和新闻结果类型。
当更偏好普通摘要时，可通过 `highlights: false` 简单关闭。

Cons

该功能绑定于 `/v2/search`，因此这里不将其表述为其他 Firecrawl 端点的通用替代方案。
如果 Firecrawl 无法为某个结果生成 highlight，输出会回退为普通描述或摘要，而不是始终返回高亮文本。

FAQ

Firecrawl 搜索中的 Search Highlights 如何工作？

Search Highlights 默认启用于 `/v2/search`。当可用相关页面内容时，Firecrawl 会将网页结果中的普通描述或新闻结果中的摘要替换为来自页面、与查询相关的段落。

使用 highlights 需要配置什么吗？

不需要。页面说明 highlights 默认启用，不需要额外参数、输出格式或 `scrapeOptions`。你可以通过将 `highlights` 设为 `false` 来关闭它们。

启用 highlights 后，搜索结果的哪一部分会变化？

Highlights 会影响搜索响应字段本身。对于网页结果，相关内容会返回在 `description` 中；对于新闻结果，会返回在 `snippet` 中。URL、标题、位置和排名都会保留。

如果某个页面无法高亮，会发生什么？

如果 Firecrawl 无法为某个结果生成 highlight，它会保留该网站的普通描述或摘要。某一页面不可用不会阻止其他搜索结果返回。

哪些接口支持 Search Highlights？

文档展示了 Python、Node.js、cURL、CLI 和 `firecrawl_search` MCP 工具的示例，因此 Search Highlights 可以在这些接口中使用。

Quick Facts

产品: Firecrawl Search Highlights
类别: 开发者工具
主要端点: `/v2/search`
输出字段: 网页结果为 `description`，新闻结果为 `snippet`
来源域名: docs.firecrawl.dev