用途:将用户提供的 3D 蛋白质结构文件提交到 Foldseek Web 服务器 API,检索结构相似的蛋白质,报告排名靠前的结构命中,解读比对指标,推断蛋白功能,并把结果保存为 Markdown 表格和本地 JSON 文件。
主要能力:支持对 afdb50、afdb-swissprot、pdb100、BFVD、mgnify_esm30、cath50、gmgcl_id、bfmd、afdb-proteome 等数据库进行结构搜索;输出 Prob(接近 1.0 表示高置信同源)、Q-Cov(查询覆盖度)、E-value 与序列一致性等指标;可基于 Target ID 中的描述做功能分析,汇总命中的蛋白名称、结构域与蛋白家族。
使用方式:需先安装 uv 并确保其在 PATH 中。若工作区根目录不存在 .licenses/foldseek_structural_search_LICENSE.txt,需提示用户查看 https://search.foldseek.com/search 与 https://github.com/steineggerlab/foldseek 的条款,并创建记录通知文本与时间戳的文件。默认执行:uv run scripts/search.py <path-to-file> -o <generated-filename.json> > <generated-filename.md>;指定数据库时执行:uv run scripts/search.py <path-to-file> -o <generated-filename.json> --databases <db1,db2,db3> > <generated-filename.md>。随后读取生成的 .md 文件进行解读。
限制:不能按序列、名称或登录号搜索,必须提供 .pdb、.cif 或 .mmcif 文件路径;若用户只给出蛋白名、氨基酸序列或 UniProt ID 而无结构文件,须停止并建议先下载结构。数据库必须属于允许列表,否则停止。不要自行解析原始 3D 坐标或 JSON,JSON 仅供后续专用工具使用。使用本技能时需在输出中说明。若 API 报错或文件缺失,应提示用户核对路径。其他收费、平台与效果信息暂未提供。