chembl-search — скилл для Claude Code: поиск по ChEMBL
Скилл chembl-search для Claude Code ищет биоактивные соединения и данные анализов в ChEMBL по запросам обычным языком. Ищет соединения по мишени и изучает биологическую активность.
MIT 128 установок ★ 64 обновлён 2026-10-04
npx skills add yorkeccak/scientific-skills --skill chembl-search -a claude-codeЧто делает chembl-search
Скилл передаёт запрос в семантический поиск Valyu и возвращает сведения о соединениях, мишенях и результатах анализов в JSON. В результатах могут быть ссылки на структуры молекул и визуализации; поля можно извлечь через jq. Скрипт состоит из Bash-обёртки scripts/search и CLI на Node.js scripts/search.mjs, который обращается к API через встроенный fetch.
Для работы нужны Node.js 18+ и API-ключ Valyu. Если поиск сообщает setup_required, ключ настраивают командой scripts/search setup <api-key>, затем повторяют запрос. Без ключа Valyu поиск не запустится. Перед запуском нужно найти скрипт в каталоге установки скилла: в документации для этого приведена команда find по кэшу плагинов Claude Code.
Какие задачи решает
- найти соединения по биологической мишени
- получить результаты анализов и данные о связывании
- отыскать соединения с нужной активностью
- изучить связь структуры соединения с активностью
Примеры запросов агенту
- Найди ингибиторы JAK2 для миелофиброза и верни результаты в JSON.
- Поищи анализы связывания протеинкиназы B.
- Найди производные бензимидазола с противоопухолевой активностью.
Как установить chembl-search
1Через Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a claude-code2Вручную: положить файлы
~/.claude/skills/chembl-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/chembl-search/
1Через Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a codex2Вручную: положить файлы
.agents/skills/chembl-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a cursor2Вручную: положить файлы
.cursor/skills/chembl-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install yorkeccak/scientific-skills skills/chembl-search2Вручную: положить файлы
.github/skills/chembl-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/yorkeccak/scientific-skills --path skills/chembl-searchВручную: положить файлы
.devin/skills/chembl-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill chembl-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о chembl-search
Как установить chembl-search в Claude Code?
Выполните npx skills add yorkeccak/scientific-skills --skill chembl-search -a claude-code. Файл скилла появится по пути ~/.claude/skills/chembl-search/SKILL.md.
Что делает chembl-search?
Он ищет в ChEMBL биоактивные соединения и сведения о мишенях и анализах по запросу обычным языком. Результаты возвращаются в JSON.
Что нужно для работы chembl-search?
Нужны Node.js 18+ и API-ключ Valyu. Если скрипт запросит настройку, выполните scripts/search setup <api-key> и повторите поиск.
Исходный текст
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