UP
开放获取链接Unpaywall REST API v2Unpaywall
Unpaywall 是一个开放数据库,收录学术论文的合法开放获取版本,数据以 CC0 发布。在 ScholarMuse 中它嵌在 get_paper 里:论文记录有 DOI 但没有开放获取链接时,工具会向 Unpaywall 查询最佳的开放版本,并把链接补进结果。
对应的 ScholarMuse 工具:get_paper。每次成功调用都会扣积分。
可以这样问你的 agent
查 Kahneman 和 Tversky 1979 年的《Prospect Theory》论文详情,看看有没有合法的开放获取版本。
这个 DOI 的论文我在图书馆下不到,有开放获取的版本吗?是哪个版本?
把我阅读清单里的每个 DOI 都查一下,有开放获取链接的给我链接。
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 Unpaywall 的数据字段。
get_paper
只有当论文有 DOI、首个来源没给出开放获取链接、且 Unpaywall 找到开放版本时才会补充。来自 Unpaywall 的只有这四个字段。
- openAccess
- Unpaywall 找到开放版本时设为 true
- openAccessUrl
- 最佳开放版本的 PDF 链接,没有则为页面链接
- openAccessVersion
- publishedVersion、acceptedVersion 或 submittedVersion
- openAccessSource
- 链接来自 Unpaywall 时为 unpaywall
覆盖范围
- Unpaywall 已知的、带 DOI 文献的开放获取位置。
- 采用 Unpaywall 给出的最佳位置,可能在出版商网站,也可能在机构或学科仓储。
限制
- 没有单独的 Unpaywall 工具,它只在 get_paper 内部运行,每次一个 DOI。
- 首个来源已经给出开放获取链接时会跳过 Unpaywall;没有 DOI 也无法查询。
- 只返回最佳版本的链接和版本类型,不返回 OA 状态(金色、绿色等)、托管类型、许可和其他位置。
- Unpaywall 请求失败时,get_paper 照常返回论文但不带链接,也不会提示这次失败。
ScholarMuse 怎么访问 Unpaywall
连接器直接请求 api.unpaywall.org/v2/<DOI>。Unpaywall 没有 API key,请求中附带联系邮箱,这是它的 API 要求的。
响应最多缓存 7 天,所以本周刚开放的版本可能要过这么久才能查到。
API key:上游 API 不用 key 也能调用,你不用申请。
许可与署名
许可:CC0-1.0
Open-access locations from Unpaywall (unpaywall.org), CC0.
get_paper 返回的记录沿用提供论文信息的那个数据源的许可和署名,Unpaywall 只在 openAccessSource 字段里标明。 在论文里引用时,请按 Unpaywall 自己的引用要求来写。
用到 Unpaywall 的功能
常见问题
ScholarMuse 不是 Unpaywall 的官方产品。它是一个面向学术数据的 MCP server,其中的 get_paper 工具会查询 Unpaywall。agent 连上 ScholarMuse 后就能用 Unpaywall,不用再单独装一个 server。
不需要。Unpaywall 的 API 不用 key 也能调用,ScholarMuse 也不会向你要 key。登录一次 ScholarMuse,agent 就能调用工具。
连接器直接请求 api.unpaywall.org/v2/<DOI>。Unpaywall 没有 API key,请求中附带联系邮箱,这是它的 API 要求的。响应最多缓存 7 天,所以本周刚开放的版本可能要过这么久才能查到。
许可:CC0-1.0。署名:Open-access locations from Unpaywall (unpaywall.org), CC0. get_paper 返回的记录沿用提供论文信息的那个数据源的许可和署名,Unpaywall 只在 openAccessSource 字段里标明。
需要。每次成功调用 get_paper 都会扣积分,调用失败不扣。当前价格:论文检索,1 积分 / 次。
