> ## 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 investigación

> Busca artículos, lee pasajes de artículos, encuentra trabajos relacionados y busca en repositorios de GitHub relacionados

Firecrawl Research es un índice diseñado específicamente para agentes de investigación científica y de ingeniería. Ofrece un conjunto de herramientas orientado a la investigación para buscar artículos, inspeccionar sus metadatos, leer pasajes relevantes del texto completo, descubrir artículos relacionados mediante expansión estructural y buscar en repositorios de GitHub vinculados a la investigación.

* Encuentra artículos por tema, método, benchmark, autor o categoría
* Inspecciona metadatos canónicos de los artículos e IDs de origen
* Lee los pasajes de un artículo que responden a una pregunta específica
* Amplía a partir de artículos semilla sólidos hacia artículos relacionados, citas o referencias
* Busca en el historial de GitHub y en los README notas de implementación, errores y debates de diseño

<Note>
  Para darle a tu agente acceso al Índice de investigación, te recomendamos encarecidamente utilizar nuestro [CLI](/es/sdks/cli) o [MCP](/es/mcp-server), junto con nuestra [**skill de investigación dedicada**](https://github.com/firecrawl/skills/blob/main/skills/firecrawl-research-index/SKILL.md), que puedes instalar con:

  ```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: 5.000 créditos</span>
      <span style={{ fontWeight: 400 }}> por comentarios valiosos sobre /search/research (GitHub)</span>
    </div>
  </div>

  <p className="firecrawl-cta-description">
    Para optar, completa una entrevista de alta calidad (casos de uso bien pensados, concretos, etc.) con nuestro Asistente de Feedback de Firecrawl. Solo lleva unos minutos, puedes detenerla en cualquier momento y funciona bien tanto para personas como para agentes (¡solo pega el enlace en tu harness agéntico!).
  </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">
    Comenzar la entrevista
  </a>

  <p className="firecrawl-cta-description" style={{ fontSize: "12px", fontStyle: "italic", margin: "12px 0 0 0" }}>
    Incluye tu correo electrónico para poder optar. Las entrevistas se revisan por calidad al final de cada semana.
  </p>
</div>

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

| Tarea                              | Endpoint                                                                                         |
| ---------------------------------- | ------------------------------------------------------------------------------------------------ |
| Buscar artículos                   | [`GET /search/research/papers`](/es/api-reference/endpoint/research-search-papers)               |
| Consultar metadatos o leer pasajes | [`GET /search/research/papers/{id}`](/es/api-reference/endpoint/research-paper)                  |
| Buscar artículos relacionados      | [`GET /search/research/papers/{id}/similar`](/es/api-reference/endpoint/research-related-papers) |
| Buscar en el historial de GitHub   | [`GET /search/research/github`](/es/api-reference/endpoint/research-github-search)               |

<div id="search-papers">
  ## Buscar artículos
</div>

Busca resúmenes de artículos con una consulta en lenguaje natural. La respuesta incluye artículos ordenados por relevancia con `paperId` canónico, `primaryId` preferido, IDs de origen, título, resumen, puntuación y señales de ranking opcionales.

<CodeGroup>
  ```bash cURL theme={null}
  # No se necesita una clave de API para empezar; agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más 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(
    # No se necesita una clave de API para empezar; agrega una para límites de tasa más 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({
    // No se necesita una clave de API para empezar; agrega una para límites de tasa más altos:
    // apiKey: "fc-YOUR-API-KEY",
  });

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

Filtros opcionales:

* `authors`: filtro por coincidencia parcial del autor; todos los filtros deben cumplirse
* `categories`: filtro por categoría del artículo, como `cs.LG`
* `from`: límite inferior inclusivo de creación/actualización, `YYYY-MM-DD`
* `to`: límite superior inclusivo de creación/actualización, `YYYY-MM-DD`

<div id="inspect-a-paper">
  ## Inspeccionar un artículo científico
</div>

Usa un `paperId` canónico o un `primaryId` específico de la fuente.

<CodeGroup>
  ```bash cURL theme={null}
  # No se necesita una clave de API para empezar; agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para obtener límites de tasa superiores:
  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(
    # No se necesita una clave de API para empezar; agrega una para obtener límites de tasa superiores:
    # 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({
    // No se necesita una clave de API para empezar; agrega una para obtener límites de tasa superiores:
    // apiKey: "fc-YOUR-API-KEY",
  });

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

<div id="read-paper-passages">
  ## Leer pasajes del artículo
</div>

Agrega `query` a la misma ruta del artículo para recuperar los pasajes más relevantes del texto completo para una pregunta. Esto es útil para verificar si un artículo candidato realmente contiene un método, un conjunto de datos, una restricción o un resultado antes de incluirlo.

<CodeGroup>
  ```bash cURL theme={null}
  # No se necesita una clave de API para empezar; agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más 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(
    # No se necesita una clave de API para empezar; agrega una para límites de tasa más 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({
    // No se necesita una clave de API para empezar; agrega una para límites de tasa más 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">
  ## Encontrar artículos relacionados
</div>

Parte de uno o más artículos semilla mediante expansión semántica y clasifica los candidatos según una `intent` expresada en lenguaje natural.

<CodeGroup>
  ```bash cURL theme={null}
  # No se necesita una clave de API para empezar; agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para obtener límites de tasa más 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(
    # No se necesita una clave de API para empezar; agrega una para obtener límites de tasa más 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({
    // No se necesita una clave de API para empezar; agrega una para obtener límites de tasa más 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`: vecindario de cocitación y acoplamiento bibliográfico
* `citers`: artículos que citan el artículo semilla
* `references`: artículos citados por el artículo semilla

<div id="search-github-history">
  ## Buscar en el historial de GitHub
</div>

Busca en issues, pull requests, debates y README de repositorios de GitHub para encontrar detalles de implementación y antecedentes técnicos.

<CodeGroup>
  ```bash cURL theme={null}
  # No se necesita una clave de API para comenzar; agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para obtener límites de tasa más 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(
    # No se necesita una clave de API para comenzar; agrega una para obtener límites de tasa más 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({
    // No se necesita una clave de API para comenzar; agrega una para obtener límites de tasa más altos:
    // apiKey: "fc-YOUR-API-KEY",
  });

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

Los resultados de GitHub incluyen el repositorio, la URL, metadatos de issues/PR cuando están disponibles, un fragmento y el contenido markdown coincidente cuando está disponible.