Developer Index - Firecrawl Docs

Firecrawl Developer は、コーディングエージェント向けに構築されたインデックスです。公開コードリポジトリの Issue、マージ済みのプルリクエスト、README に加え、厳選されたドキュメントサイトを対象としており、エージェントは一般的な Web ページではなく一次ソースに基づいて、コードの動作、ライブラリやフレームワーク、API 契約、エラーメッセージ、既知のバグに関する質問に回答できます。

バグが報告され修正された Issue またはプルリクエストを見つける
特定の質問への回答が記載された README またはドキュメントページの本文箇所を読む
API 契約を変更したプルリクエストまでたどる
エラーメッセージの背景にある議論を確認する

Note

エージェントに Developer Index へのアクセスを付与するには、CLI または MCP と、次のコマンドでインストールできる専用の developer skillを組み合わせて使用することを強くお勧めします。

npx -y firecrawl-cli@latest setup developer-index

エンドポイント#

タスク	エンドポイント
Developer Index を検索	`GET` または `POST /search/developer`
Web Search に開発者向け結果を追加	`categories: ["developer"]` を指定した `POST /search`

Developer Index を検索する#

自然言語の質問を送信すると、一致した本文箇所とともに、ランク付けされた開発者向け結果が返されます。開発者向けソースのみを対象に検索する場合に使用します。結果タイプ、リポジトリ、ドキュメントソースで絞り込めます。

開発者向け検索のコストは、結果10件ごとに2クレジットです (切り上げ) 。たとえば、結果1～10件は2クレジット、11～20件は4クレジットです。開始時に APIキーは不要です。より高いレート制限を利用するには、APIキーを追加してください。

# No API key needed to get started; add -H "Authorization: Bearer $FIRECRAWL_API_KEY" for higher rate limits:curl -s "https://api.firecrawl.dev/v2/search/developer?query=how%20do%20I%20configure%20retries&k=10"

同じパスで POST も利用でき、配列フィルタを JSON として渡す場合はこちらのほうが簡単です。

cURL

# 開始するのにAPI keyは不要です。レート制限を引き上げるには -H "Authorization: Bearer $FIRECRAWL_API_KEY" を追加してください:curl -X POST https://api.firecrawl.dev/v2/search/developer \  -H "Content-Type: application/json" \  -d '{    "query": "how do I configure retries",    "k": 10,    "types": ["issue", "pull_request"]  }'

各結果には、issue:owner/repo#123 のような安定した id、url、Markdown 形式の一致した passages が含まれるため、表やコードブロックも保持されます。アーティファクトの種類は id の接頭辞にエンコードされています。doc:、issue:、pull_request:、または readme: です。ソースページに使用可能なタイトルがない場合、doc の結果には title が含まれないことが多いため、フィールドが存在することを前提にせず、代わりに url を使用してください。

sources または repos で検索範囲を指定すると、レスポンスではエントリごとに indexed フラグとともにそれらが返されるため、インデックスに存在しない ID と、単に結果が見つからなかった query を区別できます。返される形式については、Developer Search リファレンスを参照してください。

任意のフィルタで検索を絞り込めます。

k は返される結果数を設定し、デフォルトは 10 です。passages は各結果に含める一致した本文箇所の数を設定します
types は、doc、issue、pull_request、readme のうち、どれを検索するかを指定します
repos はインデックスのリポジトリ側を対象範囲に指定し、sources はドキュメント側を対象範囲に指定します
skills を only に設定すると、検索対象をインデックス化された agent-skill ファイルに限定します
language、topic、license、min_stars、max_stars、archived、fork は、language=Rust、topic=async、license=MIT などのリポジトリ属性で絞り込みます

これら 7 つのフィルタはコードリポジトリを対象とするため、sources の対象範囲を指定せずにいずれかを送信すると、doc の結果は返されません。送信前に、リポジトリフィルタが検索範囲に与える影響を確認してください。

すべてのフィルタの型と範囲、repos と sources が検索範囲をどのように指定するか、完全なレスポンススキーマについては、Developer Search リファレンスを参照してください。

Note

Python および Node SDK は、以下に示す developer カテゴリを通じて Developer Index にアクセスします。このエンドポイント専用のメソッドは提供していないため、HTTP、CLI、または MCP 経由で呼び出してください。

web検索に開発者向け結果を追加する#

/search の categories 配列では、唯一のエントリとして developer を指定します。レスポンスでは、開発者向け結果が標準の web グループに返され、それぞれに category: "developer" が付与されます。developer カテゴリを他のカテゴリと組み合わせることはできません。

開始するのにAPIキーは不要です。/search はAPIキーなしのリクエストを受け付け、developer カテゴリもAPIキーなしの利用枠の範囲で利用できます。より高いレート制限を利用するにはキーを送信してください。

# 開始するのにAPIキーは不要です。より高いレート制限を利用するには -H "Authorization: Bearer $FIRECRAWL_API_KEY" を追加してください:curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -d '{    "query": "how do I configure retries",    "categories": ["developer"],    "limit": 10  }'

開発者向け結果には、web結果と同じ形式の url、title、description、position に加え、category: "developer" が含まれます。SDK ユーザーは result.web から取得します。

このインターフェースでは、ランク付けされた開発者向け結果の形式ではなく、web結果の形式が返されます。一致した本文箇所とインデックスフィルタについては、開発者検索エンドポイントを使用してください。

Note

ホスト型の MCP server は両方のインターフェースを公開しており、どちらも書き込みを行いません。firecrawl_developer_search、firecrawl_search 経由の開発者向け結果、およびAPIキーなしのツール群で利用できるのがどちらかについては、MCP toolsを参照してください。