FetchPaper API

获取学术论文与作者数据。

0 概览

• Base URL：https://fetchpaper.com
• 鉴权：/graph/v1/ 与 /mcp 下每个请求都要带请求头 x-api-key（区分大小写），或Authorization: Bearer <密钥>；缺失或写错回 401 {"error": "Invalid or missing API key"}。GET /、/docs/*、/guide.md、GET /health 不需要密钥。
• MCP 接入：agent 也可以用 MCP 方式直接调用 POST /mcp（Streamable HTTP，鉴权同上），客户端配置与工具列表见 §4（/docs/4）。
• 论文的两种 id：
• paperId —— string —— 本 API 中标识论文的主要方式，40 位 sha。
• corpusId —— int64 —— 数据集指代论文时使用的 id。
• 参数：重复的标量键取第一个，重复的列表键合并；不认识的键忽略。
• 错误：400 表示这条查询按不动（参数写错、值越界、查询宽到算不完），换写法重试有意义；500 表示数据目录不对（某层没建/半截/各层不是同一次构建），error 点名缺哪层和重建命令（如 {"error": "作者表缺失或不完整，运行 python build_authors.py 重建"}），调用代码不用改。响应一律 application/json; charset=utf-8。

1 Paper Data

2 Author Data

• 3 Response Schema
• 4 MCP 端点 POST /mcp