Index Developer

Firecrawl Developer est un index conçu pour les agents de codage. Il couvre les tickets, les pull requests fusionnées et les README de dépôts de code publics, ainsi que des sites de documentation sélectionnés, afin qu’un agent puisse répondre, à partir de sources primaires plutôt que d’une page web générale, à une question sur le comportement du code, une bibliothèque ou un framework, un contrat d’API, un message d’erreur ou un bug connu.

Trouvez le ticket ou la pull request dans lequel un bug a été signalé et corrigé
Lisez les passages d’un README ou d’une page de documentation qui répondent à une question précise
Remontez d’un contrat d’API à la pull request qui l’a modifié
Retrouvez la discussion à l’origine d’un message d’erreur

Nous vous recommandons vivement d’utiliser notre CLI ou MCP, associés à notre skill Developer dédiée, que vous pouvez installer avec :

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

Points de terminaison

Tâche	Point de terminaison
Rechercher dans l’Index Developer	`GET` ou `POST /search/developer`
Ajouter des résultats pour développeurs à une recherche web	`POST /search` avec `categories: ["developer"]`

Rechercher dans l’Index Developer

Envoyez une question en langage naturel et obtenez des résultats pour développeurs classés, avec les passages correspondants. Utilisez ce point de terminaison lorsque vous souhaitez uniquement des sources destinées aux développeurs, avec les filtres disponibles pour le type de résultat, le dépôt et la source de documentation. Une recherche pour développeur coûte 2 crédits par tranche de 10 résultats, arrondie à l’unité supérieure (1 à 10 résultats = 2 crédits, 11 à 20 = 4 crédits, et ainsi de suite). Aucune clé API n’est nécessaire pour démarrer ; ajoutez-en une pour bénéficier de limites de débit plus élevées.

# Aucune clé API n’est nécessaire pour démarrer ; ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour bénéficier de limites de débit plus élevées :
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 est également disponible sur le même point de terminaison et constitue la solution la plus simple pour transmettre des filtres de tableaux au format JSON :

cURL

# Aucune clé API n’est nécessaire pour démarrer ; ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour bénéficier de limites de débit plus élevées :
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"]
  }'

Chaque résultat comporte un id stable tel que issue:owner/repo#123, une url et ses passages correspondants au format Markdown, afin de préserver les tableaux et les blocs de code. Le type d’artefact est encodé dans le préfixe de l’id : doc:, issue:, pull_request: ou readme:. Le champ title est souvent absent des résultats doc lorsque la page source ne comporte aucun titre exploitable. Utilisez donc url comme solution de repli plutôt que de supposer que ce champ est présent. Lorsque vous définissez le périmètre d’une recherche avec sources ou repos, la réponse les renvoie avec un indicateur indexed pour chaque entrée, afin que vous puissiez distinguer un identifiant absent de l’index d’une requête qui n’a tout simplement rien trouvé. Consultez la référence de la recherche pour développeur pour connaître le format de ce renvoi. Les filtres facultatifs permettent d’affiner la recherche :

k définit le nombre de résultats renvoyés, 10 par défaut, et passages le nombre de passages correspondants inclus dans chacun
types sélectionne les types à rechercher parmi doc, issue, pull_request et readme
repos définit le périmètre de la partie dépôt de l’index, et sources celui de la partie documentation
skills défini sur only limite la recherche aux fichiers de skills d’agent indexés
language, topic, license, min_stars, max_stars, archived et fork filtrent selon les attributs du dépôt, tels que language=Rust, topic=async ou license=MIT

Ces sept filtres décrivent un dépôt de code. En envoyer un sans définir le périmètre sources ne renvoie donc aucun résultat doc. Consultez comment les filtres de dépôt définissent le périmètre d’une recherche avant d’en envoyer un. Consultez la référence de la recherche pour développeur pour connaître le type et les limites de chaque filtre, la manière dont repos et sources définissent le périmètre d’une recherche, ainsi que le schéma de réponse complet.

Les SDK Python et Node accèdent à l’Index Developer via la catégorie developer présentée ci-dessous. Ils n’exposent pas de méthode dédiée pour ce point de terminaison ; appelez-le donc via HTTP, avec la CLI ou via MCP.

Ajouter des résultats pour développeur à une recherche web

Passez developer comme seule entrée du tableau categories de /search. La réponse renvoie les résultats pour développeur dans le groupe standard web, chacun étant associé à category: "developer". La catégorie developer ne peut pas être combinée avec d’autres catégories. Aucune clé API n’est nécessaire pour commencer : /search accepte les requêtes sans clé, y compris la catégorie developer, dans la limite du quota sans clé. Utilisez une clé pour bénéficier de limites de débit plus élevées.

# Aucune clé API n’est nécessaire pour commencer ; ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour bénéficier de limites de débit plus élevées :
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({
  // Aucune clé API n’est nécessaire pour commencer ; ajoutez-en une pour bénéficier de limites de débit plus élevées :
  // 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);
}

Les résultats pour développeur contiennent url, title, description et position. Ils ont la même structure qu’un résultat web, avec en plus category: "developer". Les utilisateurs du SDK y accèdent avec result.web. Cette interface renvoie la structure des résultats web, et non celle des résultats pour développeur classés. Pour les passages correspondants et les filtres d’index, utilisez le point de terminaison de recherche pour développeurs.

Le serveur MCP hébergé expose les deux interfaces, et aucune n’écrit quoi que ce soit. Consultez les outils MCP pour firecrawl_developer_search, pour les résultats pour développeur via firecrawl_search, et pour savoir laquelle des deux est disponible via l’ensemble d’outils sans clé.

Prise en main

Points de terminaison de base

Plus

Démarrages rapides

Guides développeur

Webhooks

Cas d'utilisation

Autres

Contribuer

Points de terminaison

Rechercher dans l’Index Developer

Ajouter des résultats pour développeur à une recherche web

​Points de terminaison

​Rechercher dans l’Index Developer

​Ajouter des résultats pour développeur à une recherche web

Points de terminaison

Rechercher dans l’Index Developer

Ajouter des résultats pour développeur à une recherche web