SuperAPI AI 工具集

alterlab-protocolsio

编程与开发

查看项目

更新于 10-16 05:00

技能介绍

用途:该技能用于以编程方式对接 protocols.io(托管可版本化、可引用的科学协议,每个发布版本获得 10.17504/protocols.io.* 形式的 DOI),支持检索、读取、创建、编辑与发布协议,以及管理评论、工作区、文件和实验运行记录。

主要能力:按关键词、作者或工作区搜索协议,或用 DOI/URI 解析协议;以 Markdown、HTML 或 Draft.js JSON 读取协议步骤与材料;创建私有协议、填写元数据与步骤并发布或预留 DOI;读写协议评论与步骤讨论;列出或加入工作区、搜索工作区文件、上传文件、导出机构内容;创建和更新实验运行记录。

使用方式:提供两条途径。官方 MCP 服务器为 https://www.protocols.io/mcp(Streamable HTTP,OAuth 2.0 登录或 Bearer 客户端令牌),若会话中已连接应优先使用。REST API 基址为 https://www.protocols.io/api,多数端点为 v3,获取/更新协议、步骤、运行记录、文件管理器搜索与机构导出使用 v4,参考文档见 https://apidoc.protocols.io/。请求需带 Authorization: Bearer <token>,令牌存于环境变量(如 PROTOCOLS_IO_TOKEN)。协议端点接受整数 id、uri 或 DOI,可加 /v1 指定版本或 /latest 取最新;v4 读取可用 content_format=json|html|markdown;列表端点用 page_id 与 page_size(1–100,默认 10)。响应体含 status_code,0 表示成功,需检查该字段而非仅看 HTTP 状态。

限制:速率限制为每用户每分钟 100 次请求,PDF 端点登录 5 次/分钟、未登录 3 次/分钟,超限返回 HTTP 429。OAuth 令牌约一年有效,到期前一个月警告,刷新会使旧令牌对失效。发布需标题和至少一位作者,已获 DOI 的版本不可再编辑,内容变更需在网页编辑器创建新版本。上传文件为三步(注册、S3 上传、确认),文档未提供文件夹、工作区或标签字段。引用时应注明所用版本 DOI 与检索日期。

适用场景:检索并分析现有协议、起草并发布实验室协议、记录协议运行、团队工作区协作、机构内容归档。不适用于通用电子实验记录、液体处理脚本生成、预印本投递或论文方法部分写作。