Source: https://github.com/aipoch/medical-research-skills
When to Use
- You need to search for chemical compounds by name, CID, SMILES, InChI, or molecular formula.
- You want to retrieve physicochemical properties (e.g., molecular weight, LogP, TPSA, H-bond donors/acceptors).
- You need to perform structure-based searches, such as similarity or substructure queries.
- You want to obtain bioactivity data (e.g., assay summaries, target information) for a given compound.
- You are building an automated cheminformatics or drug discovery workflow that requires programmatic access to PubChem.
Key Features
Flexible compound search by name, CID, SMILES, InChI, or formula.
Property retrieval via PubChem PUG-REST and PubChemPy (e.g., MW, LogP, Canonical SMILES).
Structure search:
- Similarity search
- Substructure search
Bioactivity retrieval linked to PubChem BioAssay records.
Rate-limit aware implementation (respects PubChem’s limit of max 5 requests/sec).
Python function interface for seamless integration into scientific pipelines.
Dependencies
Install the required Python packages:
uv pip install pubchempy requests
pubchempy (version: not pinned)
requests (version: not pinned)
Example Usage
Primary module:
1) Get compound properties
python -c "from scripts.pubchem_ops import get_properties; print(get_properties(query_value='Aspirin', query_type='name'))"
Or in Python:
from scripts.pubchem_ops import get_properties
result = get_properties(query_value="Aspirin", query_type="name")
print(result)
2) Structure search (similarity)
python -c "from scripts.pubchem_ops import structure_search; print(structure_search(query_value='CC(=O)OC1=CC=CC=C1C(=O)O', search_type='similarity'))"
Or in Python:
from scripts.pubchem_ops import structure_search
smiles = "CC(=O)OC1=CC=CC=C1C(=O)O"
result = structure_search(query_value=smiles, search_type="similarity")
print(result)
3) Get bioactivity data
python -c "from scripts.pubchem_ops import get_bioactivity; print(get_bioactivity(cid=2244))"
Or in Python:
from scripts.pubchem_ops import get_bioactivity
result = get_bioactivity(cid=2244)
print(result)
Implementation Details
Primary script: scripts/pubchem_ops.py
Data sources / endpoints:
- Compound & properties:
pubchem.ncbi.nlm.nih.gov/rest/pug
- Bioactivity: PubChem BioAssay endpoints
- Python wrapper:
PubChemPy
Supported operations:
get_properties: retrieve physicochemical properties by name/CID/SMILES/InChI/formula.
structure_search: perform similarity or substructure search.
get_bioactivity: retrieve assay and bioactivity-related data by CID.
Input constraints:
query_type must match supported types (e.g., name, cid, smiles, inchi, formula).
search_type must be similarity or substructure.
Error handling:
- Returns structured error or
None if compound is not found.
- Handles PubChem rate limits (≤ 5 requests/sec).
Troubleshooting considerations:
- Ensure network access to
pubchem.ncbi.nlm.nih.gov.
- Verify query format (e.g., valid SMILES or InChI) if results are empty.
Additional reference:
- API documentation pointers:
references/api_reference.md
1---
2name: pubchem-database-skill
3description: Programmatic access to the PubChem database (via PUG-REST API and PubChemPy) for searching chemical compounds, retrieving physicochemical properties, performing structure similarity/substructure searches, and obtaining bioactivity data.
4license: MIT
5author: AIPOCH
6metadata:
7 source: https://skillmd.com/skills/aipoch/pubchem-database-skill
8---
9
10> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)
11
12## When to Use
13
14* You need to **search for chemical compounds** by name, CID, SMILES, InChI, or molecular formula.
15* You want to **retrieve physicochemical properties** (e.g., molecular weight, LogP, TPSA, H-bond donors/acceptors).
16* You need to **perform structure-based searches**, such as similarity or substructure queries.
17* You want to **obtain bioactivity data** (e.g., assay summaries, target information) for a given compound.
18* You are building an automated cheminformatics or drug discovery workflow that requires **programmatic access to PubChem**.
19
20## Key Features
21
22* **Flexible compound search** by name, CID, SMILES, InChI, or formula.
23* **Property retrieval** via PubChem PUG-REST and PubChemPy (e.g., MW, LogP, Canonical SMILES).
24* **Structure search**:
25
26 * Similarity search
27 * Substructure search
28* **Bioactivity retrieval** linked to PubChem BioAssay records.
29* **Rate-limit aware implementation** (respects PubChem’s limit of max 5 requests/sec).
30* **Python function interface** for seamless integration into scientific pipelines.
31
32## Dependencies
33
34Install the required Python packages:
35
36```bash
37uv pip install pubchempy requests
38```
39
40* `pubchempy` (version: not pinned)
41* `requests` (version: not pinned)
42
43## Example Usage
44
45Primary module:
46
47* `scripts/pubchem_ops.py`
48
49### 1) Get compound properties
50
51```bash
52python -c "from scripts.pubchem_ops import get_properties; print(get_properties(query_value='Aspirin', query_type='name'))"
53```
54
55Or in Python:
56
57```python
58from scripts.pubchem_ops import get_properties
59
60result = get_properties(query_value="Aspirin", query_type="name")
61print(result)
62```
63
64### 2) Structure search (similarity)
65
66```bash
67python -c "from scripts.pubchem_ops import structure_search; print(structure_search(query_value='CC(=O)OC1=CC=CC=C1C(=O)O', search_type='similarity'))"
68```
69
70Or in Python:
71
72```python
73from scripts.pubchem_ops import structure_search
74
75smiles = "CC(=O)OC1=CC=CC=C1C(=O)O"
76result = structure_search(query_value=smiles, search_type="similarity")
77print(result)
78```
79
80### 3) Get bioactivity data
81
82```bash
83python -c "from scripts.pubchem_ops import get_bioactivity; print(get_bioactivity(cid=2244))"
84```
85
86Or in Python:
87
88```python
89from scripts.pubchem_ops import get_bioactivity
90
91result = get_bioactivity(cid=2244)
92print(result)
93```
94
95## Implementation Details
96
97* **Primary script**: `scripts/pubchem_ops.py`
98* **Data sources / endpoints**:
99
100 * Compound & properties: `pubchem.ncbi.nlm.nih.gov/rest/pug`
101 * Bioactivity: PubChem BioAssay endpoints
102 * Python wrapper: `PubChemPy`
103* **Supported operations**:
104
105 * `get_properties`: retrieve physicochemical properties by name/CID/SMILES/InChI/formula.
106 * `structure_search`: perform similarity or substructure search.
107 * `get_bioactivity`: retrieve assay and bioactivity-related data by CID.
108* **Input constraints**:
109
110 * `query_type` must match supported types (e.g., `name`, `cid`, `smiles`, `inchi`, `formula`).
111 * `search_type` must be `similarity` or `substructure`.
112* **Error handling**:
113
114 * Returns structured error or `None` if compound is not found.
115 * Handles PubChem rate limits (≤ 5 requests/sec).
116* **Troubleshooting considerations**:
117
118 * Ensure network access to `pubchem.ncbi.nlm.nih.gov`.
119 * Verify query format (e.g., valid SMILES or InChI) if results are empty.
120* **Additional reference**:
121
122 * API documentation pointers: `references/api_reference.md`
123