[开源] Paper Search CLI：面向 Agent 的 Skill + CLI 学术文献工具

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

Paper Search CLI

一个面向 AI Agent、终端用户和脚本的 Skill + CLI 学术文献工具。

为什么做这个

之前一直在用 paper-search-mcp 论文检索 MCP。功能本身很完整，在没有接触到cc-switch之前，在多个Ai中切换过程后的MCP都需要单独配置，维护起来比较麻烦。

前几天刷到站内佬友的建议（https://linux.do/t/topic/2076559）， 未来的主流可能会逐渐转变为CLI + Skill，所以我将原来佬友的项目，加上参考原始作者的来源项目，重新Vibe成了Cli + Skill：

文献检索功能来源主要参考这个项目：

核心特性

• 
  

  多来源学术检索 + 期刊指标：覆盖 Crossref、OpenAlex、PubMed、PMC、Europe PMC、arXiv、bioRxiv、medRxiv、Semantic Scholar、CORE、OpenAIRE、DBLP、ACM Digital Library 元数据、USENIX 元数据、OpenReview、Web of Science、Google Scholar、IACR ePrint、Sci-Hub、IEEE Xplore、ScienceDirect、Springer Nature / SpringerLink、Wiley、Scopus、Unpaywall，并支持 EasyScholar 期刊指标。

  
  


• 
  

  四个主要工作流：文献元数据检索、期刊指标检索、PDF 获取和下载、正文片段检索分开处理。

  
  


• 
  

  单一命令入口：安装后通过 paper-search 调用，适合终端、脚本和 agent。

  
  


• 
  

  漏斗式回退下载链：download_with_fallback 会优先尝试原生下载、PDF URL、PMC / Europe PMC / CORE / OpenAIRE、Unpaywall DOI 解析，最后使用 Sci-Hub 兜底；只有显式传入 useSciHub=false 才会关闭 Sci-Hub 兜底。

  
  


• 
  

  适合 agent 调用：doctor、smoke、skills、config、tools 负责健康检查、Skill 同步、配置可见性和工具 schema；search、journal-metrics、download、run 负责实际学术任务。

  
  

Paper Search CLI 目前重构并拆成下面四个能力：

技术路线

这个项目走的是 CLI + Skill 路线。

Skill 负责告诉 agent：什么时候该用 paper-search、该选哪个平台、什么时候查 DOI、什么时候查正文片段、什么时候下载 PDF。

CLI 负责真正执行：文献元数据检索、去重、期刊指标检索、PDF 获取和下载、健康检查、输出 JSON。

项目的调用框架如下：

flowchart LR

    A["用户问题 / agent 任务"] --> B["paper-search Skill"]

    B --> C["Capability Profile"]

    C --> D["metadata_search 文献元数据检索"]

    C --> E["journal_metrics 期刊指标检索"]

    C --> F["download PDF获取和下载"]

    C --> G["search_semantic_snippets 正文片段检索"]

    C --> H["Management Layer 管理命令"]

    D --> I["Crossref / OpenAlex / PubMed / arXiv / Semantic Scholar 等"]

    E --> J["EasyScholar"]

    F --> K["原生来源 / OA 来源 / 权限来源 / Sci-Hub final fallback"]

    G --> L["Semantic Scholar OA snippets"]

    H --> M["doctor / smoke / skills / config / tools"]

    I --> N["统一 JSON 输出"]

    J --> N

    K --> N

    L --> N

    M --> N

    N --> O["agent / 脚本 / 终端继续处理"]

支持平台

下面把完整能力矩阵按类型拆成小表，判断各平台的功能和是否需要配API key。

综合检索

平台	搜索	下载	全文	被引统计	API Key	特色功能
Crossref						默认搜索平台，广泛元数据覆盖
OpenAlex		^-^ 条件支持				广泛免费元数据；记录含开放链接时可用于回退下载
Semantic Scholar			^-^ 正文片段		^-^ 可选*	AI 语义检索 + OA 正文片段
Google Scholar						广泛学术发现，基于页面解析

期刊指标

平台	搜索	下载	全文	被引统计	API Key	特色功能
EasyScholar	^-^ 论文关键词搜索				^-^ 必需	影响因子、JCR/SSCI 分区、中科院分区、JCI、ESI、预警等

医学/生命科学

平台	搜索	下载	全文	被引统计	API Key	特色功能
PubMed					^-^ 可选	NCBI E-utilities 生物医学文献
PubMed Central						生物医学开放全文和 PMC PDF
Europe PMC						生物医学元数据和开放全文链接

计算机/工程

