# 検索

この search エンドポイントは、Web 検索と Firecrawl のスクレイピング機能を組み合わせることで、あらゆるクエリに対してページ全体のコンテンツを返します。

各検索結果の Markdown 形式の完全なコンテンツを取得するには、`scrapeOptions` に `formats: [{"type": "markdown"}]` を指定してください。指定しない場合は、結果 (url、title、description) がデフォルトで返されます。要約されたコンテンツが必要な場合は、`{"type": "summary"}` など他のフォーマットも使用できます。

<div id="supported-query-operators">
  ## サポートされているクエリ演算子
</div>

検索をより的確に絞り込むための各種クエリ演算子をサポートしています。

| 演算子 | 機能 | 例 |
---|-|-|
| `""` | テキストを厳密一致で検索する | `"Firecrawl"`
| `-` | 特定のキーワードを除外、または他の演算子を否定する | `-bad`, `-site:firecrawl.dev`
| `site:` | 指定したサイトの結果のみを返す | `site:firecrawl.dev`
| `filetype:` | 特定のファイル拡張子を持つ結果のみを返す | `filetype:pdf`, `-filetype:pdf`
| `inurl:` | URL に特定の語を含む結果のみを返す | `inurl:firecrawl`
| `allinurl:` | URL に複数の語を含む結果のみを返す | `allinurl:git firecrawl`
| `intitle:` | ページタイトルに特定の語を含む結果のみを返す | `intitle:Firecrawl`
| `allintitle:` | ページタイトルに複数の語を含む結果のみを返す | `allintitle:firecrawl playground`
| `related:` | 特定のドメインに関連する結果のみを返す | `related:firecrawl.dev`
| `imagesize:` | 指定した寸法と完全一致の画像のみを返す | `imagesize:1920x1080`
| `larger:` | 指定した寸法より大きい画像のみを返す | `larger:1920x1080`

<div id="location-parameter">
  ## Location パラメータ
</div>

`location` パラメータで地域ターゲットの検索結果を取得します。形式: `"string"`。例: `"Germany"`、`"San Francisco,California,United States"`。

利用可能な国と言語の一覧は、[サポート対象ロケーションの全リスト](https://firecrawl.dev/search_locations.json)をご覧ください。

<div id="country-parameter">
  ## Country パラメータ
</div>

`country` パラメータで、ISO の国コードを用いて検索結果の対象国を指定します。既定値: `"US"`。

例: `"US"`, `"DE"`, `"FR"`, `"JP"`, `"UK"`, `"CA"`。

```json
{
  "query": "レストラン",
  "country": "DE"
}
```

<div id="categories-parameter">
  ## Categories パラメータ
</div>

`categories` パラメータを使用して、特定のカテゴリで検索結果を絞り込みます。

* **`research`**: Web 検索を学術・研究 **Web サイト** (arxiv.org、nature.com、ieee.org、pubmed.ncbi.nlm.nih.gov、biorxiv.org、medrxiv.org など) に限定します。論文レコードではなく、スニペット付きの通常の Web ページ結果を返します
* **`pdf`**: PDF を検索
* **`developer`**: [Developer Index](/ja/features/developer) を検索 — 公開コードリポジトリの Issue、マージ済みのプルリクエスト、README、および厳選されたドキュメントサイトを対象に検索します

<Note>
  **`research` は論文インデックスではなく、Web サイト用のフィルターです。** このエンドポイントの Web 検索結果を、あらかじめ定められた学術ドメインのリストに絞り込みます。

  科学文献を直接検索するには、PubMed、bioRxiv、medRxiv、arXiv の論文要旨に加え、論文内のパッセージ読み取りや引用グラフの展開を利用できる [Research Index](/ja/features/research) の [`GET /search/research/papers`](/ja/api-reference/endpoint/research-search-papers) を使用してください。
</Note>

<div id="example-usage">
  ### 使い方の例
</div>

```json
{
  "query": "機械学習",
  "categories": ["research", "pdf"],
  "limit": 10
}
```

<div id="domain-filters">
  ## ドメインフィルター
</div>

`includeDomains` を使うと結果を特定のドメインに限定でき、`excludeDomains` を使うと検索結果から特定のドメインを除外できます。ドメインには、プロトコルやパスを含めず、ホスト名のみを指定してください。

`includeDomains` と `excludeDomains` は同時に使用できません。

<div id="include-domains-example">
  ### 含めるドメインの例
</div>

```json
{
  "query": "web scraping",
  "includeDomains": ["firecrawl.dev", "docs.firecrawl.dev"],
  "limit": 10
}
```

<div id="exclude-domains-example">
  ### 除外ドメインの例
</div>

```json
{
  "query": "web scraping tools",
  "excludeDomains": ["example.com"],
  "limit": 10
}
```

<div id="category-response">
  ### カテゴリレスポンス
</div>

各結果には、どのソースからのものかを示す `category` フィールドが含まれます。

```json
{
  "success": true,
  "data": {
    "web": [
      {
        "url": "https://arxiv.org/abs/2024.12345",
        "title": "ML Research Paper",
        "description": "Latest advances in machine learning",
        "category": "research"
      },
      {
        "url": "https://example.com/ml-survey.pdf",
        "title": "ML Survey",
        "description": "A survey of machine learning methods",
        "category": "pdf"
      }
    ]
  }
}
```

<div id="time-based-search">
  ## 時間ベースの検索
</div>

`tbs` パラメータを使用すると、カスタム日付範囲を含む期間で検索結果を時間別に絞り込むことができます。詳細な例とサポートされている形式については、[検索機能のドキュメント](https://docs.firecrawl.dev/features/search#time-based-search)を参照してください。

> Firecrawl API key が必要な AI agent ですか？自動オンボーディング手順については、[firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md)を参照してください。