> ## 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.

# 研究索引

> 搜索论文、阅读论文片段、查找相关工作，并搜索相关的 GitHub 仓库

Firecrawl Research 是一个专为科学与工程研究代理构建的专用索引。它提供一套面向研究的工具集，用于搜索论文、查看论文元数据、阅读相关的全文片段、通过结构化扩展发现相关论文，以及搜索与研究相关的 GitHub 仓库。

* 按主题、方法、基准、作者或类别查找论文
* 查看标准论文元数据和来源 ID
* 阅读单篇论文中能够回答特定问题的片段
* 从高质量的种子论文扩展到相关论文、引用它们的论文或参考文献
* 搜索 GitHub 历史记录和 README，查找实现说明、缺陷和设计讨论

<Note>
  为了让你的代理能够访问研究索引，我们强烈建议结合使用我们的 [CLI](/zh/sdks/cli) 或 [MCP](/zh/mcp-server) 与 [**专用研究技能**](https://github.com/firecrawl/skills/blob/main/skills/firecrawl-research-index/SKILL.md)，可通过以下命令安装：

  ```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" }}>悬赏：5,000 额度奖励</span>
      <span style={{ fontWeight: 400 }}> 征集对 /search/research (GitHub) 的优质反馈</span>
    </div>
  </div>

  <p className="firecrawl-cta-description">
    如需获得资格，请通过我们的 Firecrawl Feedback Assistant 完成一次高质量访谈 (有深度、包含具体 use case 等) 。全程只需几分钟，可随时停止，也同时便于人和代理使用 (只需将链接粘贴到你的 agentic harness 中即可！) 。
  </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">
    开始访谈
  </a>

  <p className="firecrawl-cta-description" style={{ fontSize: "12px", fontStyle: "italic", margin: "12px 0 0 0" }}>
    请填写你的邮箱，才有资格参与。访谈质量会在每周末统一审核。
  </p>
</div>

<div id="endpoints">
  ## 端点
</div>

| 任务             | 端点                                                                                               |
| -------------- | ------------------------------------------------------------------------------------------------ |
| 搜索论文           | [`GET /search/research/papers`](/zh/api-reference/endpoint/research-search-papers)               |
| 查看元数据或阅读内容片段   | [`GET /search/research/papers/{id}`](/zh/api-reference/endpoint/research-paper)                  |
| 查找相关论文         | [`GET /search/research/papers/{id}/similar`](/zh/api-reference/endpoint/research-related-papers) |
| 搜索 GitHub 历史记录 | [`GET /search/research/github`](/zh/api-reference/endpoint/research-github-search)               |

<div id="search-papers">
  ## 搜索论文
</div>

使用自然语言查询来搜索论文摘要。响应会返回按相关性排序的论文，包含规范 `paperId`、首选 `primaryId`、来源 id、标题、摘要、评分，以及可选的排序信号。

<CodeGroup>
  ```bash cURL theme={null}
  # 无需 API 密钥即可开始；添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可获得更高的限流上限：
  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(
    # 无需 API 密钥即可开始；添加一个即可获得更高的限流上限：
    # 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({
    // 无需 API 密钥即可开始；添加一个即可获得更高的限流上限：
    // apiKey: "fc-YOUR-API-KEY",
  });

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

可选过滤条件：

* `authors`：按作者子字符串过滤；所有过滤条件都必须匹配
* `categories`：按论文类别过滤，例如 `cs.LG`
* `from`：created/updated 的包含下界，格式为 `YYYY-MM-DD`
* `to`：created/updated 的包含上界，格式为 `YYYY-MM-DD`

<div id="inspect-a-paper">
  ## 查看论文
</div>

使用标准 `paperId` 或来源特定的 `primaryId`。

<CodeGroup>
  ```bash cURL theme={null}
  # 开始使用无需 API 密钥；添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可获得更高的限流：
  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(
    # 开始使用无需 API 密钥；添加后可获得更高的限流：
    # 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({
    // 开始使用无需 API 密钥；添加后可获得更高的限流：
    // apiKey: "fc-YOUR-API-KEY",
  });

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

<div id="read-paper-passages">
  ## 读取论文片段
</div>

在同一个论文路径中添加 `query`，即可检索出与某个问题最相关的若干全文片段。这有助于你在纳入候选论文之前，先确认其中是否确实包含某种方法、数据集、约束条件或结果。

<CodeGroup>
  ```bash cURL theme={null}
  # 入门时无需 API 密钥；添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可提高限流上限：
  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(
    # 入门时无需 API 密钥；添加后可提高限流上限：
    # 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({
    // 入门时无需 API 密钥；添加后可提高限流上限：
    // 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">
  ## 查找相关论文
</div>

以一篇或多篇种子论文为起点，通过语义扩展发现更多论文，并根据自然语言 `intent` 对候选论文进行排序。

<CodeGroup>
  ```bash cURL theme={null}
  # 无需 API 密钥即可开始；如需更高限流，请添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY"：
  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(
    # 无需 API 密钥即可开始；如需更高限流，请添加一个：
    # 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({
    // 无需 API 密钥即可开始；如需更高限流，请添加一个：
    // 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>

模式：

* `similar`：共被引和书目耦合邻域中的论文
* `citers`：引用种子论文的论文
* `references`：种子论文引用的论文

<div id="search-github-history">
  ## 搜索 GitHub 历史记录
</div>

搜索 GitHub 上的 issue、PR、discussion 和仓库 README，查找实现细节和工程上的既有方案。

<CodeGroup>
  ```bash cURL theme={null}
  # 无需 API 密钥即可开始；添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可获得更高的限流上限：
  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(
    # 无需 API 密钥即可开始；添加一个可获得更高的限流上限：
    # 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({
    // 无需 API 密钥即可开始；添加一个可获得更高的限流上限：
    // apiKey: "fc-YOUR-API-KEY",
  });

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

GitHub 结果包含仓库、URL、issue/PR 元数据 (如有) 、摘要片段，以及匹配的 Markdown 内容 (如有) 。