用途:通过 protocols.io 的 REST API(基础地址 https://www.protocols.io/api/v4)以编程方式检索和获取实验方案,适用于查找方法、提取步骤与试剂清单、核对版本与引用。
主要能力:按关键词检索协议并支持排序(relevance、views、date、activity)与分页(page_size 最多50);按协议 ID 或 DOI 获取完整内容,包括步骤、时长、温度、材料、试剂与供应商和货号信息;浏览分类列表;查看协议版本信息。公开协议无需鉴权即可访问,私有协议或创建编辑需在 https://www.protocols.io/developers 获取 OAuth2 Bearer 令牌。
使用方式:安装依赖 pip install requests pandas,使用 requests 调用上述端点,公开检索无需令牌;必要时在请求头加入 Authorization: Bearer YOUR_TOKEN_HERE。常见端点:GET /protocols(搜索)、GET /protocols/{id}(完整内容)、GET /categories(分类)。公开 API 限速约每秒10次,超限可加 time.sleep(0.15)。
适用场景:方法学调研与方案比较、构建实验室自动化流程所需的步骤与试剂数据、通过 DOI 生成方法部分引用、按试剂或试剂盒名称反查使用该试剂的协议。
限制:公开协议默认 CC-BY 4.0,商用需逐项核对;协议 DOI 有版本,引用应使用具体版本 DOI;步骤描述可能含富文本需去除标签;材料列表可能为空而嵌入步骤文本;DOI 检索需精确比对字段。缺失信息暂未提供。