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

# Índice de research

> Busque artigos, leia trechos de artigos e encontre trabalhos relacionados

Firecrawl Research é um índice criado especificamente para agentes de research científica e de engenharia. Ele disponibiliza um conjunto de ferramentas voltado à research para buscar artigos, inspecionar metadados de artigos, ler trechos relevantes do texto completo e descobrir artigos relacionados por meio de expansão estrutural.

O índice abrange cerca de 43 milhões de resumos de artigos. A maior parte do corpus é de biomedicina e ciências da vida — **PubMed**, **bioRxiv** e **medRxiv** — junto com o **arXiv** para física, matemática e ciência da computação. Os artigos podem ser acessados pelos seus IDs de origem, portanto, referências `pmid:`, `pmcid:` e `doi:` funcionam da mesma forma que as referências `arxiv:`.

* Encontre artigos por tópico, método, benchmark, autor ou categoria
* Inspecione metadados canônicos de artigos e IDs de origem
* Leia os trechos de um artigo que respondem a uma pergunta específica
* Expanda a partir de artigos-semente sólidos para artigos relacionados, artigos citantes ou referências

<Note>
  Para dar ao seu agente acesso ao Índice de research, recomendamos fortemente usar nossa [CLI](/pt-BR/sdks/cli) ou [MCP](/pt-BR/mcp-server), em conjunto com nossa [**skill de research dedicada**](https://github.com/firecrawl/skills/blob/main/skills/firecrawl-research-index/SKILL.md), que você pode instalar com:

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

<div id="how-this-relates-to-search">
  ## Relação com o `/search`
</div>

O Firecrawl tem dois recursos chamados "research", mas eles não são o mesmo:

|                                  | Índice de research (esta página)                                                                                    | `/search` com `categories: ["research"]`                                                               |
| :------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| O que pesquisa                   | Um índice de artigos com \~43 milhões de resumos — PubMed, bioRxiv, medRxiv, arXiv                                  | A web aberta, restrita a \~14 **sites** acadêmicos (arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov, …) |
| O que retorna                    | Registros de artigos ranqueados: `paperId` canônico, `primaryId`, IDs de origem, título, resumo completo, pontuação | Resultados comuns da web: URL, título, snippet                                                         |
| Pode ler o conteúdo de um artigo | Sim — leitura em nível de passagem via `GET /search/research/papers/{id}`                                           | Não                                                                                                    |
| Pode expandir por citações       | Sim — `GET /search/research/papers/{id}/similar`                                                                    | Não                                                                                                    |
| Endpoint                         | `GET /search/research/papers`                                                                                       | `POST /search`                                                                                         |

Use o Índice de research para trabalhos de revisão de literatura: encontrar artigos, lê-los e acompanhar citações. Use [`categories: ["research"]`](/pt-BR/features/search#search-categories) quando quiser páginas comuns da web hospedadas em domínios acadêmicos.

<div id="endpoints">
  ## Endpoints
</div>

| Tarefa                               | Endpoint                                                                                            |
| ------------------------------------ | --------------------------------------------------------------------------------------------------- |
| Buscar artigos                       | [`GET /search/research/papers`](/pt-BR/api-reference/endpoint/research-search-papers)               |
| Inspecionar metadados ou ler trechos | [`GET /search/research/papers/{id}`](/pt-BR/api-reference/endpoint/research-paper)                  |
| Encontrar artigos relacionados       | [`GET /search/research/papers/{id}/similar`](/pt-BR/api-reference/endpoint/research-related-papers) |

<div id="search-papers">
  ## Buscar artigos
</div>

Pesquise resumos de artigos com uma consulta em linguagem natural. A resposta retorna artigos ranqueados com `paperId` canônico, `primaryId` preferencial, IDs de origem, título, resumo, pontuação e sinais opcionais de ranqueamento.

<CodeGroup>
  ```bash cURL theme={null}
  # Nenhuma chave de API é necessária para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa mais altos:
  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(
    # Nenhuma chave de API é necessária para começar; adicione uma para limites de taxa mais altos:
    # 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({
    // Nenhuma chave de API é necessária para começar; adicione uma para limites de taxa mais altos:
    // apiKey: "fc-YOUR-API-KEY",
  });

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

Filtros opcionais:

* `authors`: filtro por parte do nome do autor; todos os filtros devem corresponder
* `categories`: filtro por categoria do artigo, como `cs.LG`
* `from`: limite inferior inclusivo de criação/atualização, `YYYY-MM-DD`
* `to`: limite superior inclusivo de criação/atualização, `YYYY-MM-DD`

<div id="biomedical-example">
  ### Exemplo biomédico
</div>

A maior parte do índice é composta por publicações das ciências da vida, portanto queries de biologia clínica e molecular funcionam da mesma forma:

<CodeGroup>
  ```bash cURL theme={null}
  # Não é necessária uma chave de API para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa mais altos:
  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(
    # Não é necessária uma chave de API para começar; adicione uma para limites de taxa mais altos:
    # 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({
    // Não é necessária uma chave de API para começar; adicione uma para limites de taxa mais altos:
    // 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>

Os resultados incluem um `primaryId` no namespace usado pela fonte, portanto os resultados biomédicos são retornados como `pmid:<id>`, `pmcid:<id>` ou `doi:<doi>`. Passe esse valor diretamente para os endpoints de inspect, read e related abaixo.

<div id="inspect-a-paper">
  ## Inspecionar um artigo
</div>

Use um `paperId` canônico ou um `primaryId` específico da fonte. As formas aceitas de `primaryId` são `arxiv:<id>`, `pmid:<id>`, `pmcid:<id>` e `doi:<doi>` — por exemplo, `curl -s ".../v2/search/research/papers/pmid:<id>"` para um registro do PubMed.

<CodeGroup>
  ```bash cURL theme={null}
  # Não é necessária uma chave de API para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa maiores:
  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(
    # Não é necessária uma chave de API para começar; adicione uma para limites de taxa maiores:
    # 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({
    // Não é necessária uma chave de API para começar; adicione uma para limites de taxa maiores:
    // apiKey: "fc-YOUR-API-KEY",
  });

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

<div id="read-paper-passages">
  ## Ler trechos de artigos
</div>

Adicione `query` ao mesmo caminho do artigo para obter os principais trechos do texto completo para uma pergunta. Isso é útil para verificar se um artigo em potencial realmente contém um método, conjunto de dados, restrição ou resultado antes de incluí-lo.

<CodeGroup>
  ```bash cURL theme={null}
  # Nenhuma chave de API é necessária para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa mais altos:
  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(
    # Nenhuma chave de API é necessária para começar; adicione uma para limites de taxa mais altos:
    # 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({
    // Nenhuma chave de API é necessária para começar; adicione uma para limites de taxa mais altos:
    // 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">
  ## Encontre artigos relacionados
</div>

Expanda a partir de um ou mais artigos-semente por meio de expansão semântica e classifique os candidatos com base em uma `intent` em linguagem natural.

<CodeGroup>
  ```bash cURL theme={null}
  # Nenhuma chave de API é necessária para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa mais altos:
  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(
    # Nenhuma chave de API é necessária para começar; adicione uma para limites de taxa mais altos:
    # 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({
    // Nenhuma chave de API é necessária para começar; adicione uma para limites de taxa mais altos:
    // 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>

Modos:

* `similar`: vizinhança de cocitação e acoplamento bibliográfico
* `citers`: artigos que citam o artigo-semente
* `references`: artigos citados pelo artigo-semente

<div id="search-github-history">
  ## Pesquise o histórico do GitHub
</div>

Issues, pull requests mesclados e READMEs de repositórios agora estão disponíveis no [Índice para desenvolvedores](/pt-BR/features/developer), que os classifica com base nas passagens correspondentes e adiciona fontes de documentação selecionadas. Use [`GET` ou `POST /search/developer`](/pt-BR/api-reference/endpoint/developer-search) ou `/search` com `categories: ["developer"]`.