qsong-github/drugclaw/chebi

ChEBI Query Skill

Search the ChEBI 2.0 REST API by any entity. Auto-detects input type:

API

Lower-level helpers (called internally):

search_batch() automatically uses the efficient batch endpoint when all queries are ChEBI IDs; otherwise it iterates with a 0.3 s delay.

Usage

See if __name__ == "__main__" block in 64_ChEBI.py for runnable examples covering: single ID lookup, name search, formula search, batch ID search, mixed batch search, and JSON output.

Key Fields Returned

Top-level: chebi_accession, name, ascii_name, definition, stars (curation quality; 3 = fully curated), secondary_ids, is_released.

chemical_data (nested dict): formula, charge, mass, monoisotopic_mass.

default_structure (nested dict): smiles, standard_inchi, standard_inchi_key, wurcs.

names (nested dict by type): keys like IUPAC NAME, SYNONYM, BRAND NAME, UNIPROT NAME; each value is a list of name objects.

ontology_relations: incoming_relations and outgoing_relations, each a list of {init_id, init_name, relation_type, final_id, final_name}.

database_accessions (nested dict by type): CAS, MANUAL_X_REF, REGISTRY_NUMBER, CITATION; cross-refs to DrugBank, KEGG, HMDB, PubChem, PDBeChem, Wikipedia, etc.

roles_classification: list of role dicts with chebi_accession, name, definition, biological_role (bool), application (bool), chemical_role (bool).

Data Source

• Database: ChEBI 2.0 (EMBL-EBI), >195,000 molecular entities
• API base: https://www.ebi.ac.uk/chebi/backend/api/public/
• Docs: <https://www.ebi.ac.uk/chebi/backend/api/docs/>
• License: CC BY 4.0
• Citation: Bento et al. Nucleic Acids Res. 2025, 54(D1), D1768–D1774.