Skip to main content
skill CX Codex

medrxiv-search — Claude Code skill for preprint 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.

MIT 196 installs ★ 64 updated 2026-10-04

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

What medrxiv-search does

The skill sends natural-language queries to Valyu’s semantic search over medRxiv. Results can include article titles, links, full text, and images. Pipe the JSON output through jq to extract titles, URLs, or article content.

You need Node.js 18+ and a Valyu API key; the CLI uses Node.js’s built-in fetch(). If a search requests setup, save the key with scripts/search setup <api-key> and retry. Searches won’t run without the key. The skill includes a Bash wrapper, scripts/search, and a Node.js CLI, search.mjs.

What it helps with

  • find preprints reporting clinical trial outcomes
  • search epidemiology papers by research topic
  • retrieve article text rather than abstracts alone
  • extract paper titles and links from search results

Example prompts for the agent

  • Find medRxiv preprints on heart failure treatment outcomes.
  • Search for studies on factors behind vaccine hesitancy.
  • Find papers about AI in radiology diagnosis.

How to install medrxiv-search

1Skills CLI (Vercel)

npx skills add yorkeccak/scientific-skills --skill medrxiv-search -a claude-code

2Manually: put the files in place

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

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about medrxiv-search

How do I install medrxiv-search in Claude Code?

Run npx skills add yorkeccak/scientific-skills --skill medrxiv-search -a claude-code. The skill file is at ~/.claude/skills/medrxiv-search/SKILL.md.

What does medrxiv-search do?

It searches medRxiv medical preprints through Valyu using plain-language queries. Results can include full article text and images.

What do I need to search medRxiv?

You need Node.js 18+ and a Valyu API key. If setup is requested, save the key with scripts/search setup <api-key> and retry the search.

Source text

SKILL.md · MIT
---
name: medrxiv-search
description: Search medRxiv medical preprints with natural language queries. Powered by Valyu semantic search.
keywords:
  - medrxiv
  - medical-preprints
  - clinical-research
  - epidemiology
  - public-health
  - semantic-search
license: MIT
---


# medRxiv Search

Search the complete medRxiv database of medical and health sciences preprints 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 article content, not just abstracts
- **Image Links**: Includes figures and images from papers
- **Comprehensive Coverage**: Access to all medRxiv preprints in medical and health sciences

## 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
MEDRXIV_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/medrxiv-search/*/scripts/*" -type f 2>/dev/null | head -1)
```

Then use the full path for all commands:
```bash
$MEDRXIV_SCRIPT "COVID-19 vaccine efficacy" 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 medRxiv, 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

- Accessing latest medical research before journal publication
- Clinical trial results and outcomes
- Epidemiological studies and public health data
- Medical device and therapy research
- Health policy and healthcare system studies
- Rapid response research on emerging health topics
## Output Format

```json
{
  "success": true,
  "type": "medrxiv_search",
  "query": "COVID-19 vaccine efficacy",
  "result_count": 10,
  "results": [
    {
      "title": "Article Title",
      "url": "https://medrxiv.org/content/...",
      "content": "Full article text with figures...",
      "source": "medrxiv",
      "relevance_score": 0.95,
      "images": ["https://example.com/figure1.jpg"]
    }
  ],
  "cost": 0.025
}
```

## Processing Results

### With jq

```bash
# Get article 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

### Clinical Medicine

```bash
# Find clinical research
scripts/search "heart failure treatment outcomes" 50
```

### Public Health

```bash
# Search for epidemiology research
scripts/search "vaccine hesitancy determinants" 20
```

### Medical Imaging

```bash
# Find imaging studies
scripts/search "AI in radiology diagnosis" 15
```

### Infectious Disease

```bash
# Search for infectious disease papers
scripts/search "antibiotic resistance mechanisms" 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 medRxiv 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-medrxiv"],
    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-medrxiv"],
  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 Science and research →

From the same set13

The whole set →
biomedical-search biomedical-search is a Claude Code skill that searches biomedical literature, clinical trials, and FDA drug labels through Valyu. Activate it for evidence gathering across research sources. CX Codex +1 738installs pubmed-search pubmed-search is a Claude Code skill for natural-language semantic search across PubMed. It returns full article texts and figures for literature reviews. CX Codex +1 711installs patents-search patents-search searches patents worldwide from plain-language queries. Useful for prior art, technology landscapes and tracking what competitors file. CX Codex +1 641installs 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 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

Project sponsors

Companies that keep this analytics open