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
npx skills add yorkeccak/scientific-skills --skill medrxiv-search -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/medrxiv-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/medrxiv-search/
1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill medrxiv-search -a codex2Manually: put the files in place
.agents/skills/medrxiv-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill medrxiv-search -a cursor2Manually: put the files in place
.cursor/skills/medrxiv-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install yorkeccak/scientific-skills skills/medrxiv-search2Manually: put the files in place
.github/skills/medrxiv-search/SKILL.md1Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill medrxiv-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/yorkeccak/scientific-skills --path skills/medrxiv-searchManually: put the files in place
.devin/skills/medrxiv-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add yorkeccak/scientific-skills --skill medrxiv-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 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