PubMed-Search 是一个面向生物医学文献检索与分析的 AI 工具,帮助用户搜索、访问和分析 PubMed 文章。
用途
该工具定位为专业的生物医学文献搜索助手,适用于需要快速查找、获取和分析 PubMed 学术论文的研究人员、学生或从业者。
主要能力
文章搜索
- 使用关键词搜索 PubMed 文章
- 支持高级搜索,可使用多个过滤器(标题、作者、期刊、日期范围)
- 快速访问全面的论文元数据
元数据检索
- 使用 PMID 获取特定论文的详细元数据
- 提取标题、作者、摘要、期刊、出版日期
- 支持批量检索
论文分析
- 对 PubMed 文章进行深度分析
- 涵盖研究背景与意义
- 方法概述与关键发现
- 局限性与未来研究方向
全文访问
- 尝试下载全文 PDF 内容
- 通过 PubMed Central(PMC)检查开放获取可用性
- 提供文章的直接链接
使用方式
安装前提
- Python 3.8+
- pip 包管理器
安装步骤
安装 Python 依赖(选择一种方式):
方式 1:使用 uv(推荐 - 最快)
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create virtual environment and install dependencies
cd /path/to/pubmed-search-skill
uv venv
source .venv/bin/activate # Linux/macOS
# or .venv\Scripts\activate # Windows
uv pip install -r requirements.txt
方式 2:使用 conda(最适合科学/研究用户)
cd /path/to/pubmed-search-skill
conda create -n pubmed-search python=3.11 -y
conda activate pubmed-search
pip install -r requirements.txt
方式 3:直接使用 pip(内置,无需额外安装)
cd /path/to/pubmed-search-skill
pip install -r requirements.txt
配置 API 凭据(基本搜索可选,PDF 下载需要):
# Copy example configuration
cp .env.example .env
# Edit .env and configure optional settings
# Most features work without API keys - uses free PubMed E-utilities API
验证安装:
python pubmed_search.py --help
使用流程
当用户请求文献搜索或分析时:
- 理解需求:询问要搜索的研究主题或论文
- 选择方法:简单关键词搜索、带特定过滤器的高级搜索、或深度分析
- 执行搜索:
python pubmed_search.py search --keywords "CRISPR gene editing" --results 10
- 呈现结果:显示文章元数据并询问是否需要进一步分析
使用示例
基本关键词搜索:
# Search for articles by keywords
python pubmed_search.py search --keywords "COVID-19 vaccine efficacy" --results 10
高级搜索:
# Search with multiple filters
python pubmed_search.py search --term "cancer" --author "Smith" --journal "Nature" --start-date "2020" --end-date "2023" --results 20
获取文章元数据:
# Fetch detailed metadata for a specific paper
python pubmed_search.py metadata --pmid "12345678"
深度论文分析:
# Perform comprehensive analysis of a paper
python pubmed_search.py analyze --pmid "12345678" --output analysis.md
下载全文 PDF:
# Attempt to download open access PDF
python pubmed_search.py download --pmid "12345678" --output ./papers/
批量搜索:
# Search and save results to file
python pubmed_search.py search --keywords "Alzheimer disease" --results 50 --output results.json
配置要求
环境变量(可选)
该技能使用免费的 PubMed E-utilities API,基本使用无需认证。但可以配置以下可选设置:
- PUBMED_API_KEY:PubMed API 密钥,用于提高速率限制(获取地址:https://www.ncbi.nlm.nih.gov/account/)
- PUBMED_EMAIL:用于 API 请求的电子邮件(使用 API 密钥时必需)
- PUBMED_TOOL:用于 API 识别的工具名称(默认:pubmed-search-skill)
速率限制
- 无 API 密钥:每秒 3 次请求
- 有 API 密钥:每秒最多 10 次请求
- 免费 API 密钥获取地址:https://www.ncbi.nlm.nih.gov/account/
适用场景
- 生物医学领域的文献调研与综述
- 快速获取特定论文的元数据与摘要
- 对单篇论文进行结构化深度分析
- 批量检索并保存文献信息
- 获取开放获取论文的全文 PDF
限制与注意事项
- 该工具使用免费的 PubMed E-utilities API
- PDF 下载仅适用于开放获取文章
- 始终需要从原始来源验证信息
- 使用下载的文章时需尊重版权
- 存在速率限制,重度使用建议获取 API 密钥
- 输出格式包括控制台(人类可读)、JSON(机器可读)和 Markdown(文档格式)
最佳实践
- 使用具体关键词以获得更好的结果
- 应用过滤器(作者、期刊、日期)缩小搜索范围
- 在请求完整分析前先查看摘要
- 下载 PDF 前检查开放获取可用性
- 使用检索到的信息时引用原始论文