Skip to main content
skill CX Codex

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

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

What 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-code

2Manually: put the files in place

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

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

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

Similar skills

All skills for AI and ML →

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 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 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. CX Codex +1 128installs

Project sponsors

Companies that keep this analytics open