drug-db-pdb

Search RCSB Protein Data Bank and export structure metadata as JSON.

144|21|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill drug-db-pdb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drug-db-pdb
Source: https://github.com/learningmatter-mit/AtomisticSkills/tree/main/.agents/skills/drug-db-pdb
Command: npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill drug-db-pdb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates finding protein (and protein–ligand complex) structures in the RCSB Protein Data Bank and packaging the metadata and optional downloads needed for drug-discovery modeling.

Core Features & Use Cases

  • RCSB Search + Ranking: Uses the RCSB Search API to return top-scoring PDB IDs for a query (optionally filtered by organism, resolution, and experimental method).
  • Rich Entry Metadata Retrieval: Fetches entry core metadata including title, experimental method, resolution, release dates, and unit cell parameters.
  • Ligand/Non-polymer Entity Extraction: Enumerates non-polymer entities from the entry container identifiers and retrieves bound ligand metadata.
  • Optional File Downloads: Downloads coordinate files in PDB or preferred mmCIF formats and can also download wwPDB full validation report PDFs.
  • Quality-Aware Workflow Support: Encourages selection using validation/ligand-quality rather than resolution alone.

Quick Start

Use the drug-db-pdb skill to search RCSB PDB for ACE2 Homo sapiens X-ray diffraction structures with resolution <= 2.5 Å and write the resulting metadata to a JSON file.

Frequently Asked Questions about drug-db-pdb

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

FAQPage Schema
How do I search RCSB PDB for protein structures with ligands for drug discovery?

Searching the RCSB PDB for drug discovery uses the RCSB Search API to return top-scoring PDB entries by keyword, filtered by organism, resolution, and experimental method. It then optionally enumerates bound ligand metadata from non-polymer entities.

Can I download mmCIF coordinate files and validation reports from the Protein Data Bank programmatically?

Yes, downloading mmCIF coordinate files and validation reports from the Protein Data Bank is supported. The workflow retrieves entry metadata and can optionally download preferred mmCIF or PDB format coordinate files alongside wwPDB full validation report PDFs.

What metadata is included when retrieving PDB entries for macromolecular structures?

Retrieving PDB entries for macromolecular structures fetches entry core metadata including the title, experimental method, resolution, release dates, and unit cell parameters to support quality-aware selection for drug-discovery modeling.

Does the RCSB Search API enforce rate limiting when querying protein-ligand complex data?

Querying protein-ligand complex data through the RCSB Search API enforces rate limiting with retries and backoff. This ensures stable automated retrieval of macromolecular structure metadata and optional coordinate downloads during drug-discovery workflows.

How do I filter PDB structures by resolution and experimental method for drug-target modeling?

Filtering PDB structures by resolution and experimental method for drug-target modeling is handled through the RCSB Search API. You can apply constraints like X-ray diffraction with resolution thresholds, such as less than 2.5 Å, and export results to JSON.

What is the best way to select PDB entries for drug discovery workflows beyond resolution?

Selecting PDB entries for drug discovery workflows should use a quality-aware approach based on validation and ligand-quality data rather than resolution alone. The workflow retrieves wwPDB validation PDFs and ligand metadata to inform this selection.