chem-similarity-search

Query PubChem's fastsimilarity_2d engine for structurally similar compounds from SMILES or CID.

144|21|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill chem-similarity-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chem-similarity-search
Source: https://github.com/learningmatter-mit/AtomisticSkills/tree/main/.agents/skills/chem-similarity-search
Command: npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill chem-similarity-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires urllib, json, pathlib, time, argparse, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you discover structurally similar chemical compounds for a given target molecule so you can identify analogs, alternative precursors, and candidate replacements.

Core Features & Use Cases

  • PubChem 2D fast similarity search: Queries PubChem’s fastsimilarity_2d endpoint to rank related compounds by 2D molecular fingerprint similarity.
  • SMILES- or CID-based querying: Accepts either a SMILES string or an exact PubChem CID to reduce input friction and parsing ambiguity.
  • Structured results export: Saves matched compounds with CID, canonical/absolute SMILES, IUPAC name, formula, molecular weight, and PubChem URLs for downstream selection.

Quick Start

Ask the skill to search PubChem for compounds similar to aspirin using CID 2244 with a similarity threshold of 95 and save the top 5 matches to your chosen output folder.

Frequently Asked Questions about chem-similarity-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find structurally similar compounds on PubChem using a SMILES string?

To find structurally similar compounds, provide a SMILES string or PubChem CID to query the PubChem fastsimilarity_2d engine. The search ranks chemical analogs by 2D molecular fingerprint similarity and returns matched compounds with metadata like canonical SMILES and IUPAC names.

Can I set a custom similarity threshold for PubChem chemical similarity searches?

Yes, you can configure a custom similarity threshold and maximum record count for PubChem chemical similarity searches. This allows you to control the stringency of the 2D fingerprint matching and limit the number of ranked analogs returned for your lead optimization workflow.

What data format does PubChem similarity search export for downstream screening?

PubChem similarity search results export as JSON files containing compound metadata for downstream screening. Each record includes the PubChem CID, canonical and absolute SMILES, IUPAC name, molecular formula, molecular weight, and PubChem URLs.

Does PubChem PUG-REST support 2D similarity searches for lead optimization workflows?

Yes, PubChem PUG-REST supports 2D similarity searches via the fastsimilarity_2d endpoint for lead optimization workflows. It requires HTTP access to PubChem and accepts either a SMILES string or an exact PubChem CID to generate ranked candidate analog lists.

What is the best way to identify chemical analogs from a known PubChem CID?

The best way to identify chemical analogs from a known PubChem CID is to query the PubChem fastsimilarity_2d engine. It ranks related compounds by 2D molecular fingerprint similarity and outputs structured JSON with compound metadata for hypothesis generation and candidate replacement.

What are the limitations of using PubChem 2D fast similarity for candidate search?

A limitation of PubChem 2D fast similarity for candidate search is that it requires HTTP access to the PUG-REST API. It also relies entirely on 2D molecular fingerprint matching, which may not capture full 3D pharmacological properties, and returns results bounded by your configured maximum record limit.