用途: 该工具面向需要查找或查看 protocols.io 上已发表、经同行评审或社区贡献的实验室协议的用户。可在自行设计实验方案前,先搜索是否已有针对特定技术的公开分步协议;也可在已获得协议 ID、URI slug 或 DOI 时,获取该协议的完整描述、材料清单和具体操作步骤;还可用于比较不同实验室执行同一技术的方式。
主要能力:
- 按技术或关键词搜索协议,支持限制返回数量(1-50,默认10),并可按相关性、活跃度、日期、名称或 ID 排序,返回候选协议的 id、标题、DOI、作者和发布日期。
- 通过协议 ID、URI slug 或 DOI 获取单个协议的完整详情,包括标题、描述、材料、作者和 DOI,内容格式可选 json、html 或 markdown。
- 获取指定协议的有序步骤数组,每步包含文本、引用试剂、计时器、图片等组件,格式同样可选 json、html 或 markdown。
使用方式: 所有调用均需设置环境变量 PROTOCOLS_IO_API_KEY,并在请求头中使用 Bearer 认证。若密钥缺失,工具会返回指明缺失键的明确错误,并提示前往 https://www.protocols.io/api-clients 注册 API 客户端以获取密钥。搜索使用 v3 API,协议详情和步骤使用 v4 API。令牌有效期约一年,过期后可能需刷新而非重新注册。若调用返回 HTTP 400,应优先检查令牌是否有效。
适用场景: 实验前查找特定技术的已发表协议;获取已有协议标识对应的详细步骤和材料;比较不同实验室对同一技术的操作差异。
限制: 不适用于设计新的 Gibson/Golden Gate 组装策略、PCR 引物设计或质粒/试剂采购,这些应使用其他对应工具。无匿名访问层级,必须提供有效 API 密钥。响应体结构基于 protocols.io 公开 API 文档构建,未在真实密钥环境下端到端验证,实际使用时若结构不符应以实时响应为准。不得凭记忆编造协议内容;密钥缺失或查询失败时应如实告知用户。