该技能用于在 arXiv 上检索科学论文、预印本和出版物,提取元数据与摘要,并下载全文 PDF 或 HTML 版本。使用前需按 uv 技能说明安装 uv 并确保其在 PATH 中。若工作区根目录下不存在 .licenses/literature_search_arxiv_LICENSE.txt,需先提示用户查看 https://info.arxiv.org/help/api/index.html 的条款并检查所检索论文的许可限制,再创建记录该提示与时间戳的文件。使用中必须遵守 arXiv 使用条款,最多每 3 秒发起 1 次请求;限速由工具脚本自动处理,应始终使用脚本而非自行编写 curl 或 python 请求。输出中需注明使用了该技能,并列出所用论文的 URL。
主要脚本:search_arxiv.py 用于检索并返回匹配论文的 JSON 数组,支持 --query、--id_list、--start、--max_results、--sort_by、--sort_order 参数;结果含 id、title、summary、published、authors、pdf_url、primary_category、doi、journal_ref、comment,其中 doi 仅在论文有外部 DOI 时返回。download_paper.py 用于下载 PDF 或 HTML 全文,支持 --id、--format、--output;HTML 仅较新论文可用。download_paper_source.py 用于下载 LaTeX 源码 tar.gz,并非所有论文都有源码;解压时必须解压到新建的独立目录,例如 mkdir paper_source && tar -xzf source.tar.gz -C paper_source。
检索时结果 JSON 较大,建议将 --max_results 限制在 5 至 10 或用 --start 分页,并将输出重定向到文件后单独解析。下载论文时需避免覆盖其他文件或打乱现有目录结构;下载 PDF 后应确认文件非空且未损坏。高级查询语法见 references/query_syntax.md。资料未提供具体收费、价格或效果信息。