SuperAPI AI 工具集

PubMed-Search

写作与研究

查看项目

更新于 10-16 09:05

技能介绍

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

使用流程

当用户请求文献搜索或分析时:

  1. 理解需求:询问要搜索的研究主题或论文
  2. 选择方法:简单关键词搜索、带特定过滤器的高级搜索、或深度分析
  3. 执行搜索:
python pubmed_search.py search --keywords "CRISPR gene editing" --results 10
  1. 呈现结果:显示文章元数据并询问是否需要进一步分析

使用示例

基本关键词搜索:

# 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 前检查开放获取可用性
  • 使用检索到的信息时引用原始论文