Eir-Space/skills/us-medications

US Medications Skill

Look up US FDA medication information including uses, warnings, and drug interactions.

Data Source

• FDA Drug Labels: Official medication information from the US Food and Drug Administration
• 81,212 medications in the full database
• 100 curated common medications with instant access (no download needed)

Usage

Command Line

# Look up a medication (uses curated data, falls back to full database)
us-medications "lisinopril"

# Search for medications (partial match)
us-medications --search "blood pressure"

# Look up drug interactions
us-medications --interactions "warfarin"

# Show database statistics
us-medications --stats

# Download full database (happens automatically on first full lookup)
us-medications --download

# List common curated medications
us-medications --list

# Help
us-medications --help

JavaScript API

const {
  lookupMedication,
  searchMedications,
  lookupInteractions,
  downloadDatabase,
  getDatabaseStats,
  CURATED_MEDICATIONS,
} = require('us-medications');

// Look up a specific medication
const med = await lookupMedication('metformin');
console.log(med.uses, med.warnings);

// Search for medications
const results = await searchMedications('diabetes');
results.forEach((m) => console.log(m.name));

// Get drug interactions
const interactions = await lookupInteractions('lisinopril');

// Check if full database is available
const stats = await getDatabaseStats();
console.log(`${stats.totalMedications} medications available`);

Installation

npm (recommended)

npm install -g us-medications

The full database (~7.5MB compressed) downloads automatically on first use.

URL-based (OpenClaw)

https://birgermoell.github.io/us-medications/skill.md

Output Format

Each medication includes:

• name: Brand/generic name
• altNames: Alternative names
• substances: Active ingredients
• form: Dosage form (oral, injection, etc.)
• rx: Prescription required (true/false)
• uses: FDA-approved indications
• warnings: Safety information and contraindications
• interactions: Drug-drug interactions (when available)

Data Management

The full database is stored in ~/.us-medications/:

• medications.json - Main medication database
• interactions.json - Drug interaction data

To refresh data:

us-medications --download --force

Common Medication Categories

Cardiovascular

• Lisinopril, Metoprolol, Amlodipine, Losartan, Atorvastatin

Diabetes

• Metformin, Insulin (various), Glipizide, Januvia

Pain/Inflammation

• Ibuprofen, Acetaminophen, Naproxen, Tramadol

Mental Health

• Sertraline, Escitalopram, Alprazolam, Trazodone

Antibiotics

• Amoxicillin, Azithromycin, Ciprofloxacin, Doxycycline

Disclaimer

This tool provides FDA label information for educational purposes. Always consult a healthcare professional for medical advice. Do not use this tool for self-diagnosis or treatment decisions.