Skip to main content
skill CX Codex

chembl-search — Claude Code skill: ChEMBL search

chembl-search is a skill that searches ChEMBL for bioactive compounds and assay data from natural-language queries, supporting target-based searches and research into biological activity.

MIT 128 installs ★ 64 updated 2026-10-04

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add yorkeccak/scientific-skills --skill chembl-search -a claude-code
Open on GitHub

What chembl-search does

The skill sends a query to Valyu semantic search and returns JSON with compound, target, and assay information. Results can include links to molecular structures and visualizations, and jq can extract fields from the response. The tool consists of a Bash wrapper, scripts/search, and a Node.js CLI, scripts/search.mjs, which calls the API with built-in fetch.

You need Node.js 18+ and a Valyu API key. If a search returns setup_required, configure the key with scripts/search setup <api-key> and retry. The search cannot run without the Valyu key. Before running it, locate the script in the skill’s installation directory; the instructions give a find command that searches the Claude Code plugin cache.

What it helps with

  • find compounds by biological target
  • retrieve assay and binding data
  • search for compounds with a specified activity
  • investigate structure-activity relationships

Example prompts for the agent

  • Find JAK2 inhibitors for myelofibrosis and return the results as JSON.
  • Search for protein kinase B binding assays.
  • Find benzimidazole derivatives with anticancer activity.

How to install chembl-search

1Skills CLI (Vercel)

npx skills add yorkeccak/scientific-skills --skill chembl-search -a claude-code

2Manually: put the files in place

~/.claude/skills/chembl-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/chembl-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about chembl-search

How do I install chembl-search in Claude Code?

Run npx skills add yorkeccak/scientific-skills --skill chembl-search -a claude-code. The skill file is placed at ~/.claude/skills/chembl-search/SKILL.md.

What does chembl-search do?

It searches ChEMBL for bioactive compounds, targets, and assay information from natural-language queries. Results are returned as JSON.

What does chembl-search need to run?

It requires Node.js 18+ and a Valyu API key. If the script requests setup, run scripts/search setup <api-key> and retry the search.

Source text

SKILL.md · MIT
---
name: chembl-search
description: Search ChEMBL bioactive molecules database with natural language queries. Find compounds and assay data with Valyu semantic search.
keywords:
  - chembl
  - drug-discovery
  - bioactive-compounds
  - molecular-database
  - hit-identification
  - semantic-search
license: MIT
---


# ChEMBL Search

Search the complete ChEMBL database of bioactive molecules, drug targets, and binding data using natural language queries powered by Valyu's semantic search API.

## Why This Skill is Powerful

- **No API Parameter Parsing**: Just pass natural language queries directly - no need to construct complex search parameters
- **Semantic Search**: Understands the meaning of your query, not just keyword matching
- **Full-Text Access**: Returns complete compound and target information
- **Image Links**: Includes molecular structures and data visualizations
- **Comprehensive Coverage**: Access to all ChEMBL bioactive molecule data for drug discovery

## Requirements

1. Node.js 18+ (uses built-in fetch)
2. Valyu API key from https://platform.valyu.ai ($10 free credits)

## CRITICAL: Script Path Resolution

The `scripts/search` commands in this documentation are relative to this skill's installation directory.

Before running any command, locate the script using:

```bash
CHEMBL_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/chembl-search/*/scripts/*" -type f 2>/dev/null | head -1)
```

Then use the full path for all commands:
```bash
$CHEMBL_SCRIPT "kinase inhibitors" 15
```

## API Key Setup Flow

When you run a search and receive `"setup_required": true`, follow this flow:

1. **Ask the user for their API key:**
   "To search ChEMBL, I need your Valyu API key. Get one free ($10 credits) at https://platform.valyu.ai"

2. **Once the user provides the key, run:**
   ```bash
   scripts/search setup <api-key>
   ```

3. **Retry the original search.**

## When to Use This Skill

- Finding bioactive compounds for drug discovery
- Target-based compound searching
- Compound property optimization
- Assay data and biological activity research
- Structure-activity relationship studies
- Lead compound identification
## Output Format

