Developer Index

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

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

エージェントに 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"

firecrawl developer "how do I configure retries" --limit 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 リファレンスを参照してください。

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
  }'

firecrawl search "how do I configure retries" --categories developer --limit 10

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

result = firecrawl.search(
    "how do I configure retries",
    categories=["developer"],
    limit=10,
)
for item in result.web or []:
    print(item.url, item.title)

import { Firecrawl } from "firecrawl";

const firecrawl = new Firecrawl({
  // 開始するのにAPIキーは不要です。より高いレート制限を利用するには追加してください:
  // apiKey: "fc-YOUR-API-KEY",
});

const result = await firecrawl.search("how do I configure retries", {
  categories: ["developer"],
  limit: 10,
});
for (const item of result.web ?? []) {
  console.log(item.url, item.title);
}

開発者向け結果には、web結果と同じ形式の url、title、description、position に加え、category: "developer" が含まれます。SDK ユーザーは result.web から取得します。このインターフェースでは、ランク付けされた開発者向け結果の形式ではなく、web結果の形式が返されます。一致した本文箇所とインデックスフィルタについては、開発者検索エンドポイントを使用してください。

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

はじめに

主要エンドポイント

その他

クイックスタート

開発者ガイド

webhook

ユースケース

その他

貢献

エンドポイント

Developer Index を検索する

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

​エンドポイント

​Developer Index を検索する

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

エンドポイント

Developer Index を検索する

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