> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-docs-agent-add-spark-2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Index de recherche

> Recherchez des articles, lisez des passages d'articles et trouvez des travaux connexes

Firecrawl Research est un index spécialement conçu pour les agents de recherche scientifique et d'ingénierie. Il propose un ensemble d'outils dédié à la recherche pour chercher des articles, examiner les métadonnées des articles, lire les passages pertinents du texte intégral et découvrir des articles connexes grâce à l'expansion structurelle.

L'index couvre environ 43 millions de résumés d'articles. La majorité du corpus concerne les sciences biomédicales et de la vie — **PubMed**, **bioRxiv** et **medRxiv** — ainsi que **arXiv** pour la physique, les mathématiques et l'informatique. Les articles sont accessibles par leurs identifiants de source, ainsi les références `pmid:`, `pmcid:` et `doi:` fonctionnent de la même manière que celles avec `arxiv:`.

* Trouvez des articles par sujet, méthode, benchmark, auteur ou catégorie
* Examinez les métadonnées canoniques des articles et les identifiants de source
* Lisez, dans un article, les passages qui répondent à une question précise
* À partir d'articles de départ pertinents, élargissez vers des articles connexes, des articles citants ou des références

<Note>
  Pour donner à votre agent accès à l'Index de recherche, nous vous recommandons vivement d'utiliser notre [CLI](/fr/sdks/cli) ou [MCP](/fr/mcp-server), associé à notre [**skill de recherche dédié**](https://github.com/firecrawl/skills/blob/main/skills/firecrawl-research-index/SKILL.md), que vous pouvez installer avec :

  ```bash theme={null}
  npx skills add firecrawl/skills@firecrawl-research-index
  ```
</Note>

<div id="how-this-relates-to-search">
  ## Comparaison avec `/search`
</div>

Firecrawl propose deux fonctionnalités appelées « research », mais il ne s’agit pas de la même fonctionnalité :

|                                              | index de recherche (cette page)                                                                                          | `/search` avec `categories: ["research"]`                                                                           |
| :------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| Ce qui est recherché                         | Un index de publications contenant environ 43 M de résumés — PubMed, bioRxiv, medRxiv, arXiv                             | Le Web ouvert, restreint à environ 14 **sites web** académiques (arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov, …) |
| Ce que vous obtenez                          | Fiches de publications classées : `paperId` canonique, `primaryId`, identifiants de source, titre, résumé complet, score | Résultats Web classiques : URL, titre, snippet                                                                      |
| Peut-il lire le contenu d’une publication ?  | Oui — lecture au niveau des passages via `GET /search/research/papers/{id}`                                              | Non                                                                                                                 |
| Peut-il étendre la recherche par citations ? | Oui — `GET /search/research/papers/{id}/similar`                                                                         | Non                                                                                                                 |
| Point de terminaison                         | `GET /search/research/papers`                                                                                            | `POST /search`                                                                                                      |

Utilisez l’index de recherche pour vos recherches bibliographiques : trouver des publications, les lire et suivre les citations. Utilisez [`categories: ["research"]`](/fr/features/search#search-categories) si vous recherchez des pages Web classiques hébergées sur des domaines académiques.

<div id="endpoints">
  ## Points de terminaison
</div>

| Tâche                                          | Point de terminaison                                                                             |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Rechercher des articles scientifiques          | [`GET /search/research/papers`](/fr/api-reference/endpoint/research-search-papers)               |
| Consulter les métadonnées ou lire des passages | [`GET /search/research/papers/{id}`](/fr/api-reference/endpoint/research-paper)                  |
| Trouver des articles connexes                  | [`GET /search/research/papers/{id}/similar`](/fr/api-reference/endpoint/research-related-papers) |

<div id="search-papers">
  ## Rechercher des articles scientifiques
</div>

Recherchez dans les résumés d’articles scientifiques à l’aide d’une requête en langage naturel. La réponse renvoie des articles classés, avec le `paperId` canonique, le `primaryId` privilégié, les identifiants de source, le titre, le résumé, le score et, éventuellement, des signaux de classement.

<CodeGroup>
  ```bash cURL theme={null}
  # 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/research/papers?query=diffusion%20image%20synthesis&k=20"
  ```

  ```bash CLI theme={null}
  firecrawl research search-papers "diffusion image synthesis" --limit 20
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # 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 :
    # api_key="fc-YOUR-API-KEY",
  )

  result = firecrawl.v2.search_papers("diffusion image synthesis", k=20)
  print(result)
  ```

  ```js Node theme={null}
  import { Firecrawl } from "firecrawl";

  const firecrawl = new Firecrawl({
    // 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 :
    // apiKey: "fc-YOUR-API-KEY",
  });

  const result = await firecrawl.research.searchPapers("diffusion image synthesis", {
    k: 20,
  });
  console.log(result);
  ```
</CodeGroup>

Filtres facultatifs :

* `authors` : filtre sur une sous-chaîne du nom de l’auteur ; tous les filtres doivent correspondre
* `categories` : filtre par catégorie d’article, par exemple `cs.LG`
* `from` : borne inférieure inclusive de création/mise à jour, `YYYY-MM-DD`
* `to` : borne supérieure inclusive de création/mise à jour, `YYYY-MM-DD`

<div id="biomedical-example">
  ### Exemple biomédical
</div>

La majeure partie de l’index porte sur les sciences de la vie. Les requêtes cliniques et de biologie moléculaire fonctionnent donc de la même manière :

<CodeGroup>
  ```bash cURL theme={null}
  # 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/research/papers?query=CRISPR%20base%20editing%20off-target%20effects%20in%20primary%20human%20T%20cells&k=20"
  ```

  ```bash CLI theme={null}
  firecrawl research search-papers "CRISPR base editing off-target effects in primary human T cells" --limit 20
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # 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 :
    # api_key="fc-YOUR-API-KEY",
  )

  result = firecrawl.v2.search_papers(
    "CRISPR base editing off-target effects in primary human T cells",
    k=20,
  )
  print(result)
  ```

  ```js Node theme={null}
  import { Firecrawl } from "firecrawl";

  const firecrawl = new Firecrawl({
    // 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 :
    // apiKey: "fc-YOUR-API-KEY",
  });

  const result = await firecrawl.research.searchPapers(
    "CRISPR base editing off-target effects in primary human T cells",
    { k: 20 },
  );
  console.log(result);
  ```
</CodeGroup>

Les résultats incluent un `primaryId` dans l’espace de noms utilisé par la source : les résultats biomédicaux sont donc renvoyés sous la forme `pmid:<id>`, `pmcid:<id>` ou `doi:<doi>`. Transmettez directement cette valeur aux points de terminaison d’inspection, de lecture et de contenus associés ci-dessous.

<div id="inspect-a-paper">
  ## Examiner un article
</div>

Utilisez un `paperId` canonique ou un `primaryId` propre à la source. Les formats de `primaryId` acceptés sont `arxiv:<id>`, `pmid:<id>`, `pmcid:<id>` et `doi:<doi>` — par exemple, `curl -s ".../v2/search/research/papers/pmid:<id>"` pour un enregistrement PubMed.

<CodeGroup>
  ```bash cURL theme={null}
  # 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/research/papers/arxiv:1706.03762"
  ```

  ```bash CLI theme={null}
  firecrawl research inspect-paper arxiv:1706.03762
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # 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 :
    # api_key="fc-YOUR-API-KEY",
  )

  paper = firecrawl.v2.inspect_paper("arxiv:1706.03762")
  print(paper)
  ```

  ```js Node theme={null}
  import { Firecrawl } from "firecrawl";

  const firecrawl = new Firecrawl({
    // 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 :
    // apiKey: "fc-YOUR-API-KEY",
  });

  const paper = await firecrawl.research.getPaper("arxiv:1706.03762");
  console.log(paper);
  ```
</CodeGroup>

<div id="read-paper-passages">
  ## Lire des passages d’articles
</div>

Ajoutez `query` au même chemin d’article pour obtenir les passages les plus pertinents du texte intégral pour une question. C’est utile pour vérifier si un article candidat contient bien une méthode, un jeu de données, une contrainte ou un résultat avant de l’inclure.

<CodeGroup>
  ```bash cURL theme={null}
  # Aucune clé API n’est nécessaire pour démarrer ; ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées :
  curl -s "https://api.firecrawl.dev/v2/search/research/papers/arxiv:1706.03762?query=what%20is%20the%20attention%20mechanism&k=4"
  ```

  ```bash CLI theme={null}
  firecrawl research read-paper arxiv:1706.03762 --question "What is the attention mechanism?" --limit 4
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # Aucune clé API n’est nécessaire pour démarrer ; ajoutez-en une pour des limites de débit plus élevées :
    # api_key="fc-YOUR-API-KEY",
  )

  passages = firecrawl.v2.read_paper(
      "arxiv:1706.03762",
      "What is the attention mechanism?",
      k=4,
  )
  print(passages)
  ```

  ```js Node theme={null}
  import { Firecrawl } from "firecrawl";

  const firecrawl = new Firecrawl({
    // Aucune clé API n’est nécessaire pour démarrer ; ajoutez-en une pour des limites de débit plus élevées :
    // apiKey: "fc-YOUR-API-KEY",
  });

  const passages = await firecrawl.research.getPaper("arxiv:1706.03762", {
    query: "What is the attention mechanism?",
    k: 4,
  });
  console.log(passages);
  ```
</CodeGroup>

<div id="find-related-papers">
  ## Trouver des articles connexes
</div>

À partir d’un ou de plusieurs articles de départ, effectuez une expansion sémantique et classez les candidats en fonction d’une `intent` en langage naturel.

<CodeGroup>
  ```bash cURL theme={null}
  # Aucune clé API n’est nécessaire pour démarrer ; ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées :
  curl -s "https://api.firecrawl.dev/v2/search/research/papers/arxiv:1706.03762/similar?intent=efficient%20transformers&mode=similar&k=20"
  ```

  ```bash CLI theme={null}
  firecrawl research related-papers arxiv:1706.03762 --intent "efficient transformers" --limit 20
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # Aucune clé API n’est nécessaire pour démarrer ; ajoutez-en une pour des limites de débit plus élevées :
    # api_key="fc-YOUR-API-KEY",
  )

  papers = firecrawl.v2.related_papers(
      "arxiv:1706.03762",
      "efficient transformers",
      mode="similar",
      k=20,
  )
  print(papers)
  ```

  ```js Node theme={null}
  import { Firecrawl } from "firecrawl";

  const firecrawl = new Firecrawl({
    // Aucune clé API n’est nécessaire pour démarrer ; ajoutez-en une pour des limites de débit plus élevées :
    // apiKey: "fc-YOUR-API-KEY",
  });

  const papers = await firecrawl.research.similarPapers("arxiv:1706.03762", {
    intent: "efficient transformers",
    mode: "similar",
    k: 20,
  });
  console.log(papers);
  ```
</CodeGroup>

Modes :

* `similar` : voisinage de co-citation et de couplage bibliographique
* `citers` : articles qui citent l’article de départ
* `references` : articles cités par l’article de départ

<div id="search-github-history">
  ## Rechercher dans l’historique GitHub
</div>

Les tickets, les pull requests fusionnées et les README des dépôts sont désormais inclus dans le [Developer Index](/fr/features/developer), qui les classe avec les passages correspondants et y ajoute des sources de documentation sélectionnées. Utilisez [`GET` ou `POST /search/developer`](/fr/api-reference/endpoint/developer-search), ou `/search` avec `categories: ["developer"]`.