chembl-database-bioactivity
Query ChEMBL (2M+ compounds, 19M+ bioactivity measurements, 13K+ targets) via the public REST/JSON API with plain `requests` — no SDK install required. Search compounds, retrieve IC50/Ki/EC50 bioactivities, find target inhibitors, run SAR, access drug mechanism/indication data.
Install / Use
npx skills add jaechang-hits/SciAgent-Skills --skill chembl-database-bioactivityInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of chembl-database-bioactivity
chembl-database-bioactivity scores 91/100 on our quality scale, 224th of 599 Data & Analytics skills we index (top 38%).
Its SKILL.md is 25 KB long, well organised into 66 sections with 17 code examples: a thorough specification that gives an agent plenty to work with.
It has 367 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so chembl-database-bioactivity is actively maintained.
- Our last check on 2026-11-20 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
chembl-database-bioactivity compared with similar skills
All 4 of these similar skills score higher than chembl-database-bioactivity; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| chembl-database-bioactivity (this skill)by jaechang-hits | 91 | 367 | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 104.4k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.6k | today | MCP Server |
Frequently asked questions
- How do I install chembl-database-bioactivity?
- Run
npx skills add jaechang-hits/SciAgent-Skills --skill chembl-database-bioactivity. The install tabs above show the steps for each supported agent. - Which AI agents does chembl-database-bioactivity work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is chembl-database-bioactivity safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is chembl-database-bioactivity still maintained?
- The repository was last updated about 3 months ago, so chembl-database-bioactivity is actively maintained.
Skill content
View source on GitHubname: chembl-database-bioactivity
description: Query ChEMBL (2M+ compounds, 19M+ bioactivity measurements, 13K+ targets) via the public REST/JSON API with plain requests — no SDK install required. Search compounds, retrieve IC50/Ki/EC50 bioactivities, find target inhibitors, run SAR, access drug mechanism/indication data.
license: CC-BY-SA-3.0
ChEMBL Database — Bioactivity Queries
Why no SDK? The
chembl_webresource_clientpackage is convenient sugar over a public, no-auth REST/JSON API athttps://www.ebi.ac.uk/chembl/api/data/. When the SDK is unavailable, every operation can be reproduced with plainrequestsand URL parameters. This SKILL.md uses the REST path throughout so the code runs in any environment withrequestsinstalled. Django-style filter syntax (field__icontains=…,field__lte=…,field__range=a,b) works as URL query parameters.
Overview
ChEMBL is EMBL-EBI's bioactive molecule database: 2M+ compounds, 19M+ bioactivity measurements (IC50, Ki, EC50, Kd, …), 13K+ targets. The REST API at https://www.ebi.ac.uk/chembl/api/data/ returns JSON (append .json) or XML/YAML, requires no authentication, and supports Django-style query filters via URL parameters plus cursor-style pagination via page_meta.next.
When to Use
- Finding compounds by name, ChEMBL ID, or physicochemical properties
- Querying bioactivity data (IC50, Ki, EC50) for specific targets
- Performing similarity or substructure searches using SMILES
- Retrieving drug mechanisms of action and clinical indications
- Identifying inhibitors, agonists, or bioactive molecules for a target
- Analyzing structure-activity relationships (SAR) across compound series
- Filtering molecules by Lipinski rule-of-5 or other drug-likeness criteria
- For general cheminformatics (SMILES manipulation, fingerprints, descriptors) use
rdkit-cheminformaticsinstead - For an alternative compound database (NIH, broader coverage) use
pubchem-compound-search
Prerequisites
- Python packages:
requests(only requirement). Optional:pandasfor tabular analysis. - No API key required: ChEMBL is freely accessible.
- Rate limits: No published hard limit. The infrastructure is shared — add
time.sleep(0.2-0.5)between requests in batch loops; back off on HTTP 429.
pip install requests
# Optional, for DataFrame work:
pip install pandas
Quick Start
import requests
BASE = "https://www.ebi.ac.uk/chembl/api/data"
# Retrieve a molecule by ChEMBL ID
r = requests.get(f"{BASE}/molecule/CHEMBL25.json", timeout=15)
r.raise_for_status()
aspirin = r.json()
print(f"{aspirin['pref_name']}: MW={aspirin['molecule_properties']['mw_freebase']}")
# ASPIRIN: MW=180.16
# Search targets by full name (acronyms like 'EGFR' don't match pref_name — use full term)
r = requests.get(
f"{BASE}/target.json",
params={"pref_name__icontains": "epidermal growth factor receptor",
"target_type": "SINGLE PROTEIN", "limit": 5},
timeout=15,
)
targets = r.json()["targets"]
print(f"EGFR-like targets: {len(targets)}, first={targets[0]['target_chembl_id']}")
# Potent bioactivities: EGFR (CHEMBL203) IC50 <= 100 nM
r = requests.get(
f"{BASE}/activity.json",
params={"target_chembl_id": "CHEMBL203",
"standard_type": "IC50",
"standard_value__lte": 100,
"standard_units": "nM",
"limit": 5},
timeout=30,
)
data = r.json()
print(f"EGFR IC50 ≤ 100 nM records: {data['page_meta']['total_count']}")
Key Concepts
Filter Operators (Django-style, as URL parameters)
The SDK's field__operator=value syntax maps 1:1 to URL query parameters. Use & to combine filters.
| Operator | URL pattern | Example URL fragment |
|----------|-------------|----------------------|
| __exact | field=value | target_type=SINGLE+PROTEIN |
| __iexact | field__iexact=value | pref_name__iexact=aspirin |
| __contains / __icontains | field__icontains=value | pref_name__icontains=kinase |
| __startswith / __endswith | field__startswith=Epi | pref_name__endswith=nib |
| __gt / __gte / __lt / __lte | field__lte=100 | standard_value__lte=100 |
| __range | field__range=lo,hi | molecule_properties__mw_freebase__range=300,500 |
| __in | field__in=a,b,c | standard_type__in=IC50,Ki,Kd |
| __isnull | field__isnull=False (Python False/True strings) | pchembl_value__isnull=False |
| __regex | field__regex=… | pref_name__regex=^EGF.*kinase$ |
| __search | field__search=… | description__search=apoptosis |
When passed via requests.get(..., params={...}), the library handles URL encoding automatically (including the commas in __range and __in).
Core Endpoints
All endpoints accept .json, .xml, or .yaml suffix. JSON is the default below.
| Endpoint URL | Returns | Key fields |
|--------------|---------|------------|
| /molecule/{chembl_id}.json | Compound by ID | pref_name, molecule_chembl_id, molecule_properties, molecule_structures |
| /molecule.json?<filters> | Compound search | paginated molecules[] |
| /target/{chembl_id}.json | Target by ID | pref_name, target_type, organism, target_components |
| /target.json?<filters> | Target search | paginated targets[] |
| /activity.json?<filters> | Bioactivity records | paginated activities[] |
| /assay.json?<filters> | Assay details | paginated assays[] |
| /drug.json?<filters> | Approved drug info | paginated drugs[]; supports /drug/{chembl_id}.json |
| /mechanism.json?<filters> | Mechanism of action | paginated mechanisms[] |
| /drug_indication.json?<filters> | Therapeutic indications | paginated drug_indications[] |
| /similarity/{smiles}/{tanimoto}.json | Tanimoto similarity (0–100) | paginated molecules[] with similarity field |
| /substructure/{smiles}.json | Substructure search | paginated molecules[] |
| /image/{chembl_id}.svg | SVG structure image | binary SVG (NOT JSON) |
| /molecule_form/{chembl_id}.json | Parent/salt forms | molecule_forms[] |
| /protein_class.json | Protein classification hierarchy | hierarchical browse |
| /document.json?<filters> | Literature source records | paginated documents[] |
Response Shape
{
"page_meta": {
"limit": 20,
"offset": 0,
"total_count": 12145,
"next": "/chembl/api/data/activity.json?...&offset=20",
"previous": null
},
"activities": [ /* or molecules[], targets[], etc. */ ]
}
Walk page_meta.next (a relative URL — prefix with https://www.ebi.ac.uk) until it becomes null.
Molecular Properties
Properties accessible via molecule_properties on each record:
| Field | Description |
|-------|-------------|
| mw_freebase | Molecular weight (free base) |
| full_mwt | Full molecular weight (including salts) |
| alogp | Calculated LogP |
| hba | Hydrogen bond acceptors |
| hbd | Hydrogen bond donors |
| psa | Polar surface area |
| rtb | Rotatable bonds |
| num_ro5_violations | Lipinski rule-of-5 violations |
| ro3_pass | Rule of 3 compliance |
| cx_most_apka / cx_most_bpka | Most acidic / basic pKa |
Target Information Fields
| Field | Description |
|-------|-------------|
| target_chembl_id | ChEMBL target identifier |
| pref_name | Preferred (full) target name — acronyms like "EGFR" do NOT match; use the spelled-out term |
| target_type | SINGLE PROTEIN, PROTEIN COMPLEX, ORGANISM, … |
| organism | Target organism (e.g., Homo sapiens) |
| tax_id | NCBI taxonomy ID |
| target_components[] | Components (UniProt accession, sequence, …) |
Bioactivity Data Fields
| Field | Description |
|-------|-------------|
| standard_type | Activity type: IC50, Ki, Kd, EC50, … |
| standard_value | Numerical activity value |
| standard_units | Units: nM, uM, … |
| pchembl_value | Normalized -log10 activity (>6 = potent) |
| activity_comment | Activity annotations |
| data_validity_comment | Data quality flags (check before analysis) |
| potential_duplicate | Duplicate flag |
Core API
1. Molecule Queries
import requests
BASE = "https://www.ebi.ac.uk/chembl/api/data"
# By ChEMBL ID
r = requests.get(f"{BASE}/molecule/CHEMBL25.json", timeout=15)
aspirin = r.json()
print(f"{aspirin['pref_name']}: MW={aspirin['molecule_properties']['mw_freebase']}")
# By name (case-insensitive substring)
r = requests.get(f"{BASE}/molecule.json",
params={"pref_name__icontains": "imatinib", "limit": 5},
timeout=15)
for mol in r.json()["molecules"]:
print(f" {mol['molecule_chembl_id']} {mol.get('pref_name')!r}")
# By Lipinski-compliant property ranges
r = requests.get(f"{BASE}/molecule.json",
params={"molecule_properties__mw_freebase__range": "300,500",
"molecule_properties__alogp__lte": 5,
"molecule_properties__hba__lte": 10,
"molecule_properties__hbd__lte": 5,
"limit": 3},
timeout=15)
print(f"Lipinski-compliant total: {r.json()['page_meta']['total_count']}")
2. Target Queries
import requests
BASE = "https://www.ebi.ac.uk/chembl/api/data"
# By ChEMBL ID
r = requests.get(f"{BASE}/target/CHEMBL203.json", timeout=15)
egfr = r.json()
print(f"{egfr['pref_name']} ({egfr['organism']}) — type={egfr['target_type']}")
# Search by full name (NOT acronym) + type
r = requests.get(f"{BASE}/target.json",
params={"pref_name__icontains": "kinase",
"target_type": "SINGLE PROTEIN", "limit": 5},
timeout=15)
d = r.json()
print(f"Kinase SINGLE_PROTEIN targets: total={d['page_meta']['total_count']}")
for t in d["targets"][:5]:
print(f" {t['target_chembl_id']:12s} {t.get('pref_name')!r} ({t['organism']})")
# By organism
r = requests.get(f"{BASE}/target.json",
params={"organism": "Homo sapiens", "limit": 3},
timeout=15)
print(f"Human targets: total={r.json()['page_meta']['total_count']}")
3. Bioactivity Data
import requests
BASE = "https://www.ebi.ac.uk/chembl/api/data"
# Potent inhibitors for a target (EGFR = CHEMBL203)
r = requests.get(f"{BASE}/activity.json",
params={"target_chembl_id": "CHEMBL203",
"standard_type": "IC50",
"standard_value__lte": 100,
"standard_units": "nM",
"limit": 5},
timeout=30)
data = r.json()
print(f"EGFR IC50≤100nM: total={data['page_meta']['total_count']}")
for act in data["activities"][:5]:
print(f" {act['molecule_chembl_id']:14s} IC50={act['standard_value']} nM "
f"pChEMBL={act.get('pchembl_value')}")
# All pChEMBL-tagged activities for a compound
r = requests.get(f"{BASE}/activity.json",
params={"molecule_chembl_id": "CHEMBL25",
"pchembl_value__isnull": "False",
"limit": 5},
timeout=30)
print(f"Aspirin pChEMBL activities: total={r.json()['page_meta']['total_count']}")
# Multiple activity types (CHEMBL240 = D2 dopamine receptor)
r = requests.get(f"{BASE}/activity.json",
params={"target_chembl_id": "CHEMBL240",
"standard_type__in": "IC50,Ki,Kd",
"limit": 5},
timeout=30)
print(f"D2 receptor IC50/Ki/Kd: total={r.json()['page_meta']['total_count']}")
4. Structure-Based Search
import requests
from urllib.parse import quote
BASE = "https://www.ebi.ac.uk/chembl/api/data"
# Similarity search (Tanimoto ≥ 85%)
# Path-style endpoint: /similarity/{smiles}/{threshold}
# The SMILES MUST be URL-encoded (it contains '/', '(', ')' etc.)
aspirin_smiles = quote("CC(=O)Oc1ccccc1C(=O)O", safe="")
r = requests.get(f"{BASE}/similarity/{aspirin_smiles}/
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
80.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
104.4k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.6kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
