drugbank-database
npx machina-cli add skill Microck/ordinary-claude-skills/drugbank-database --openclawDrugBank Database
Overview
DrugBank is a comprehensive bioinformatics and cheminformatics database containing detailed information on drugs and drug targets. This skill enables programmatic access to DrugBank data including ~9,591 drug entries (2,037 FDA-approved small molecules, 241 biotech drugs, 96 nutraceuticals, and 6,000+ experimental compounds) with 200+ data fields per entry.
Core Capabilities
1. Data Access and Authentication
Download and access DrugBank data using Python with proper authentication. The skill provides guidance on:
- Installing and configuring the
drugbank-downloaderpackage - Managing credentials securely via environment variables or config files
- Downloading specific or latest database versions
- Opening and parsing XML data efficiently
- Working with cached data to optimize performance
When to use: Setting up DrugBank access, downloading database updates, initial project configuration.
Reference: See references/data-access.md for detailed authentication, download procedures, API access, caching strategies, and troubleshooting.
2. Drug Information Queries
Extract comprehensive drug information from the database including identifiers, chemical properties, pharmacology, clinical data, and cross-references to external databases.
Query capabilities:
- Search by DrugBank ID, name, CAS number, or keywords
- Extract basic drug information (name, type, description, indication)
- Retrieve chemical properties (SMILES, InChI, molecular formula)
- Get pharmacology data (mechanism of action, pharmacodynamics, ADME)
- Access external identifiers (PubChem, ChEMBL, UniProt, KEGG)
- Build searchable drug datasets and export to DataFrames
- Filter drugs by type (small molecule, biotech, nutraceutical)
When to use: Retrieving specific drug information, building drug databases, pharmacology research, literature review, drug profiling.
Reference: See references/drug-queries.md for XML navigation, query functions, data extraction methods, and performance optimization.
3. Drug-Drug Interactions Analysis
Analyze drug-drug interactions (DDIs) including mechanism, clinical significance, and interaction networks for pharmacovigilance and clinical decision support.
Analysis capabilities:
- Extract all interactions for specific drugs
- Build bidirectional interaction networks
- Classify interactions by severity and mechanism
- Check interactions between drug pairs
- Identify drugs with most interactions
- Analyze polypharmacy regimens for safety
- Create interaction matrices and network graphs
- Perform community detection in interaction networks
- Calculate interaction risk scores
When to use: Polypharmacy safety analysis, clinical decision support, drug interaction prediction, pharmacovigilance research, identifying contraindications.
Reference: See references/interactions.md for interaction extraction, classification methods, network analysis, and clinical applications.
4. Drug Targets and Pathways
Access detailed information about drug-protein interactions including targets, enzymes, transporters, carriers, and biological pathways.
Target analysis capabilities:
- Extract drug targets with actions (inhibitor, agonist, antagonist)
- Identify metabolic enzymes (CYP450, Phase II enzymes)
- Analyze transporters (uptake, efflux) for ADME studies
- Map drugs to biological pathways (SMPDB)
- Find drugs targeting specific proteins
- Identify drugs with shared targets for repurposing
- Analyze polypharmacology and off-target effects
- Extract Gene Ontology (GO) terms for targets
- Cross-reference with UniProt for protein data
When to use: Mechanism of action studies, drug repurposing research, target identification, pathway analysis, predicting off-target effects, understanding drug metabolism.
Reference: See references/targets-pathways.md for target extraction, pathway analysis, repurposing strategies, CYP450 profiling, and transporter analysis.
5. Chemical Properties and Similarity
Perform structure-based analysis including molecular similarity searches, property calculations, substructure searches, and ADMET predictions.
Chemical analysis capabilities:
- Extract chemical structures (SMILES, InChI, molecular formula)
- Calculate physicochemical properties (MW, logP, PSA, H-bonds)
- Apply Lipinski's Rule of Five and Veber's rules
- Calculate Tanimoto similarity between molecules
- Generate molecular fingerprints (Morgan, MACCS, topological)
- Perform substructure searches with SMARTS patterns
- Find structurally similar drugs for repurposing
- Create similarity matrices for drug clustering
- Predict oral absorption and BBB permeability
- Analyze chemical space with PCA and clustering
- Export chemical property databases
When to use: Structure-activity relationship (SAR) studies, drug similarity searches, QSAR modeling, drug-likeness assessment, ADMET prediction, chemical space exploration.
Reference: See references/chemical-analysis.md for structure extraction, similarity calculations, fingerprint generation, ADMET predictions, and chemical space analysis.
Typical Workflows
Drug Discovery Workflow
- Use
data-access.mdto download and access latest DrugBank data - Use
drug-queries.mdto build searchable drug database - Use
chemical-analysis.mdto find similar compounds - Use
targets-pathways.mdto identify shared targets - Use
interactions.mdto check safety of candidate combinations
Polypharmacy Safety Analysis
- Use
drug-queries.mdto look up patient medications - Use
interactions.mdto check all pairwise interactions - Use
interactions.mdto classify interaction severity - Use
interactions.mdto calculate overall risk score - Use
targets-pathways.mdto understand interaction mechanisms
Drug Repurposing Research
- Use
targets-pathways.mdto find drugs with shared targets - Use
chemical-analysis.mdto find structurally similar drugs - Use
drug-queries.mdto extract indication and pharmacology data - Use
interactions.mdto assess potential combination therapies
Pharmacology Study
- Use
drug-queries.mdto extract drug of interest - Use
targets-pathways.mdto identify all protein interactions - Use
targets-pathways.mdto map to biological pathways - Use
chemical-analysis.mdto predict ADMET properties - Use
interactions.mdto identify potential contraindications
Installation Requirements
Python Packages
uv pip install drugbank-downloader # Core access
uv pip install bioversions # Latest version detection
uv pip install lxml # XML parsing optimization
uv pip install pandas # Data manipulation
uv pip install rdkit # Chemical informatics (for similarity)
uv pip install networkx # Network analysis (for interactions)
uv pip install scikit-learn # ML/clustering (for chemical space)
Account Setup
- Create free account at go.drugbank.com
- Accept license agreement (free for academic use)
- Obtain username and password credentials
- Configure credentials as documented in
references/data-access.md
Data Version and Reproducibility
Always specify the DrugBank version for reproducible research:
from drugbank_downloader import download_drugbank
path = download_drugbank(version='5.1.10') # Specify exact version
Document the version used in publications and analysis scripts.
Best Practices
- Credentials: Use environment variables or config files, never hardcode
- Versioning: Specify exact database version for reproducibility
- Caching: Cache parsed data to avoid re-downloading and re-parsing
- Namespaces: Handle XML namespaces properly when parsing
- Validation: Validate chemical structures with RDKit before use
- Cross-referencing: Use external identifiers (UniProt, PubChem) for integration
- Clinical Context: Always consider clinical context when interpreting interaction data
- License Compliance: Ensure proper licensing for your use case
Reference Documentation
All detailed implementation guidance is organized in modular reference files:
- references/data-access.md: Authentication, download, parsing, API access, caching
- references/drug-queries.md: XML navigation, query methods, data extraction, indexing
- references/interactions.md: DDI extraction, classification, network analysis, safety scoring
- references/targets-pathways.md: Target/enzyme/transporter extraction, pathway mapping, repurposing
- references/chemical-analysis.md: Structure extraction, similarity, fingerprints, ADMET prediction
Load these references as needed based on your specific analysis requirements.
Source
git clone https://github.com/Microck/ordinary-claude-skills/blob/main/skills_all/claude-scientific-skills/scientific-skills/drugbank-database/SKILL.mdView on GitHub Overview
DrugBank Database skill enables programmatic access to DrugBank data, including drug entries, properties, interactions, targets, pathways, chemical structures, and pharmacology. It supports data-driven drug discovery, pharmacology research, and drug interaction analysis by providing authenticated download, XML parsing, and query capabilities to build rich drug datasets.
How This Skill Works
Install the drugbank-downloader package and configure authentication via environment variables or a config file. Download the desired DrugBank version, efficiently parse the XML data, and perform queries by DrugBank ID, name, or keywords; results can be loaded into DataFrames for downstream drug info, DDIs, targets, and pathway analyses.
When to Use It
- Setting up DrugBank access, authentication, and data caching for a new project
- Retrieving detailed drug information such as identifiers, properties, and pharmacology for a specific compound
- Building and exporting a searchable drug dataset with cross references to external databases
- Analyzing drug-drug interactions and constructing interaction networks for pharmacovigilance
- Mapping drugs to targets and biological pathways for drug discovery and ADMET studies
Quick Start
- Step 1: Install and configure the drugbank-downloader package
- Step 2: Authenticate securely (env vars/config) and download the desired DB version
- Step 3: Query a drug by ID or name and export results to a DataFrame
Best Practices
- Securely manage credentials via environment variables or config files
- Cache downloaded data and use versioned updates to stay current
- Parse XML efficiently and normalize identifiers across datasets
- Filter and validate data before exporting to DataFrames
- Document data provenance and handle version changes or API updates
Example Use Cases
- A researcher downloads the latest DrugBank to populate a pharmaceutical database
- A pharmacologist reviews mechanism of action and pharmacology data for a lead compound
- DDI analysis identifies high-risk drug combinations in a polypharmacy scenario
- QSAR study uses SMILES and InChI from DrugBank for similarity searches
- Drugs targeted to specific proteins are mapped to SMPDB pathways for pathway analysis