用途:OpenCite 是用于学术文献检索与引用管理的 CLI 工具,适合查找论文、定位引用、查询 DOI、获取 BibTeX、下载 PDF 以及把 PDF 转成 Markdown。
主要能力:聚合 Semantic Scholar、OpenAlex、PubMed、arXiv、bioRxiv/medRxiv 的结果并去重后输出;支持按标识符查询、引用/被引关系探索、查找某主题被引最多的奠基性论文、PDF 下载、本地 PDF 转 Markdown、标识符互转(DOI、PMID、PMCID)以及批量下载与转换。
安装与用法:推荐 uv pip install opencite;也可用 uvx opencite --version 免安装运行。开发用 uv sync --extra dev。常用命令包括 uvx opencite search "query" --max 20 --sort citations、uvx opencite canonical "topic" --max 10、uvx opencite cite "DOI" --direction both、uvx opencite pdf "10.1234/example" -o papers/pdf/ --convert、uvx opencite lookup "DOI" -f bibtex --append-bib refs.bib。批量流程:先 uvx opencite search "topic" --max 10 -f json -o results.json,再 uvx opencite batch-fetch --from-json results.json --convert -o ./papers --summary report.json,会生成 papers/pdf 与 papers/markdown(含 img 子目录,仅 mistral 模式)。
配置:uvx opencite config init 生成 ~/.opencite/config.toml,config show 查看解析后的配置。相关环境变量有 SEMANTIC_SCHOLAR_API_KEY、PUBMED_API_KEY、OPENALEX_API_KEY(资料称自 2026 年 2 月起必需)、MISTRAL_API_KEY(可选,用于增强转换)。PDF 转换默认包含 markitdown 与 markit-mistral;设置 MISTRAL_API_KEY 时由 markit-mistral 处理数学、表格与复杂版式,否则回退到免费本地的 markitdown。
限制:Semantic Scholar 限流较严(约 1 请求/秒),遇限流需等待重试;缺少 API 密钥时命令会警告但仍查询可用来源;超时可重试或用 --source 换源;付费墙论文可能需机构访问或出版商令牌。pdf --convert 会把 Markdown 放在 PDF 旁且不提取图片,需要目录结构与图片提取应使用 batch-fetch。其余细节暂未提供。