用途:该技能提供对 NCBI PubMed 和 PubMed Central API 的命令行访问,用于检索科学文献(含已发表临床试验)、获取摘要与开放获取全文,并将文献记录链接到其他 NCBI 生物数据库。
主要能力:单一 CLI 脚本 scripts/pubmed_api.py 提供 10 个函数,覆盖检索、抓取、链接、全文、拼写检查、发现、引文匹配与缓存。检索类含 search_pubmed(按自由文本或结构化 NCBI 查询找 PMID)与 global_database_discovery(统计各 NCBI 数据库匹配记录数);抓取类含 fetch_article_abstracts、get_full_text_pmc、fetch_database_summary;跨库链接含 find_linked_biological_data 与 discover_available_links;批量工作流含 cache_results_history;工具类含 verify_medical_spelling 与 match_raw_citations。
使用方式:需先安装 uv 并确保其在 PATH 上;在用户主目录准备 .env 文件。可选配置 NCBI_API_KEY(将速率限制从 3 提升到 10 请求/秒,可在 NCBI 账户设置免费注册)与 USER_EMAIL(向 NCBI 标识调用者)。调用格式为 uv run scripts/pubmed_api.py <output_file> <function_name> <required_args> [--flag value ...],参数为位置参数,列表参数以逗号分隔字符串传入。成功时 JSON 写入输出文件,出错时以非零码退出且不写文件。建议用 jq 过滤与转换 JSON 输出。
适用场景:文献检索与摘要获取、开放获取全文获取、跨 NCBI 数据库链接探索、批量 PMID 处理、引文解析与医学术语拼写检查。
限制与注意事项:必须使用提供的包装脚本,禁止通过 curl、wget 或手写代码直接查询 API。首次使用若工作区根目录不存在 .licenses/pubmed_database_LICENSE.txt,需提示用户查看 PubMed 免责声明与 NCBI 政策,并检查所检索论文的许可限制。处理超过约 10 条摘要时应先过滤与精简字段,批量操作应使用 History Server 而非逐条处理。不得在无结果时凭内部知识提供 PMID、CID、Gene ID 等标识符。检索无果时限制在 3–5 个高质量查询后终止。使用该技能需在输出中提及并列出所用论文 URL。各函数的具体参数名、顺序、标志与输出模式仅在 references/ 参考文件中记录,调用前必须阅读对应参考文件。