CLI

在终端检索 AI 顶会论文

官方命令行客户端,连接托管的 MCP 服务 https://paperlist.ai/mcp。你可以自己在终端用,也可以放进脚本或 coding agent。开源的是这个客户端,不是论文数据库,也不是 Paperlist 的服务端。

安装

需要 Node.js 20 或更高版本。发布的 npm 包是 @paperlist/cli,安装后的命令是 paperlist。

npm install -g @paperlist/cli
paperlist --help
paperlist --version

也可以不全局安装,直接运行:

npx @paperlist/cli --help

先不用登录试一次

paperlist conferences 调用无需登录的 list_conferences。装好即可使用,不需要账号或 API key。

paperlist conferences
paperlist conferences --json

再搜索论文并输出 JSON

search、paper、papers、similar、topics 和 topic-stats 需要 Paperlist 账号。在控制台设置里创建 API key,然后把 PAPERLIST_API_KEY 写进环境变量,或运行 paperlist login --api-key 并在提示时粘贴。脚本和 agent 可以把 key 通过管道传给 paperlist login --api-key-stdin。不要把真实的 API key 写在命令行参数里。 打开控制台设置。

默认输出是给人看的。加上 --json 会把稳定的 JSON 写到 stdout(诊断信息走 stderr)。CLI 不会自动翻完全部页;上一页若返回 next_cursor,再用 --cursor 继续。

paperlist search "graph transformers" --json
paperlist search --conference neurips --year-from 2024 --limit 5 --json

给脚本和 Agent

无人值守的任务优先用环境变量,而不是本地已保存的登录状态。退出码是稳定的:0 成功(包括空列表),1 本地错误,2 用法错误,3 认证失败,4 限流,5 网络或超时,6 API / 工具错误。这个 CLI 不采集遥测。

关于登录

不带参数的 paperlist login 只会在交互式终端里打开浏览器做 OAuth。自动化测试覆盖了客户端流程(本地 fixture);生产环境的 OAuth 登录尚未在 CLI 仓库里做过端到端验证。若需要现在就能用的登录方式,请用 API key。

源码和安装包

GitHub 源码npm 包GitHub Issues论文搜索 MCPMCP 工具