研究索引

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

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

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

为了让你的代理能够访问研究索引，我们强烈建议结合使用我们的 CLI 或 MCP 与 专用研究技能，可通过以下命令安装：

npx skills add firecrawl/skills@firecrawl-research-index

​

端点

任务	端点
搜索论文	GET /search/research/papers
查看元数据或阅读内容片段	GET /search/research/papers/{id}
查找相关论文	GET /search/research/papers/{id}/similar
搜索 GitHub 历史记录	GET /search/research/github

​

搜索论文

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

cURL

# 无需 API 密钥即可开始；添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可获得更高的限流上限：
curl -s "https://api.firecrawl.dev/v2/search/research/papers?query=diffusion%20image%20synthesis&k=20"

firecrawl research search-papers "diffusion image synthesis" --limit 20

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)

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);

可选过滤条件：

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

​

查看论文

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

cURL

# 开始使用无需 API 密钥；添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可获得更高的限流：
curl -s "https://api.firecrawl.dev/v2/search/research/papers/arxiv:1706.03762"

firecrawl research inspect-paper arxiv:1706.03762

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # 开始使用无需 API 密钥；添加后可获得更高的限流：
  # api_key="fc-YOUR-API-KEY",
)

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

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);

​

读取论文片段

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

cURL

# 入门时无需 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"

firecrawl research read-paper arxiv:1706.03762 --question "What is the attention mechanism?" --limit 4

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)

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);

​

查找相关论文

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

cURL

# 无需 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"

firecrawl research related-papers arxiv:1706.03762 --intent "efficient transformers" --limit 20

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)

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);

模式：

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

​

搜索 GitHub 历史记录

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

cURL

# 无需 API 密钥即可开始；添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可获得更高的限流上限：
curl -s "https://api.firecrawl.dev/v2/search/research/github?query=flash%20attention%20implementation%20notes&k=10"

firecrawl research search-github "flash attention implementation notes" --limit 10

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)

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);

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