medrxiv-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

medRxiv Search

medRxiv 搜索

Search the complete medRxiv database of medical and health sciences preprints using natural language queries powered by Valyu's semantic search API.

使用由Valyu语义搜索API提供支持的自然语言查询，搜索完整的medRxiv医学与健康科学预印本数据库。

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

无需解析API参数：直接传入自然语言查询即可，无需构建复杂的搜索参数
语义搜索：理解查询的含义，而非仅进行关键词匹配
全文访问：返回完整的文章内容，而非仅摘要
图片链接：包含论文中的图表和图片
全面覆盖：可访问medRxiv中所有医学与健康科学领域的预印本

Requirements

要求

Node.js 18+ (uses built-in fetch)
Valyu API key from https://platform.valyu.ai ($10 free credits)

Node.js 18+（使用内置的fetch）
从https://platform.valyu.ai获取Valyu API密钥（赠送10美元免费额度）

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

本文档中的

scripts/search

命令是相对于该工具的安装目录的。

在运行任何命令之前，请使用以下命令定位脚本：

bash

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

然后使用完整路径执行所有命令：

bash

$MEDRXIV_SCRIPT "COVID-19 vaccine efficacy" 15

API Key Setup Flow

API密钥设置流程

When you run a search and receive

"setup_required": true

, follow this flow:

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"
Once the user provides the key, run:
bash
```
scripts/search setup <api-key>
```
Retry the original search.

当你运行搜索并收到

"setup_required": true

时，请按照以下流程操作：

向用户索要API密钥： "要搜索medRxiv，我需要你的Valyu API密钥。可在https://platform.valyu.ai免费获取（含10美元额度）"
用户提供密钥后，运行以下命令：
bash
```
scripts/search setup <api-key>
```
重试原搜索。

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
}

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

使用jq

bash

undefined

bash

undefined

Get article titles

获取文章标题

scripts/search "query" 10 | jq -r '.results[].title'

Get URLs

获取URL

scripts/search "query" 10 | jq -r '.results[].url'

Extract full content

提取完整内容

scripts/search "query" 10 | jq -r '.results[].content'

undefined

scripts/search "query" 10 | jq -r '.results[].content'

undefined

Common Use Cases

常见使用案例

Clinical Medicine

临床医学

bash

undefined

bash

undefined

Find clinical research

查找临床研究

scripts/search "heart failure treatment outcomes" 50

undefined

scripts/search "heart failure treatment outcomes" 50

undefined

Public Health

公共卫生

bash

undefined

bash

undefined

Search for epidemiology research

搜索流行病学研究

scripts/search "vaccine hesitancy determinants" 20

undefined

scripts/search "vaccine hesitancy determinants" 20

undefined

Medical Imaging

医学影像

bash

undefined

bash

undefined

Find imaging studies

查找影像研究

scripts/search "AI in radiology diagnosis" 15

undefined

scripts/search "AI in radiology diagnosis" 15

undefined

Infectious Disease

传染病学

bash

undefined

bash

undefined

Search for infectious disease papers

搜索传染病相关论文

scripts/search "antibiotic resistance mechanisms" 25

undefined

scripts/search "antibiotic resistance mechanisms" 25

undefined

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)

所有命令返回的JSON中包含

success

字段：

json

{
  "success": false,
  "error": "Error message"
}

退出码：

```
0
```
- 成功
```
1
```
- 错误（查看JSON获取详情）

API Endpoint

API端点

Base URL:
```
https://api.valyu.ai/v1
```
Endpoint:
```
/search
```
Authentication: X-API-Key header

基础URL:
```
https://api.valyu.ai/v1
```
端点:
```
/search
```
认证方式: X-API-Key请求头

Architecture

架构

scripts/
├── search          # Bash wrapper
└── search.mjs      # Node.js CLI

Direct API calls using Node.js built-in

fetch()

, zero external dependencies.

scripts/
├── search          # Bash包装器
└── search.mjs      # Node.js命令行工具

使用Node.js内置的

fetch()

直接调用API，无外部依赖。

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:

如果你正在构建AI项目，希望将medRxiv Search直接集成到应用中，请使用Valyu SDK：

Python Integration

Python集成

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]}...")

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集成

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 for full integration examples and SDK reference.

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)}...`);
});

查看Valyu文档获取完整的集成示例和SDK参考。