drugbank-search — Claude Code skill: 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.
MIT 136 installs ★ 64 updated 2026-10-04
npx skills add yorkeccak/scientific-skills --skill drugbank-search -a claude-codeWhat drugbank-search does
The skill sends a natural-language query to Valyu’s semantic search for DrugBank. Results arrive as JSON and can include drug details, source links, and molecular structure images. Ask about pharmacokinetics, adverse effects, or drug targets.
Its implementation has a Bash wrapper at scripts/search and a Node.js CLI in search.mjs. The CLI calls the API with Node’s built-in fetch; it requires Node.js 18+ and a Valyu API key. Without the key, the search cannot run. Use jq to extract fields from the JSON output.
What it helps with
- look up a drug’s pharmacokinetics
- check interactions involving CYP3A4 inhibitors
- research how a drug class works
- find drugs that act on a specified target
Example prompts for the agent
- Find DrugBank information about metformin pharmacokinetics.
- Check drug interactions involving CYP3A4 inhibitors.
- Find medicines that target the BCR-ABL protein.
How to install drugbank-search
1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill drugbank-search -a claude-code2Manually: put the files in place
~/.claude/skills/drugbank-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/drugbank-search/
1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill drugbank-search -a codex2Manually: put the files in place
.agents/skills/drugbank-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill drugbank-search -a cursor2Manually: put the files in place
.cursor/skills/drugbank-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install yorkeccak/scientific-skills skills/drugbank-search2Manually: put the files in place
.github/skills/drugbank-search/SKILL.md1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill drugbank-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/yorkeccak/scientific-skills --path skills/drugbank-searchManually: put the files in place
.devin/skills/drugbank-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill drugbank-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 drugbank-search
How do I install drugbank-search in Claude Code?
Run npx skills add yorkeccak/scientific-skills --skill drugbank-search -a claude-code. The skill file is at ~/.claude/skills/drugbank-search/SKILL.md.
What does drugbank-search do?
It searches DrugBank from a plain-language query and returns JSON with drug information and links. Results can also include images.
What does drugbank-search need to run?
It requires Node.js 18+ and a Valyu API key. The CLI uses Node’s built-in fetch.
Source text
SKILL.md · MIT
---
name: drugbank-search
description: Search DrugBank comprehensive drug database with natural language queries. Drug mechanisms, interactions, and safety data powered by Valyu.
keywords:
- drugbank
- drugs
- pharmacology
- drug-interactions
- adverse-reactions
- semantic-search
license: MIT
---
# DrugBank Search
Search the complete DrugBank database of drug information including mechanisms of action, interactions, targets, and pharmacology 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 drug information including mechanisms, interactions, and targets
- **Image Links**: Includes molecular structures and data visualizations
- **Comprehensive Coverage**: Access to all DrugBank drug data
## 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
DRUGBANK_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/drugbank-search/*/scripts/*" -type f 2>/dev/null | head -1)
```
Then use the full path for all commands:
```bash
$DRUGBANK_SCRIPT "ACE 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 DrugBank, 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
- Comprehensive drug information lookup
- Drug interactions and side effects research
- Target identification and validation
- Mechanism of action studies
- Pharmacokinetics and pharmacodynamics research
- Drug metabolism and adverse event data
## Output Format
```json
{
"success": true,
"type": "drugbank_search",
"query": "ACE inhibitors",
"result_count": 10,
"results": [
{
"title": "Drug Name",
"url": "https://drugbank.com/...",
"content": "Drug information, mechanism, interactions...",
"source": "drugbank",
"relevance_score": 0.95,
"images": ["https://example.com/structure.png"]
}
],
"cost": 0.025
}
```
## Processing Results
### With jq
```bash
# Get drug names
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 Information
```bash
# Find drug details
scripts/search "metformin pharmacokinetics" 50
```
### Drug Interactions
```bash
# Search for interactions
scripts/search "CYP3A4 inhibitor drug interactions" 20
```
### Mechanism Research
```bash
# Find mechanism data
scripts/search "selective serotonin reuptake inhibitors mechanism" 15
```
### Target Identification
```bash
# Search for drug targets
scripts/search "drugs targeting BCR-ABL fusion protein" 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 DrugBank 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-drugbank"],
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-drugbank"],
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