Paper Search 学术论文检索
通过 OpenAlex 免费检索 2.5 亿多篇学术论文,无需 API 密钥,支持关键词搜索与 DOI 精确查询。
技能定位为只读学术检索,依赖 OpenAlex 免费公开 API,无需 API key,数据流清晰(curl+jq 查询并返回元数据),未见敏感数据收集或危险副作用;但脚本 search.sh/paper.sh 的源码未在本次证据中提供,实际实现的最小权限、错误处理与外部请求范围无法静态核实,且发布者身份未经注册表验证,故扣分。
SKILL.md 的调用路径、参数(limit/sort/page)与 README 示例一致,依赖 curl/jq 已在 README 声明,成功路径可信;但脚本本体未见,异常输入处理、网络失败的反馈消息不可核实,且通过 `find ~/.claude ... tail -1` 动态定位脚本属脆弱机制,多版本共存时可能选错路径,故静态评分不超过上限 10。
场景清晰(按关键词检索、按 DOI/ID 查详情、按引用/日期排序),触发描述明确,适用面广;但未声明能力边界与非适用范围(如仅限 OpenAlex 索引的文献、摘要可能缺失),且核心功能完全依赖海外服务 OpenAlex,中国大陆网络可达性存在不确定性但通常可用,故部分扣分。
文档结构清晰,含安装、依赖、用法示例与 API 说明,MIT 许可证完整;但无版本号、无 changelog、无已知限制披露(如 OpenAlex 限流、摘要覆盖不全仅有零散提示),维护责任与更新路径仅隐含于个人仓库,故扣分。
宣称功能对目标用户(需要快速检索文献并引用的研究者/写作者)边际价值明显——免费、免 key、含引用数与开放获取链接;但静态审查未执行任何脚本,输出格式的正确性与可直接使用性无法验证,脚本文件内容缺失使核心承诺仅停留在声明层面,故扣分。
有可审计的一手材料(SKILL.md、README、LICENSE)且与外部 OpenAlex 服务可交叉印证,但无测试套件、无 CI 执行证据、无真实运行输出样例,结论基本停留在文件自述,静态审查下不超过 5 分。
- search.sh 与 paper.sh 的脚本源码未包含在本次审查证据中,实际行为(请求范围、错误处理)未经验证,建议安装前人工审阅脚本内容。
- 技能完全依赖海外服务 OpenAlex,中国大陆网络可达性可能受网络环境影响;请自行测试连通性。
- 无版本号与更新日志,升级后行为可能变化;`find ... tail -1` 的脚本定位方式在多版本安装时可能指向错误版本。
- 摘要显示 N/A 时属 OpenAlex 数据覆盖限制,需按提示用 paper.sh 获取详情。
这个 Skill 能做什么,适合哪些场景?
paper-search 是一个 Claude Code 插件与技能,封装了 OpenAlex API 的 shell 脚本。它支持按关键词搜索论文、按 DOI 或 OpenAlex ID 查询单篇论文,并可按相关度、引用数或发表日期排序。返回结果包含标题、作者、引用数、摘要和开放获取链接。整个服务免费开放,不需要注册或 API 密钥。
技能正文指导模型先定位已安装的 scripts 目录,然后调用两个 bash 脚本:search.sh 接受关键词、每页结果数(默认10,最大200)、排序方式(relevance/cites/date)和页码,向 OpenAlex 发起请求并返回论文列表;paper.sh 接受 DOI URL 或 OpenAlex ID,返回单篇论文的完整详情,包括作者、摘要、概念标签、开放获取 PDF 链接和相关论文 ID。依赖 curl 和 jq,需要网络访问。
- 需要为论点寻找科学依据的写作者:先广撒网搜索,再挑最相关或引用最高的论文,最后用 paper.sh 获取完整摘要并按(作者,年份,期刊)格式引用
- 综述研究者:用 cites 排序快速找到某个主题的里程碑论文
- 拿到 DOI 需要快速了解论文内容的人:用 paper.sh 一步获取作者、摘要和开放获取 PDF 链接
- 追踪引文网络的研究者:把 paper.sh 返回的 related_works ID 再喂回 paper.sh,逐层探索引用图谱
- 需要最新文献的人:按 date 排序查看某主题最近的发表
这个 Skill 有哪些优点和局限?
- 完全免费,基于 OpenAlex 开放数据,无需 API 密钥或注册
- 覆盖 2.5 亿多篇学术文献,索引规模大
- 同时支持关键词搜索和 DOI/ID 精确查询,支持分页与三种排序
- 返回开放获取 PDF 链接,可直接获取全文
- MIT 许可,开源
- 纯 bash + curl + jq 实现,依赖极少,易于审计
- 依赖 curl 和 jq,缺失这两个工具时无法运行
- 数据仅来自 OpenAlex 单一来源,不覆盖其他学术数据库(如 Semantic Scholar、PubMed 专有功能)
- 搜索结果有时摘要显示为 N/A,需要额外调用 paper.sh 补全
- 源材料未提供测试套件、错误处理或速率限制方面的说明
如何安装这个 Skill?
在终端执行:
claude plugin marketplace add ykdojo/paper-search
claude plugin install paper-search@paper-search
安装后 paper-search 技能自动可用。需确保系统已安装 curl 和 jq。源材料未说明手动(非插件)安装的具体目录放置步骤,只提到技能支持通过手动方式安装并可在 ~/.claude 下被找到。
如何使用这个 Skill?
安装插件后,直接让 Claude Code 搜索论文即可,它会自动调用该技能。也可以手动运行脚本:
scripts/search.sh "mindfulness meditation stress reduction" 10 cites # 按引用数排序
scripts/search.sh "查询词" 10 relevance 2 # 第二页结果
scripts/paper.sh "https://doi.org/10.1073/pnas.0407162101" # 按 DOI 查询
scripts/paper.sh W2097529540 # 按 OpenAlex ID 查询