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
npx skills add yorkeccak/scientific-skills --skill chembl-search -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/chembl-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/chembl-search/
1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a codex2Manually: put the files in place
.agents/skills/chembl-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a cursor2Manually: put the files in place
.cursor/skills/chembl-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install yorkeccak/scientific-skills skills/chembl-search2Manually: put the files in place
.github/skills/chembl-search/SKILL.md1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/yorkeccak/scientific-skills --path skills/chembl-searchManually: put the files in place
.devin/skills/chembl-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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