PubMed EDirect 技能

使用 NCBI 的 EDirect 命令行工具搜索和检索 PubMed 文献。

⚠️ 安全通告

重要提示：此技能需要安装外部命令行工具。安装过程涉及：

1. 外部脚本执行：从官方 NCBI FTP 服务器下载并执行安装脚本
2. 系统修改：将目录添加到您的 PATH 环境变量中
3. 权限要求：可能需要安装 Perl 模块和依赖项

在安装之前，您必须：

1. 下载后审查安装程序脚本内容
2. 确认来源可靠（官方ftp.ncbi.nlm.nih.gov域名）
3. 在测试环境中验证
4. 了解将要执行的所有命令

概述

该技能通过官方的EDirect（Entrez Direct）工具提供对PubMed和其他NCBI数据库的访问。EDirect是一套程序，能够从Unix终端访问NCBI的一系列互连数据库（出版物、序列、结构、基因、变异、表达等）。

注意：这是一个本地安装技能——所有工具都直接在您的系统上运行，无需Docker或容器化。请按照INSTALL.md指南进行本地设置。

结构

该技能组织为以下文件：

• INSTALL.md- 安装和配置指南
• BASICS.md- 基本用法和常用命令
• ADVANCED.md- 高级技术和复杂查询
• EXAMPLES.md- 实际使用示例
• REFERENCE.md- 快速参考（字段限定符、格式等）
• OPENCLAW_INTEGRATION.md- OpenClaw专用使用指南
• scripts/- 用于常见任务的有用bash脚本

快速开始

1. 阅读安装指南：审阅INSTALL.md以获取安全安装步骤
2. 手动安装EDirect：

   # Step 1: Download the script
   wget -q https://ftp.ncbi.nlm.nih.gov/entrez/entrezdirect/install-edirect.sh
   
   # Step 2: Review content (important for security)
   less install-edirect.sh
   
   # Step 3: Execute installation
   ./install-edirect.sh
   

3. 验证安装：

   esearch -db pubmed -query "test" -retmax 1
   

4. 探索示例：查看EXAMPLES.md

核心工具

该技能通过OpenClaw的exec功能提供对EDirect工具的访问：

• esearch- 搜索数据库
• efetch- 检索记录
• elink- 查找相关记录
• efilter- 筛选结果
• xtract- 从XML提取数据
• einfo- 获取数据库信息

支持的数据库

EDirect支持众多NCBI数据库，包括：

• pubmed- 生物医学文献
• pmc- PubMed Central全文文章
• gene- 基因信息
• nuccore- 核苷酸序列
• protein- 蛋白质序列
• mesh- 医学主题词
• 以及更多...

主要特性

• 命令行访问NCBI数据库
• 管道架构使用Unix管道
• 结构化数据提取配合XML解析
• 批处理能力
• 跨数据库链接记录之间

获取帮助

• 使用-help配合任何EDirect命令：esearch -help
• 查阅官方文档
• 检查安装指南中的故障排除

包含的脚本

在scripts/目录中包含即用型bash脚本：

batch_fetch_abstracts.sh

通过错误处理和速率限制，为一系列PMID获取摘要。

./scripts/batch_fetch_abstracts.sh pmids.txt abstracts/ 0.5

search_export_csv.sh

搜索PubMed并将结果导出为包含元数据的CSV文件。

./scripts/search_export_csv.sh "CRISPR [TIAB]" 100 results.csv

publication_trends.sh

通过可视化分析出版物随时间变化的趋势。

./scripts/publication_trends.sh "machine learning" 2010 2023 trends.csv

安全最佳实践

1. 脚本审查

# Always download first and review scripts
wget -q SOURCE_URL -O script.sh
less script.sh  # or cat script.sh | head -50
# Execute only after review
./script.sh

2. 环境隔离

• 在 Docker 容器中运行可提供隔离性
• 使用虚拟机进行测试
• 设置专用用户账户

3. 最小权限原则

• 不要以 root 身份运行
• 设置适当的文件权限
• 为数据使用专用目录

4. 网络控制

• 配置防火墙规则
• 使用代理进行受控访问
• 监控网络流量

注意事项

重要提示：此技能需要手动安装和配置。所有安装步骤均需要用户明确确认并执行。

此技能通过本地安装 EDirect 工具，提供对 NCBI 数据库的命令行访问。