PubMed Search 是一个用于检索 PubMed 生物医学文献的技能,由 Valyu 语义搜索 API 驱动。它允许用户使用自然语言查询完整的 PubMed 数据库,无需手动构造复杂的搜索参数。
主要能力
- 自然语言查询:直接传入自然语言问题,无需解析 API 参数。
- 语义搜索:理解查询的含义,而不仅仅是关键词匹配。
- 全文访问:返回完整的文章内容,而不仅是摘要。
- 图片链接:包含论文中的图表和图片。
- 全面覆盖:可访问 PubMed 的全部生物医学文献。
使用方式 该技能通过命令行脚本调用,基本用法为: scripts/search "your natural language query" [maxResults]
示例: scripts/search "COVID-19 vaccine efficacy studies" 15 scripts/search "BRCA1 mutations and breast cancer risk" 20 scripts/search "immunotherapy for melanoma clinical trials" 10 scripts/search "mechanism of action of metformin in type 2 diabetes" 12
设置命令: scripts/search setup <api-key>
运行搜索时若返回 "setup_required": true,需向用户索取 Valyu API 密钥,然后运行 setup 命令,再重试搜索。
脚本路径解析:文档中的 scripts/search 命令相对于该技能的安装目录。运行前需定位脚本: PUBMED_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "/pubmed-search//scripts/*" -type f 2>/dev/null | head -1) 然后使用完整路径执行命令。
输出格式为 JSON,包含 success、type、query、result_count、results(含 title、url、content、source、relevance_score、images)以及 cost 字段。可使用 jq 处理结果,例如提取标题、URL 或全文内容。
适用场景
- 文献综述:查找某一主题的所有论文。
- 药物发现:搜索药物靶点。
- 临床研究:查找临床试验结果。
- 基因功能:研究基因功能。
集成方式 若要在 AI 项目中集成 PubMed 搜索,可使用 Valyu SDK。 Python 示例: from valyu import Valyu client = Valyu(api_key="your-api-key") response = client.search(query="immunotherapy for melanoma", included_sources=["valyu/valyu-pubmed"], max_results=20)
TypeScript 示例: import { Valyu } from "valyu-js"; const client = new Valyu("your-api-key"); const response = await client.search({ query: "immunotherapy for melanoma", includedSources: ["valyu/valyu-pubmed"], maxResults: 20 });
要求与限制
- 需要 Node.js 18+(使用内置 fetch)。
- 需要 Valyu API 密钥,可在 https://platform.valyu.ai 获取(含 10 美元免费额度)。
- API 端点:https://api.valyu.ai/v1,路径 /search,认证方式为 X-API-Key 请求头。
- 架构:scripts/search(Bash 包装器)和 scripts/search.mjs(Node.js CLI),使用 Node.js 内置 fetch(),无外部依赖。
- 错误处理:所有命令返回带 success 字段的 JSON;退出码 0 表示成功,1 表示错误。
其他信息(如具体定价、平台支持范围等)暂未提供。