如何安装 Paperclip CLI、配置 PAPERCLIP_API_KEY 并验证凭据有效【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills这篇文章解决一个具体问题在 macOS 或 Linux 上安装 Paperclip CLIGXL 提供的科研文献检索命令行工具通过PAPERCLIP_API_KEY环境变量完成认证并用一条真实查询证明凭据有效。Paperclip 把约 1100 万篇全文论文、21.7 万份监管文档、11 万份临床试验方案和 57.4 万条蛋白质条目暴露为只读虚拟文件系统/papers、/fda、/trials、/proteins、/clipboard用 Unix 风格命令浏览。适用前提是文档在 paperclip 0.7.14 和 0.7.15 上验证过的环境macOS 或 Linux、POSIX shell、可访问网络。原生安装器不支持 WindowsWindows 用户需改用托管 MCP server见 安装参考文档。先做 preflight确认是否已安装在动手安装之前先运行 SKILL.md 给出的 preflight 检查它一次性回答是否已安装和当前凭据是什么command -v paperclip /dev/null || echo paperclip NOT INSTALLED command -v paperclip /dev/null { paperclip --version; [ -f .env ] { set -a; . ./.env; set a; }; paperclip config 21 | grep -E Auth|Health; }输出决定后续走向paperclip NOT INSTALLED表示没有二进制继续下面的安装步骤Auth:行是后续一切判断的依据各取值含义见验证章节。安装 Paperclip CLI一行安装脚本推荐macOS 和 Linuxcurl -fsSL https://paperclip.gxl.ai/install.sh | bash这条命令会用当前用户权限执行从网络拉取的脚本文档明确说明没有已发布的 checksum 或签名可供校验。运行前建议先获得使用者确认如果希望先审查脚本内容文档给出了审查方式curl -fsSL https://paperclip.gxl.ai/install.sh | less安装完成后CLI 是 self-contained 的本体放在~/.paperclip/自带解释器和依赖位于~/.paperclip/lib/并在PATH上放一个启动器macOS 上是~/.local/bin/paperclip。它不会干扰项目里已有的 Python 虚拟环境。如果安装后提示command not found: paperclip说明~/.local/bin不在PATH中export PATH$HOME/.local/bin:$PATH # 加入 ~/.zshrc 或 ~/.bashrc 可持久化可选用 uv 安装如果你想把包装进自己管理的环境例如要在自己的代码中 import Python SDKuv pip install https://paperclip.gxl.ai/paperclip.whl paperclip setup # paperclip login paperclip install两个注意事项均来自 references/installation.mdwheel URL 不带版本号每次解析到的都是当前版本且gxl-paperclip没有发布到 PyPIPyPI 上确实存在一个无关的paperclip包uv pip install paperclip会装到错误的软件必须始终用完整 URL 安装。安装后注意CLI 会自行择机升级命令输出前可能打印[paperclip] Updated 0.7.14 → v0.7.15。无害但长脚本运行期间版本可能变化paperclip --version显示的是实际执行的版本。配置 PAPERCLIP_API_KEY创建 key 并写入.env在https://paperclip.gxl.ai/keys创建 API key形如gxl_...然后在项目目录的.env中写入# .env — add to .gitignore PAPERCLIP_API_KEYgxl_...其中gxl_...替换为你在/keys页面创建的实际 key 值。.env必须加入.gitignore不要把 key 提交进仓库也不要把它写进将来要paperclip upload的文件。为什么每次调用都要带 auth 前缀这是整套流程里最容易出错的环节。references/installation.md 明确说明Paperclip 没有 dotenv 支持包内没有python-dotenv依赖config.py只读os.getenv(PAPERCLIP_API_KEY, )。放在命令旁边的.env文件对它是不可见的必须先把内容导出到环境变量。在持有.env的目录中对每次调用使用文档要求的这种形式[ -f .env ] { set -a; . ./.env; set a; }; paperclip configset -a让后续的赋值自动导出.把文件读进当前 shellset a恢复原状。两个细节不是风格问题[ -f .env ]保护是必须的。不带保护地对一个不存在的文件执行. ./.env在 POSIX shell 中是致命错误——shell 直接终止分号后面的内容全部被静默丢弃。带保护后在.env存在、.env不存在、key 已在环境中、sh或bash四种状态下都安全。每一条调用都要带前缀。环境变量不会在两次独立的 shell 调用之间保留这正是 agent 逐条执行命令的方式。在第一次调用里导出 key、第二次调用再运行paperclipkey 已经消失而且 Paperclip 不会报错它会静默回退到已存储的 OAuth 凭据那是另一个身份。文档演示的错误写法是Auth: ✓ someoneexample.comkey 从未加载正确写法是单条自包含命令得到Auth: ✓ API key (env)。如果 key 已经通过 CI secrets、shell profile 或direnv导出前缀是无害的空操作可以省略。临时使用也可以直接export PAPERCLIP_API_KEYgxl_... # 仅当前 shell 有效另有一个注意点sourcing.env会把文件内容当作 shell 代码执行docs/security-report.md 将其列为风险项所以只在你明确信任该目录下的.env时使用这个前缀。凭据解析顺序文档针对 0.7.14 的cli/app.py和client/client.py验证过三级解析顺序优先级来源说明1--api-key参数可用但会暴露在ps和 shell 历史中应避免2PAPERCLIP_API_KEY环境变量推荐。Click 通过 flag 的envvar绑定读取3~/.paperclip/credentials.json由paperclip login写入环境变量中的 key 会完全短路 OAuth_ensure_auth()直接返回不会打开浏览器即使存在已存储的登录也不读取。也就是说导出的 key 会静默覆盖你曾登录的账号paperclip config显示Auth: ✓ API key (env)而不是邮箱。如果拿不到 key备选路径是浏览器 OAuth由人执行paperclip login会打开浏览器并等待agent 无法完成凭据写入~/.paperclip/credentials.json。注意首次使用时未认证的调用会自动触发登录流程——在 CI 等无交互场景里务必在第一次调用前把 key 配好。验证凭据是否有效分两步。第一步看安装和认证状态paperclip configkey 已导出且安装健康时文档示例输出如下文档示例路径以你的系统为准Paperclip Server: https://paperclip.gxl.ai (default) Auth: ✓ API key (env) Config: /Users/you/.paperclip Health: ✓ server reachable Sources: PubMed Central, bioRxiv, medRxiv, arXivOAuth 登录时Auth行显示的是你的邮箱。各取值对应 SKILL.md 中的 preflight 判断表Auth:输出含义处理✓ API key (env)API key 已加载正确状态继续使用带前缀的调用✓ someoneexample.comkey 没有加载当前是存储的 OAuth另一个身份如果.env里有 key说明你漏了 auth 前缀补上✗ (run: paperclip login)没有任何凭据配置PAPERCLIP_API_KEY或让用户执行paperclip login关键限制Auth: ✓只表示凭据存在不代表它有效Health: ✓ server reachable是一个未认证探针。一个无效的 key 会打印完全相同的两行。真正证明凭据有效需要一次真实查询[ -f .env ] { set -a; . ./.env; set a; }; paperclip search -s pmc test -n 1成功时得到带编号的检索结果结尾是一个[s_xxxxxxxx]形式的结果 id。key 无效时输出[error] Authentication failed (API key invalid).并以退出码1结束——这是脚本里可判断的信号文档建议以退出码为检查依据。安装与认证阶段的常见问题以下是 references/installation.md 故障排查表中与本场景直接相关的条目现象原因与处理command not found: paperclip~/.local/bin不在PATH导出 PATH 或重新 source shell 配置paperclip config显示Auth: ✗执行paperclip login或导出PAPERCLIP_API_KEY搜索报Error: search requires a source flag (-s)预期行为search必须指定来源如-s pmc各来源搜索都返回空残留的持久化 source filter执行paperclip config --sources-list检查必要时paperclip config --sources-clear两条边界说明CLI 会在命令中途自行更新长会话中版本可能变化paperclip update可显式升级并刷新已安装的 agent skills通过 HTTP 传输时 key 走X-API-Key头不要回显它也不要把它包含进上传文件中。下一步凭据验证通过后完整的命令面、MCP 客户端配置Claude Code、Codex、Cursor、Claude Desktop 等和更多安装细节在 references/installation.md文献检索工作流search/grep/map/sql、引用格式、已知缺陷清单在 skills/paperclip/SKILL.md其下还有references/cli-reference.md、references/search-and-retrieval.md等分册。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考