ScanSci PDF

ScanSci PDF 是一款专为研究人员、学生及学术工作者设计的命令行工具，旨在解决“获取论文全文难”的痛点。它通过自动化尝试多种合法路径（开放获取、出版商 API、机构订阅、浏览器登录等），将 DOI、arXiv ID 或论文列表转化为本地可阅读的 PDF 文件。

该工具不仅支持单篇下载，更擅长处理批量任务，并能无缝集成到 AI Agent 工作流中，是构建个人知识库或进行文献综述的高效助手。

核心功能亮点

📚 多路径智能获取

• 全渠道覆盖：自动尝试 OA 资源、出版商官方接口（如 Elsevier API）、机构代理（WebVPN/CARSI/EZProxy）以及浏览器 SSO 登录。
• 优先官方 API：针对 Elsevier/ScienceDirect 等主流出版商，支持配置 API Key，直接通过官方 Article Retrieval API 获取高质量 XML 并解析正式 PDF，绕过网页验证码和 Cloudflare 防护。
• 合规访问：严格遵循机构授权范围，利用校园网 IP 或图书馆出口实现合法下载。

🚀 高效批量处理

• 列表导入：支持从文本文件中读取 DOI 列表或 URL，一键批量下载。
• 元数据提取：在下载同时，可获取论文的 BibTeX、RIS、EndNote 引文格式，方便直接导入文献管理软件。

🤖 AI Agent / MCP 集成

• 智能体赋能：提供标准的 CLI 接口，可轻松接入 Claude Code、Codex 或其他支持 MCP 的 AI 助手。让 AI 在回答学术问题时，能自主调用工具获取并阅读原始文献，提升回答的准确性与深度。

🔒 隐私与安全

• 本地存储：所有下载的 PDF 均保存在本地指定目录（默认 ~/.scansci-pdf/papers）。
• 密钥管理：API Key 等敏感信息通过专用命令配置，避免硬编码在脚本中。

快速开始指南

1. 安装

基础版（适合大多数 OA 和简单下载）：

pip install scansci-pdf

完整版（支持学校登录、WebVPN、CARSI/EZProxy 及可见浏览器下载）：

pip install "scansci-pdf[cloakbrowser,instsci]"

2. 环境检查

确保依赖项已正确安装：

scansci-pdf check

3. 下载单篇论文

使用 DOI 即可快速下载：

scansci-pdf get 10.1038/nature12373
# 指定输出目录
scansci-pdf get 10.1038/nature12373 --output ./my_papers

4. 批量下载

准备一个 dois.txt 文件，每行一个 DOI 或 URL：

10.1038/nature12373
10.1016/j.neunet.2026.108582
https://doi.org/10.1126/science.aec6396

运行批量命令：

scansci-pdf batch dois.txt --output ./bulk_downloads

推荐配置：Elsevier / ScienceDirect API

为了获得最快、最稳定的 Elsevier 系列期刊（包括 ScienceDirect, Cell Press 等）下载体验，建议配置官方 API Key：

1. 申请 Key：访问 Elsevier Developer Portal，注册并创建 API Key，选择 ScienceDirect / Article Retrieval 权限。
2. 配置工具：

   scansci-pdf elsevier-setup --api-key YOUR_KEY
   

   注：若机构提供 institutional token，可一并配置 --inst-token YOUR_TOKEN，但多数情况下校园网 IP 已足够。

3. 优势：此路径直接获取出版社正式 PDF，无需处理网页反爬，速度极快且质量最高。

适用场景

• 文献综述：快速下载几十篇相关领域的核心论文，建立本地资料库。
• AI 辅助科研：配合 AI 助手，实现“提问-检索-下载-阅读-总结”的全自动化闭环。
• 机构用户：高校师生利用学校订阅权限，在校外通过 WebVPN 或 CARSI 无缝获取资源。
• 数据归档：为长期研究项目备份关键文献的正式版本。

注意事项

• 合规使用：请务必遵守你所在机构、出版商和当地法律法规的授权范围。本工具仅用于辅助合法获取已授权或开放获取的学术资源。
• 网络环境：部分出版商接口可能对 IP 地域有限制，建议在校园网或机构授权网络环境下使用以获得最佳成功率。