medRxiv Search 用于以自然语言检索 medRxiv 医学和健康科学预印本数据库，由 Valyu 语义搜索 API 提供支持。主要能力包括：直接传入自然语言查询，无需构造复杂 API 参数；语义搜索理解查询含义而非仅关键词匹配；返回文章全文内容而非仅摘要；包含论文图表和图片链接；覆盖全部 medRxiv 预印本。使用前需 Node.js 18+（使用内置 fetch）以及来自 https://platform.valyu.ai 的 Valyu API 密钥（含 $10 免费额度）。
脚本路径相对于技能安装目录，运行前需先用 find ~/.claude/plugins/cache -name "search" -path "/medrxiv-search//scripts/*" -type f 定位脚本，再以完整路径调用，如 $MEDRXIV_SCRIPT "COVID-19 vaccine efficacy" 15。若搜索返回 setup_required 为 true，需向用户索取 API 密钥，然后运行 scripts/search setup <api-key>，再重试搜索。
适用场景包括：获取期刊发表前的最新医学研究、临床试验结果与结局、流行病学与公共卫生数据、医疗器械与疗法研究、卫生政策与医疗系统研究、新兴健康主题的快速响应研究。输出为 JSON，含 success、type、query、result_count、results（每项含 title、url、content、source、relevance_score、images）和 cost 字段，可用 jq 提取标题、URL 或全文。错误时返回 success 为 false 和 error 信息；退出码 0 为成功，1 为错误。API 基础地址为 https://api.valyu.ai/v1，端点为 /search，认证方式为 X-API-Key 头。架构为 scripts/search（Bash 包装器）和 scripts/search.mjs（Node.js CLI），使用内置 fetch，无外部依赖。也可通过 Valyu SDK 集成到 AI 项目（Python 与 TypeScript 示例见资料）。