gtopdb-database
Query IUPHAR/BPS Guide to Pharmacology (GtoPdb) for receptor-ligand interactions, target/ligand metadata, families, and approved drugs. Affinities (pKi/pIC50/pKd), action (Agonist/Antagonist/etc.), species, structures (SMILES/InChI). No auth. Always resolve targets via geneSymbol/accession; most metadata lives in sub-resources (/databaseLinks, /structure, /synonyms).
npx skills add BioTender-max/awesome-bio-agent-skills --skill gtopdb-database --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Guide to Pharmacology (GtoPdb) Database ## Overview The IUPHAR/BPS Guide to Pharmacology (GtoPdb) catalogues drug targets, ligands, and quantitative interactions across receptor pharmacology. The web services REST API at `https://www.guidetopharmacology.org/services/` returns JSON for targets, ligands, interactions, and family hierarchies. Base records are intentionally lean — gene symbols, UniProt accessions, ChEMBL IDs, SMILES/InChI all live in sub-resources (`/targets/{id}/databaseLinks`, `/targets/{id}/synonyms`, `/ligands/{id}/structure`, `/ligands/{id}/databaseLinks`). No authentication required. ## When to Use - Looking up the affinity (pKi/pIC50/pKd) of a ligand at a specific target - Listing all annotated ligands for a receptor (e.g., μ-opioid receptor / OPRM1) - Finding the approval status of a ligand (`approved=true`) and its cross-references (PubChem CID, ChEMBL ID, DrugBank ID) - Retrieving the IUPHAR family hierarchy (867 families) for receptor classification - Pulling structure descriptors (SMILES, InChI, InChIKey) for chemoinformatics - Mapping HGNC symbol → UniProt → GtoPdb target ID for cross-database integration - Use `chembl-database-bioactivity` for larger bi
- Overview
- When to Use
- Prerequisites
- Quick Start
- Core API
- Query 1: Resolve a Target (HGNC symbol or UniProt accession)
- Query 2: Target Cross-References and Synonyms
- Query 3: Target Interactions and Affinities
- Query 4: Ligand Lookup and Structure
- Query 5: Family Hierarchy
- Query 6: Approved Drugs (Server-Side Alias)
- Key Concepts
- Base Records vs Sub-Resources
- geneSymbol= and accession= are Exact-Match
pip install requests pandas matplotlib
What does the gtopdb-database skill do?
Query IUPHAR/BPS Guide to Pharmacology (GtoPdb) for receptor-ligand interactions, target/ligand metadata, families, and approved drugs. Affinities (pKi/pIC50/pKd), action (Agonist/Antagonist/etc.), species, structures (SMILES/InChI). No auth. Always resolve targets via geneSymbol/accession; most metadata lives in sub-resources (/databaseLinks, /structure, /synonyms).
How do I install it?
Run `npx skills add BioTender-max/awesome-bio-agent-skills --skill gtopdb-database --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From BioTender-max/awesome-bio-agent-skills, a repository with 135 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.