搜索高亮

搜索高亮会将每个结果原本普通的网站描述替换为页面中与您的查询相关的段落。它们在 /v2/search 上默认启用；无需额外的参数、输出格式或 scrapeOptions。搜索高亮会保留搜索结果的 URL、标题、位置和排名。对于网页结果，高亮文本会在 description 中返回；对于新闻结果，则会在 snippet 中返回。

如果 Firecrawl 无法为某个结果生成搜索高亮，则会保留该网站原本的普通描述或 snippet。单个页面不可用不会影响返回其他搜索结果。

默认启用搜索高亮

正常使用 Search 即可；当有相关页面内容可用时，Firecrawl 会返回搜索高亮。

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

results = firecrawl.search(
    query="how does firecrawl handle javascript rendering",
    limit=5,
)

for result in results.web or []:
    print(result.description)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: 'fc-YOUR-API-KEY' });

const results = await firecrawl.search(
  'how does firecrawl handle javascript rendering',
  {
    limit: 5,
  }
);

for (const result of results.web ?? []) {
  console.log(result.description);
}

curl -X POST https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how does firecrawl handle javascript rendering",
    "limit": 5
  }'

firecrawl search "how does firecrawl handle javascript rendering" \
  --limit 5

MCP

firecrawl_search MCP 工具默认也会返回搜索高亮：

MCP

{
  "query": "how does firecrawl handle javascript rendering",
  "limit": 5
}

响应

搜索高亮沿用现有的描述字段，因此响应结构与普通搜索响应相同。

{
  "success": true,
  "data": {
    "web": [
      {
        "url": "https://www.firecrawl.dev/blog/javascript-web-scraping",
        "title": "Web Scraping With JavaScript: Step-by-Step Guide",
        "description": "# Web Scraping With JavaScript: Step-by-Step Guide\n## When should you use scraping APIs instead of DIY tools?\n### Setting up Firecrawl\n```\nnpm install firecrawl\n```\n\n```\nFIRECRAWL_API_KEY=fc-your-api-key-here\n```\n\n### Solving the JavaScript quotes problem\nYou describe what you want, and Firecrawl handles extraction and validation.",
        "position": 1
      }
    ]
  }
}

如果相关页面内容包含标题、列表、表格或代码，搜索高亮可能会包含 Markdown。若要保留这种结构，请将该字段按 Markdown 渲染或处理。

禁用搜索高亮

如果你想返回每个网站的纯文本描述或 snippet 片段，而不是 highlights，请将 highlights 设为 false。

results = firecrawl.search(
    query="Firecrawl search API",
    highlights=False,
)

const results = await firecrawl.search('Firecrawl search API', {
  highlights: false,
});

curl -X POST https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Firecrawl search API",
    "highlights": false
  }'

firecrawl search "Firecrawl search API" --no-highlights

按结果类型划分的行为

网页： 在可用时，会用与查询相关的页面内容替换 description。
新闻： 在可用时，会用与查询相关的页面内容替换 snippet。
图像： 图像结果将原样返回。
带抓取的搜索： highlights 会影响搜索结果中的 description 或 snippet。通过 scrapeOptions 请求的内容会单独返回，不会被替换。
Zero Data Retention： ZDR 搜索会保留网站原本的 description 和 snippet。

有关 Search 的所有参数及完整的响应 schema，请参见 Search API reference。

快速上手

核心端点

更多

快速入门

开发者指南

Webhooks

使用场景

其他

参与贡献

默认启用搜索高亮

MCP

响应

禁用搜索高亮

按结果类型划分的行为

​默认启用 搜索高亮

​MCP

​响应

​禁用搜索高亮

​按结果类型划分的行为

默认启用搜索高亮

MCP

响应

禁用搜索高亮

按结果类型划分的行为