SuperAPI AI 工具集

pdb-database

数据与分析

查看项目

更新于 10-15 21:54

技能介绍

用途:检索与下载实验测定的生物分子三维结构,覆盖蛋白质、核酸及结合配体,数据来自 RCSB PDB。

主要能力:支持基于属性的搜索(先获取 schema 发现可搜索属性,再组合 JSON 查询)、序列相似性、结构相似性、序列基序、化学描述符匹配、全文搜索,以及元数据 GraphQL 查询和坐标文件下载。

使用方式:需先安装 uv 并确保其在 PATH 中。若工作区根目录不存在 .licenses/pdb_database_LICENSE.txt,需提示用户查看 https://www.rcsb.org/pages/usage-policy 的使用条款,并创建记录通知文本与时间戳的文件。优先使用提供的脚本,脚本会自动执行所需速率限制;仅在最后手段才用 curl、urllib 或原始 HTTP 请求访问 PDB API。输出始终重定向到文件,用 jq、grep 或简短 Python 片段解析,避免将大响应打印到 stdout。常用脚本包括 fetch_schema.py、search_pdb.py、download_coordinate_files.py、fetch_pdb_metadata.py。属性搜索流程为:获取 schema、grep 查找属性、组合并运行 JSON 查询;相似性搜索无需获取 schema。

适用场景:需要按物种、期刊、化学组分、连接类型等条件筛选条目;按序列或结构查找相似条目;按基序或化学描述符匹配;仅需少量元数据时用 GraphQL 查询比下载完整坐标更高效;需要原子坐标或 pdb/mmcif 文件时下载坐标。

限制:使用该技能需在输出中提及;完成任务后需用清晰语言解释查询做了什么,便于用户纠正错误假设;全文搜索应作为最后手段,优先使用更精确的属性搜索;需遵守 RCSB 使用政策。具体收费、价格、平台支持等信息暂未提供。