query-pdb

Query RCSB PDB for protein structures and metadata via REST APIs.

401|53|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Runchuan-BU/BioClaw --skill query-pdb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query-pdb
Source: https://github.com/Runchuan-BU/BioClaw/tree/main/.claude/skills/query-pdb
Command: npx skills add https://github.com/Runchuan-BU/BioClaw --skill query-pdb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill lets you quickly find and retrieve experimental 3D protein structures and associated metadata from the RCSB Protein Data Bank, removing the need for manual web searches and manual entry inspection.

Core Features & Use Cases

  • Keyword and text search: Find PDB entries using simple free-text queries (protein name, ligand, or keyword).
  • Advanced filtered queries: Search by gene name, organism, and experimental method to narrow results to X-ray, cryo-EM, or NMR structures.
  • Entry inspection and download: Retrieve entry metadata (method, resolution, ligands, title) and download PDB files for local analysis or visualization.
  • Use case: Locate recent human cryo-EM structures for a receptor, compare reported resolutions, and download selected PDB files for binding-site analysis.

Quick Start

Ask the query-pdb skill to search for "human ACE2" with method "ELECTRON MICROSCOPY" and return the top five PDB entries.

Frequently Asked Questions about query-pdb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download protein structures from the RCSB PDB database?

To download protein structures from the RCSB PDB, you can query by direct PDB ID or free text to retrieve entry details and downloadable PDB files over HTTPS. This provides immediate access to experimental 3D structure data for local analysis.

Can I search for cryo-EM or X-ray structures by gene name and organism?

Yes, you can search for cryo-EM or X-ray structures by applying advanced filtered queries using gene name, organism, and experimental method. This narrows results to specific structural data entries derived from Electron Microscopy or X-Ray Diffraction.

What is the best way to retrieve protein structure metadata like resolution and ligands?

Retrieving protein structure metadata like resolution and ligands is best done by querying the RCSB REST APIs. This returns listed entries detailing experimental methods, reported resolutions, and associated ligands without manual web inspection.

How do I find specific PDB entries using free text and pagination?

You can find specific PDB entries using free text queries with pagination support to manage large result sets. Querying the RCSB REST APIs over HTTPS lists matching entries while handling basic HTTP errors to ensure reliable data retrieval.

Does this tool provide local PDB files for binding-site analysis?

Yes, this tool provides downloadable PDB files for binding-site analysis by fetching entry details directly from the RCSB database. You can locate specific structures, compare reported resolutions, and download selected files for local visualization.

What are the limitations when searching for NMR protein structures?

A limitation when searching for NMR protein structures is that queries rely on basic HTTP error handling and pagination, which may require multiple requests for large datasets. Searches are restricted to existing RCSB PDB entries filtered by Solution NMR methodology.