検索 - Firecrawl Docs

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

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

サポートされているクエリ演算子#

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

演算子	機能	例
`""`	テキストを厳密一致で検索する	`"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`

Location パラメータ#

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

利用可能な国と言語の一覧は、サポート対象ロケーションの全リストをご覧ください。

Country パラメータ#

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

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

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

Categories パラメータ#

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 を検索 — 公開コードリポジトリの Issue、マージ済みのプルリクエスト、README、および厳選されたドキュメントサイトを対象に検索します

Note

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

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

使い方の例#

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

ドメインフィルター#

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

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

含めるドメインの例#

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

除外ドメインの例#

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

カテゴリレスポンス#

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

{  "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"      }    ]  }}

時間ベースの検索#

tbs パラメータを使用すると、カスタム日付範囲を含む期間で検索結果を時間別に絞り込むことができます。詳細な例とサポートされている形式については、検索機能のドキュメントを参照してください。

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