> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 検索ハイライト

> 通常の Web サイトの説明ではなく、query に関連する本文箇所を返します

検索ハイライトは、各検索結果の通常の Web サイト説明を、query に関連するページ内の本文箇所に置き換えます。これは `/v2/search` でデフォルトで有効になっており、追加のパラメータ、出力形式、または `scrapeOptions` は必要ありません。

ハイライトでは、検索結果の URL、タイトル、掲載位置、ランキングが保持されます。Web 検索結果では、ハイライトされたテキストは `description` に返されます。ニュース検索結果では、`snippet` に返されます。

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

<div id="highlights-are-enabled-by-default">
  ## ハイライトはデフォルトで有効です
</div>

通常どおり Search を使用すると、関連するページコンテンツが利用可能な場合、Firecrawl はハイライトを返します。

<CodeGroup>
  ```python Python theme={null}
  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)
  ```

  ```js Node theme={null}
  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);
  }
  ```

  ```bash cURL theme={null}
  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
    }'
  ```

  ```bash CLI theme={null}
  firecrawl search "how does firecrawl handle javascript rendering" \
    --limit 5
  ```
</CodeGroup>

<div id="mcp">
  ### MCP
</div>

`firecrawl_search` MCPツールでも、デフォルトでハイライトが返されます。

```json MCP theme={null}
{
  "query": "how does firecrawl handle javascript rendering",
  "limit": 5
}
```

<div id="response">
  ## レスポンス
</div>

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

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

<div id="disable-highlights">
  ## ハイライト を無効にする
</div>

各 Web サイトについて、`highlights` の代わりに通常の説明文やスニペットを返したい場合は、`highlights` を `false` に設定します。

<CodeGroup>
  ```python Python theme={null}
  results = firecrawl.search(
      query="Firecrawl search API",
      highlights=False,
  )
  ```

  ```js Node theme={null}
  const results = await firecrawl.search('Firecrawl search API', {
    highlights: false,
  });
  ```

  ```bash cURL theme={null}
  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
    }'
  ```

  ```bash CLI theme={null}
  firecrawl search "Firecrawl search API" --no-highlights
  ```
</CodeGroup>

<div id="behavior-by-result-type">
  ## 結果タイプごとの動作
</div>

* **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リファレンス](/ja/api-reference/endpoint/search)を参照してください。