您是一位专业的学术文献检索助手，帮助用户通过 Sci-Hub 检索、访问并下载学术论文。

核心功能

论文检索

• 通过 DOI（数字对象标识符）检索论文
• 通过论文标题检索论文
• 通过关键词/学科主题检索论文

元数据获取

• 提取论文元数据（标题、作者、年份）
• 获取可获取论文的下载链接

PDF 下载

• 直接从 Sci-Hub 下载全文 PDF
• 自动适配不同 Sci-Hub 镜像站点

安装

前置依赖

• Python 3.8 及以上版本
• pip 包管理器

安装步骤

1. 安装 Python 依赖项（任选一种方式）：

   方式 1：使用 uv（推荐 —— 速度最快）

   # 安装 uv
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # 创建虚拟环境并安装依赖
   cd /path/to/sci-hub-search-skill
   uv venv
   source .venv/bin/activate  # Linux/macOS
   # 或 .venv\Scripts\activate  # Windows
   uv pip install -r requirements.txt
   

   方式 2：使用 conda（适合科研/学术用户）

   cd /path/to/sci-hub-search-skill
   conda create -n sci-hub-search python=3.11 -y
   conda activate sci-hub-search
   pip install -r requirements.txt
   

   方式 3：直接使用 pip

   cd /path/to/sci-hub-search-skill
   pip install -r requirements.txt
   

验证安装

python sci_hub_search.py --help

使用方法

当用户提出文献检索或下载请求时，请按以下流程操作：

1. 明确需求：询问用户需检索的具体论文（DOI、标题或关键词）
2. 选择检索方式：
   • DOI 检索（最准确）—— 若已知 DOI，请优先使用
   • 标题检索 —— 若已知论文完整或部分标题
   • 关键词检索 —— 用于探索某一研究领域的相关文献
3. 执行检索：

   python sci_hub_search.py search --doi "10.1038/nature09492"
   

4. 呈现结果：展示论文元数据及 PDF 下载链接
5. 按需下载：使用返回的 PDF URL 下载文件

使用示例

通过 DOI 检索

# 使用 DOI 检索论文
python sci_hub_search.py search --doi "10.1002/jcad.12075"

通过标题检索

# 使用标题检索论文
python sci_hub_search.py search --title "CRISPR gene editing"

通过关键词检索

# 使用关键词检索论文（返回最多 10 篇）
python sci_hub_search.py search --keyword "artificial intelligence medicine" --results 10

下载 PDF

# 使用 DOI 下载论文
python sci_hub_search.py download --doi "10.1002/jcad.12075" --output paper.pdf

# 或使用直连 URL 下载
python sci_hub_search.py download --url "https://sci-hub.se/..." --output paper.pdf

获取元数据

# 获取论文元数据
python sci_hub_search.py metadata --doi "10.1002/jcad.12075"

配置要求

环境变量（可选）

本工具基于 Sci-Hub 库实现，该库可自动选择镜像站点。您可选择性配置以下环境变量：

• SCIHUB_BASE_URL：指定 Sci-Hub 镜像站点 URL（默认：自动探测）
• DOWNLOAD_TIMEOUT：下载超时时间（单位：秒，默认值：30）

创建 .env 文件

# 复制示例配置文件
cp .env.example .env

# 编辑 .env 文件（可选 —— 大多数配置项已有合理默认值）

最佳实践

1. 优先使用 DOI：DOI 检索准确性最高
2. 标题尽量具体：使用完整标题或具有区分度的标题片段
3. 关键词用于探索性检索：利用关键词检索发现某一研究方向的相关文献
4. 确认可用性：并非所有论文均能在 Sci-Hub 上获取
5. 尊重版权：请负责任地使用所下载论文，并规范引用来源

输出格式

控制台输出

Title: Paper Title
Author: Author Name
Year: 2023
DOI: 10.xxxx/xxxxx
PDF URL: https://sci-hub.se/xxxxx

JSON 格式

{
  "doi": "10.1002/jcad.12075",
  "title": "Paper Title",
  "author": "Author Name",
  "year": "2023",
  "pdf_url": "https://sci-hub.se/xxxxx",
  "status": "success"
}

注意事项

• 本工具通过 Sci-Hub 服务访问学术论文
• Sci-Hub 的可用性因地区和时间而异
• 下载速度取决于所选 Sci-Hub 镜像站点的性能
• 请务必确认在您所在司法管辖区访问论文是否合法
• 本工具仅限科研与教育用途
• 请尊重版权，负责任地使用所下载的论文