平台	搜索	下载	全文	被引统计	API Key	特色功能
DBLP						官方 DBLP search API，计算机文献目录
ACM Digital Library 元数据						通过 Crossref 的 ACM DOI 前缀检索元数据；不抓取 ACM 页面
USENIX 元数据						基于 DBLP 的 USENIX 会议元数据；不抓取 USENIX 搜索页
IEEE Xplore					^-^ 必需	官方 IEEE Xplore Metadata API，需要 IEEE_API_KEY

开放全文/仓储

平台	搜索	下载	全文	被引统计	API Key	特色功能
CORE		^-^ 条件支持	^-^ 条件支持		^-^ 可选	记录含 PDF 或全文链接时可下载
OpenAIRE		^-^ 条件支持			^-^ 可选	记录含开放链接时可用于回退下载
Unpaywall	^-^ 条件支持	^-^ 条件支持			^-^ 邮箱	仅支持 DOI 查询；需要 email；发现 OA PDF 时可下载

预印本/会议稿

平台	搜索	下载	全文	被引统计	API Key	特色功能
arXiv						物理、计算机、数学等预印本
bioRxiv						生物学预印本
medRxiv						医学预印本
OpenReview						公开 OpenReview notes search，适合 AI/ML 投稿、评审和预印本
IACR ePrint						密码学论文

引文库/出版商

平台	搜索	下载	全文	被引统计	API Key	特色功能
Web of Science					^-^ 必需	引文数据库、日期排序、年份范围
ScienceDirect					^-^ 必需	Elsevier 元数据和摘要
Springer Nature / SpringerLink		^-^ 条件支持			^-^ 必需	springerlink 是 springer 的别名；开放获取记录可下载
Wiley	^-^ 关键词搜索				^-^ 必需	TDM API，仅支持 DOI 下载 PDF
Scopus					^-^ 必需	摘要和引文数据库

DOI 定向获取

平台	搜索	下载	全文	被引统计	API Key	特色功能
Sci-Hub						DOI/URL 定向 PDF fallback；不是文献元数据检索来源

常用命令

CLI 的输出设计是 agent-friendly，优先面向 AI、agent 和脚本解析。默认输出结构化 JSON，完整平台和命令可以看 GitHub 上面。

安装：

npm install -g paper-search-cli

paper-search setup

搜索论文：可以同时多个来源进行检索

paper-search search "machine learning applications" --platform all --max-results 5 --pretty

检索期刊指标：

用于查询期刊影响因子、JCR / SSCI 分区、中科院分区、JCI、ESI、预警和等级字段，需要配置 EASYSCHOLAR_KEY。

paper-search journal-metrics "Nature" "BMJ" --pretty

PDF 下载：

OA期刊、出版商直连/API、机构访问、CloakBrowser出版商捕获，Sci-Hub兜底。

# arXiv 这类有原生 PDF 的来源

paper-search download 2301.12345 --platform arxiv --save-path ./downloads --pretty



# DOI 论文可走统一 PDF discovery fallback

paper-search run download_with_fallback \

  --json-args '{"source":"crossref","paperId":"10.xxxx/xxxxx","doi":"10.xxxx/xxxxx","title":"Paper title","savePath":"./downloads"}' \

  --pretty

正文片段检索：

用于查论文正文里可能出现的方法描述、参数、模型名、软件名、统计写法等，需要配置SEMANTIC_SCHOLAR_API_KEY。

paper-search run search_semantic_snippets \

  --arg query="statistical model validation methods" \

  --arg limit=5 \

  --arg fieldsOfStudy=Computer Science \

  --pretty

查看工具列表：

paper-search tools --pretty

查看健康报告和 Capability Profile：

paper-search doctor --pretty

paper-search doctor --format text

查看配置状态和本地自检：

paper-search config list --pretty

paper-search smoke --mock --pretty

同步随包发布的 Skill：

paper-search skills status --pretty

paper-search skills update --targets agents --pretty

API key 说明

不配置 key 也能用像 Crossref、OpenAlex、arXiv、PubMed、DBLP、ACM、USENIX、OpenReview 这些来源的信息，但是还是建议先配置后体验更佳：

申请入口：

配置指定平台运行：

paper-search setup xx

配置全部平台运行：

paper-search setup --all

Agent Skill

Skill 用来告诉 agent如何调用 paper-search，安装时候会弹出配置Skill的路径：

skills/paper-search/SKILL.md

后续安装或同步 Skill可以用下面的命令：

paper-search setup --install-skills agents

paper-search skills status --pretty

paper-search skills update --targets agents --pretty

最后，希望有需要的佬友可以帮我点个star，多多提意见。

后续更新任务：通过 WebVPN/CARSI 下载 学校有权限的PDF。有点麻烦，还在调试。