arxiv-search

arXiv Search 用于搜索 arXiv 公共 API 中的研究论文，返回结构化元数据（标题、作者、摘要、arXiv ID、分类、日期、PDF/HTML 链接）并以 JSON 形式输出。如需针对某篇论文做全文分析，可搭配 arxiv-analyze 使用。

使用场景

• 用户想发现某个主题的论文
• 用户想查看某个 arXiv 分类的最新投稿
• 用户想检查某位作者发表了什么
• 在分析某篇具体论文之前的起点

使用方式

脚本位于 scripts/arxiv_search.py。它直接请求 arXiv API，并将 Atom XML 解析为 JSON，因此模型无需接触 XML。

主题搜索： python3 scripts/arxiv_search.py "mechanistic interpretability" --max 20

分类过滤（参见 arXiv 分类体系：cs.LG、cs.CL、stat.ML 等）： python3 scripts/arxiv_search.py --category cs.LG --max 30 --sort-by submittedDate

主题 + 分类 + 日期范围： python3 scripts/arxiv_search.py "sparse autoencoders" --category cs.LG --from 2025-01-01 --to 2026-04-16 --max 50

按最新优先： python3 scripts/arxiv_search.py "LLM agents" --sort-by submittedDate --max 20

参数：

• --max N — 最大结果数（默认 20；arXiv API 上限为 2000）
• --category CAT — arXiv 分类代码
• --from YYYY-MM-DD / --to YYYY-MM-DD — 投稿日期过滤
• --sort-by relevance|lastUpdatedDate|submittedDate — 默认 relevance

输出：JSON 输出到 stdout。每条结果包含 id、title、authors[]、abstract、categories[]、primary_category、published、updated、abs_url、pdf_url、doi、journal_ref、comment。

工作流

1. 解析意图

• 主题搜索："find papers on X" → 使用 "X" 作为查询
• 领域最新："what's new in cs.LG" → --category cs.LG --sort-by submittedDate
• 作者搜索："papers by <name>" → 查询该姓名；arXiv 在 all: 中索引作者名
• 组合：主题 + 时间窗口 + 分类

1. 执行搜索 调用脚本。默认 --max 20 是不错的起点。做广泛综述时可提高到 50。

2. 呈现结果 格式化为紧凑表格。每篇论文包含：

• arXiv ID（带 abs_url 链接）
• 标题
• 作者（前 2 位 + "et al." 若更多）
• 发布日期
• 主要分类
• 一句话摘要总结（不要倾倒完整摘要）

1. 提供后续操作 询问用户是否想要：

• 分析某篇具体论文（→ arxiv-analyze）
• 为该查询创建监控（→ arxiv-monitor add）

输出格式

arXiv Search:

arfX ID 标题 作者 日期

1 2501.11120v1 Tell me about yourself... Betley et al. 2025-01-19

下一步：

analyze 以获取全文 watch 以持续跟踪该查询

Token 效率

• 20 条结果约 5K tokens（摘要占主要部分）
• 建议用户缩小查询，而不是倾倒 50 条结果
• 仅做简报时，先通过 jq '.results | map({id, title, authors, published})' 管道过滤后再送入上下文

arXiv 分类体系速查

常见分类（完整列表见 https://arxiv.org/category_taxonomy）：

• cs.CL — Computation and Language（NLP）
• cs.LG — Machine Learning
• cs.AI — Artificial Intelligence
• cs.CR — Cryptography and Security
• cs.CY — Computers and Society
• stat.ML — Statistics: Machine Learning
• cs.IR — Information Retrieval
• cs.HC — Human-Computer Interaction

速率限制

arXiv API：每 IP 每 3 秒约 1 次请求的软限制。该技能每次调用只发一次请求，完全在限制内。

错误处理

• 无效分类或错误查询 → 空的 results 数组。报告"未找到论文"并建议放宽查询。
• 网络错误 → 退出码 4，stderr 输出消息。
• 响应格式错误 → 退出码 5（极罕见；表明 arXiv API 发生变化）。

要求

• Python 3.11+（仅标准库，无需 pip 安装）