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

# Índice de research

> Busque artigos, leia trechos de artigos, encontre trabalhos relacionados e pesquise em repositórios relacionados no GitHub

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, descobrir artigos relacionados por meio de expansão estrutural e buscar em repositórios do GitHub relacionados à research.

* 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
* Busque no histórico e nos READMEs do GitHub notas de implementação, bugs e discussões de design

<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 className="firecrawl-cta-box">
  <div style={{ display: "flex", alignItems: "flex-start", gap: "8px", marginBottom: "8px" }}>
    <Icon icon="sack-dollar" color="#ff4d00" size={22} />

    <div className="firecrawl-cta-title" style={{ margin: 0 }}>
      <span style={{ color: "#ff4d00" }}>Recompensa: prêmio de 5.000 créditos</span>
      <span style={{ fontWeight: 400 }}> por um feedback consistente sobre /search/research (GitHub)</span>
    </div>
  </div>

  <p className="firecrawl-cta-description">
    Para se qualificar, participe de uma entrevista com alto valor informativo (casos de uso bem pensados, concretos etc.) com nosso Assistente de Feedback da Firecrawl. Leva só alguns minutos, pode ser interrompida a qualquer momento e funciona bem tanto para humanos quanto para agentes (basta colar o link no seu harness agentic!).
  </p>

  <a href={"https://www.firecrawl.dev/interview?study=20260629-fri-github-usage&src=" + (props.src || "docs-research")} className="firecrawl-cta-btn-primary firecrawl-cta-btn-inline">
    Iniciar a entrevista
  </a>

  <p className="firecrawl-cta-description" style={{ fontSize: "12px", fontStyle: "italic", margin: "12px 0 0 0" }}>
    Inclua seu e-mail para se qualificar. As entrevistas são avaliadas quanto à qualidade no fim de cada semana.
  </p>
</div>

<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) |
| Buscar no histórico do GitHub        | [`GET /search/research/github`](/pt-BR/api-reference/endpoint/research-github-search)               |

<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="inspect-a-paper">
  ## Inspecionar um artigo
</div>

Use um `paperId` canônico ou um `primaryId` específico da fonte.

<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">
  ## Buscar no histórico do GitHub
</div>

Busque em issues, pull requests, discussões e READMEs de repositórios no GitHub detalhes de implementação e soluções de engenharia já existentes.

<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/github?query=flash%20attention%20implementation%20notes&k=10"
  ```

  ```bash CLI theme={null}
  firecrawl research search-github "flash attention implementation notes" --limit 10
  ```

  ```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",
  )

  results = firecrawl.v2.search_github("flash attention implementation notes", k=10)
  print(results)
  ```

  ```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 results = await firecrawl.research.searchGithub(
    "flash attention implementation notes",
    { k: 10 },
  );
  console.log(results);
  ```
</CodeGroup>

Os resultados do GitHub incluem repositório, URL, metadados de issue/PR quando disponíveis, trecho e conteúdo em markdown correspondente quando disponível.