Pubchem Database Skill

Dependencies

Install the required Python packages:

uv pip install pubchempy requests

• pubchempy (version: not pinned)
• requests (version: not pinned)

Example Usage

Primary module:

• scripts/pubchem_ops.py

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