メインコンテンツへスキップ

/map の紹介

単一のURLからウェブサイト全体のマップを素早く取得する最も簡単な方法です。次の用途に非常に有用です:
  • エンドユーザーに、どのリンクをスクレイプするか選んでもらう必要があるとき
  • サイト上のリンクをすぐに把握したいとき
  • 特定のトピックに関連するページだけをスクレイプしたいとき (search パラメータを使用)
  • サイトの特定ページだけをスクレイプすればよいとき

Playground で試してみる

インタラクティブなPlaygroundでマッピングをテストできます。コードは不要です。

マッピング

/map エンドポイント

URL をマッピングし、サイト内の URL を取得するために使用します。サイト上に存在するリンクの大部分を返します。 URL は主にウェブサイトのサイトマップから検出され、カバレッジを向上させるために SERP (検索エンジン) の結果および以前にクロールされたページによって補完されます。sitemap パラメータでサイトマップの動作を制御できます。

インストール

使い方

各 map リクエストは、返される URL の数に関係なく、1 コールあたり 1 クレジットを消費します。例えば、limit を 100,000 に設定しても、使用するクレジットは 1 つだけです。

レスポンス

SDKはデータオブジェクトを直接返します。cURLは下記のとおり、ペイロードをそのまま返します。
タイトルや説明はサイトによって異なるため、常に含まれるとは限りません。
search パラメータを使うと、サイト内の特定のURLを検索できます。
cURL
返答は、関連性の高い順に並べた番号付きリストで提供されます。

位置と言語

対象の地域と言語の優先度に基づいて関連コンテンツを取得するため、国と言語の優先設定を指定します。/scrape エンドポイントと同様です。

仕組み

ロケーション設定を指定すると、Firecrawl は (利用可能であれば) 適切なプロキシを使用し、対応する言語とタイムゾーン設定をエミュレートします。指定がない場合、ロケーションは既定で「US」になります。

使用方法

位置情報と言語設定を利用するには、リクエストボディに location オブジェクトを含め、次のプロパティを指定してください。
  • country: ISO 3166-1 alpha-2 の国コード (例: ‘US’、‘AU’、‘DE’、‘JP’) 。デフォルトは ‘US’ です。
  • languages: リクエストで優先する言語・ロケールの配列 (優先順) 。デフォルトは指定した国・地域の言語です。
対応している国・地域の詳細は、プロキシのドキュメントを参照してください。

留意事項

このエンドポイントは速度を優先しているため、Web サイト上のリンクをすべて取得できない場合があります。主に Web サイトのサイトマップを使用し、キャッシュ済みのクロールデータや検索エンジンの結果で補完しています。より網羅的かつ最新の URL リストが必要な場合は、代わりに /crawl エンドポイントを使用することをご検討ください。
Firecrawl API キーが必要な AI エージェントですか?自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md をご覧ください。