```json
{
  "success": true,
  "type": "chembl_search",
  "query": "kinase inhibitors",
  "result_count": 10,
  "results": [
    {
      "title": "Compound/Assay Title",
      "url": "https://chembl.org/...",
      "content": "Compound data, targets, assay results...",
      "source": "chembl",
      "relevance_score": 0.95,
      "images": ["https://example.com/structure.png"]
    }
  ],
  "cost": 0.025
}
```

## Processing Results

### With jq

```bash
# Get compound titles
scripts/search "query" 10 | jq -r '.results[].title'

# Get URLs
scripts/search "query" 10 | jq -r '.results[].url'

# Extract full content
scripts/search "query" 10 | jq -r '.results[].content'
```

## Common Use Cases

### Drug Discovery

```bash
# Find lead compounds
scripts/search "JAK2 selective inhibitors for myelofibrosis" 50
```

### Target Validation

```bash
# Search for target information
scripts/search "protein kinase B binding assays" 20
```

### SAR Analysis

```bash
# Find structure-activity relationships
scripts/search "benzimidazole derivatives anticancer activity" 15
```

### Mechanism Research

```bash
# Search for mechanism data
scripts/search "allosteric modulators of NMDA receptors" 25
```


## Error Handling

All commands return JSON with `success` field:

```json
{
  "success": false,
  "error": "Error message"
}
```

Exit codes:
- `0` - Success
- `1` - Error (check JSON for details)

## API Endpoint

- Base URL: `https://api.valyu.ai/v1`
- Endpoint: `/search`
- Authentication: X-API-Key header

## Architecture

```
scripts/
├── search          # Bash wrapper
└── search.mjs      # Node.js CLI
```

Direct API calls using Node.js built-in `fetch()`, zero external dependencies.

## Adding to Your Project

If you're building an AI project and want to integrate ChEMBL Search directly into your application, use the Valyu SDK:

### Python Integration

```python
from valyu import Valyu

client = Valyu(api_key="your-api-key")

response = client.search(
    query="your search query here",
    included_sources=["valyu/valyu-chembl"],
    max_results=20
)

for result in response["results"]:
    print(f"Title: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"Content: {result['content'][:500]}...")
```

### TypeScript Integration

```typescript
import { Valyu } from "valyu-js";

const client = new Valyu("your-api-key");

const response = await client.search({
  query: "your search query here",
  includedSources: ["valyu/valyu-chembl"],
  maxResults: 20
});

response.results.forEach((result) => {
  console.log(`Title: ${result.title}`);
  console.log(`URL: ${result.url}`);
  console.log(`Content: ${result.content.substring(0, 500)}...`);
});
```

See the [Valyu docs](https://docs.valyu.ai) for full integration examples and SDK reference.

© yorkeccak · MIT · yorkeccak/scientific-skills

Similar skills

All skills for Science and research →

From the same set13

The whole set →
literature-search literature-search — a Claude Code skill that queries PubMed, arXiv, bioRxiv and medRxiv together using plain-language phrases. One command returns full texts, figures and relevance scores from all four databases. CX Codex +1 605installs medrxiv-search medrxiv-search is a Claude Code skill that searches medRxiv medical preprints with plain-language queries and retrieves full article text. It supports searches for clinical and epidemiological research. CX Codex +1 196installs clinical-trials-search clinical-trials-search searches ClinicalTrials.gov using natural language queries via Valyu semantic search API. CX Codex +1 174installs drug-discovery-search drug-discovery-search is a Claude Code skill for natural-language searches of compounds, targets, and drug information. It supports target research, compound optimization, and safety assessment. CX Codex +1 169installs biorxiv-search biorxiv-search is a Claude Code skill that searches bioRxiv preprints using natural-language queries. It returns full texts, figures, and relevance scores. CX Codex +1 150installs drug-labels-search drug-labels-search is a skill for Claude Code that searches official FDA drug labels via the Valyu API, returning relevant sections for natural-language queries. CX Codex +1 137installs drugbank-search drugbank-search is a Claude Code skill that searches DrugBank for medicines, interactions, mechanisms of action, and targets. It answers plain-language questions about these topics. CX Codex +1 136installs open-targets-search open-targets-search — a skill that asks Open Targets about drug-disease associations in plain language, with Valyu handling the semantic search. Handy when you want target evidence without assembling API parameters. CX Codex +1 130installs

Project sponsors

Companies that keep this analytics open