検索ハイライト

検索ハイライトは、各検索結果の通常の Web サイト説明を、query に関連するページ内の本文箇所に置き換えます。これは /v2/search でデフォルトで有効になっており、追加のパラメータ、出力形式、または scrapeOptions は必要ありません。ハイライトでは、検索結果の URL、タイトル、掲載位置、ランキングが保持されます。Web 検索結果では、ハイライトされたテキストは description に返されます。ニュース検索結果では、snippet に返されます。

Firecrawl が検索結果のハイライトを生成できない場合は、Web サイトの通常の説明または snippet がそのまま保持されます。利用できないページが 1 つあっても、他の検索結果の返却は妨げられません。

ハイライトはデフォルトで有効です

通常どおり 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
}

レスポンス

ハイライトは既存のdescriptionフィールドを使用するため、レスポンスの形式は通常の検索レスポンスと変わりません。

{
  "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 としてレンダリングまたは処理してください。

ハイライトを無効にする

各 Web サイトについて、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

結果タイプごとの動作

Web: 利用可能な場合、description は query に関連するページコンテンツに置き換えられます。
News: 利用可能な場合、snippet は query に関連するページコンテンツに置き換えられます。
Images: 画像結果は変更されずに返されます。
Search with scraping: ハイライトは検索結果の description または snippet に反映されます。scrapeOptions で要求した content は別途返され、置き換えられません。
Zero Data Retention: ZDR 検索では、Web サイトの通常の description と snippet が保持されます。

すべての Search パラメータと完全なレスポンス schema については、Search APIリファレンスを参照してください。

はじめに

主要エンドポイント

その他

クイックスタート

開発者ガイド

webhook

ユースケース

その他

貢献

検索ハイライト

ハイライトはデフォルトで有効です

MCP

レスポンス

ハイライトを無効にする

結果タイプごとの動作

​ハイライトはデフォルトで有効です

​MCP

​レスポンス

​ハイライト を無効にする

​結果タイプごとの動作

ハイライトはデフォルトで有効です

MCP

レスポンス

ハイライトを無効にする

結果タイプごとの動作