Communitygithub.com

V4TIME/V4SKILL

通过关键词、作者、分类或ID搜索并获取arXiv学术论文。

V4SKILL 是什么?

该技能提供了一个完整的学术论文检索和研究工作流,基于arXiv的免费REST API以及Semantic Scholar的引用数据API。用户无需API密钥或额外依赖,仅通过curl和Python标准库即可实现论文搜索、元数据解析、BibTeX引用生成、摘要/全文阅读以及引用关系挖掘。支持丰富的查询语法,包括字段限定(标题、作者、摘要、分类)、布尔运算符和排序分页。同时集成了Semantic Scholar的引用计数、相关论文推荐和作者档案功能,形成一个从发现、评估到深入阅读的闭环研究流程。适用于所有支持curl和web_extract的AI Agent平台(如Claude Code、Cursor、Codex等),是科研人员、AI工程师和学生进行文献调研的高效工具。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/research/arxiv

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

arXiv 研究

通过 arXiv 的免费 REST API 搜索和获取学术论文。无需 API 密钥,无需依赖——只需 curl。

快速参考

操作命令
搜索论文curl "https://export.arxiv.org/api/query?search_query=all:QUERY&max_results=5"
获取特定论文curl "https://export.arxiv.org/api/query?id_list=2402.03300"
阅读摘要(网页版)web_extract(urls=["https://arxiv.org/abs/2402.03300"])
阅读全文 (PDF)web_extract(urls=["https://arxiv.org/pdf/2402.03300"])

搜索论文

API 返回 Atom XML。可使用 grep/sed 解析,或通过 python 管道输出为清晰文本。

基础搜索

curl -s "https://export.arxiv.org/api/query?search_query=all:GRPO+reinforcement+learning&max_results=5"

清晰输出(将 XML 解析为可读格式)

curl -s "https://export.arxiv.org/api/query?search_query=all:GRPO+reinforcement+learning&max_results=5&sortBy=submittedDate&sortOrder=descending" | python -c "
import sys, xml.etree.ElementTree as ET
ns = {'a': 'http://www.w3.org/2005/Atom'}
root = ET.parse(sys.stdin).getroot()
for i, entry in enumerate(root.findall('a:entry', ns)):
    title = entry.find('a:title', ns).text.strip().replace('\n', ' ')
    arxiv_id = entry.find('a:id', ns).text.strip().split('/abs/')[-1]
    published = entry.find('a:published', ns).text[:10]
    authors = ', '.join(a.find('a:name', ns).text for a in entry.findall('a:author', ns))
    summary = entry.find('a:summary', ns).text.strip()[:200]
    cats = ', '.join(c.get('term') for c in entry.findall('a:category', ns))
    print(f'{i+1}. [{arxiv_id}] {title}')
    print(f'   作者: {authors}')
    print(f'   发表日期: {published} | 分类: {cats}')
    print(f'   摘要: {summary}...')
    print(f'   PDF: https://arxiv.org/pdf/{arxiv_id}')
    print()
"

搜索查询语法

前缀搜索范围示例
all:所有字段all:transformer+attention
ti:标题ti:large+language+models
au:作者au:vaswani
abs:摘要abs:reinforcement+learning
cat:分类cat:cs.AI
co:评论co:accepted+NeurIPS

布尔运算符

# AND(使用 + 时默认)
search_query=all:transformer+attention

# OR
search_query=all:GPT+OR+all:BERT

# AND NOT
search_query=all:language+model+ANDNOT+all:vision

# 精确短语
search_query=ti:"chain+of+thought"

# 组合
search_query=au:hinton+AND+cat:cs.LG

排序和分页

参数选项
sortByrelevance, lastUpdatedDate, submittedDate
sortOrderascending, descending
start结果偏移量(从0开始)
max_results结果数量(默认10,最大30000)
# cs.AI 分类下最新的10篇论文
curl -s "https://export.arxiv.org/api/query?search_query=cat:cs.AI&sortBy=submittedDate&sortOrder=descending&max_results=10"

获取特定论文

# 通过 arXiv ID
curl -s "https://export.arxiv.org/api/query?id_list=2402.03300"

# 多篇论文
curl -s "https://export.arxiv.org/api/query?id_list=2402.03300,2401.12345,2403.00001"

生成 BibTeX

获取论文元数据后,生成 BibTeX 条目:

{% raw %}

curl -s "https://export.arxiv.org/api/query?id_list=1706.03762" | python -c "
import sys, xml.etree.ElementTree as ET
ns = {'a': 'http://www.w3.org/2005/Atom', 'arxiv': 'http://arxiv.org/schemas/atom'}
root = ET.parse(sys.stdin).getroot()
entry = root.find('a:entry', ns)
if entry is None: sys.exit('Paper not found')
title = entry.find('a:title', ns).text.strip().replace('\n', ' ')
authors = ' and '.join(a.find('a:name', ns).text for a in entry.findall('a:author', ns))
year = entry.find('a:published', ns).text[:4]
raw_id = entry.find('a:id', ns).text.strip().split('/abs/')[-1]
cat = entry.find('arxiv:primary_category', ns)
primary = cat.get('term') if cat is not None else 'cs.LG'
last_name = entry.find('a:author', ns).find('a:name', ns).text.split()[-1]
print(f'@article{{{last_name}{year}_{raw_id.replace(\".\", \"\")},')
print(f'  title     = {{{title}}},')
print(f'  author    = {{{authors}}},')
print(f'  year      = {{{year}}},')
print(f'  eprint    = {{{raw_id}}},')
print(f'  archivePrefix = {{arXiv}},')
print(f'  primaryClass  = {{{primary}}},')
print(f'  url       = {{https://arxiv.org/abs/{raw_id}}}')
print('}')
"

{% endraw %}

阅读论文内容

找到论文后,阅读它:

# 摘要页(快速,包含元数据和摘要)
web_extract(urls=["https://arxiv.org/abs/2402.03300"])

# 全文(PDF → 通过 Firecrawl 转换为 markdown)
web_extract(urls=["https://arxiv.org/pdf/2402.03300"])

对于本地 PDF 处理,请参见 ocr-and-documents 技能。

常用分类

分类领域
cs.AI人工智能
cs.CL计算与语言 (NLP)
cs.CV计算机视觉
cs.LG机器学习
cs.CR密码学与安全
stat.ML机器学习(统计学)
math.OC优化与控制
physics.comp-ph计算物理

完整列表:https://arxiv.org/category_taxonomy

辅助脚本

scripts/search_arxiv.py 脚本处理 XML 解析并提供清晰输出:

python scripts/search_arxiv.py "GRPO reinforcement learning"
python scripts/search_arxiv.py "transformer attention" --max 10 --sort date
python scripts/search_arxiv.py --author "Yann LeCun" --max 5
python scripts/search_arxiv.py --category cs.AI --sort date
python scripts/search_arxiv.py --id 2402.03300
python scripts/search_arxiv.py --id 2402.03300,2401.12345

无依赖——仅使用 Python 标准库。


Semantic Scholar(引用、相关论文、作者档案)

arXiv 不提供引用数据或推荐。请使用 Semantic Scholar API——免费,基础使用无需密钥(每秒1次请求),返回 JSON。

获取论文详情 + 引用

# 通过 arXiv ID
curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:2402.03300?fields=title,authors,citationCount,referenceCount,influentialCitationCount,year,abstract" | python -m json.tool

# 通过 Semantic Scholar 论文 ID 或 DOI
curl -s "https://api.semanticscholar.org/graph/v1/paper/DOI:10.1234/example?fields=title,citationCount"

获取引用某篇论文的论文列表(谁引用了它)

curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:2402.03300/citations?fields=title,authors,year,citationCount&limit=10" | python -m json.tool

获取某篇论文引用的参考文献列表(它引用了什么)

curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:2402.03300/references?fields=title,authors,year,citationCount&limit=10" | python -m json.tool

搜索论文(arXiv 搜索的替代方案,返回 JSON)

curl -s "https://api.semanticscholar.org/graph/v1/paper/search?query=GRPO+reinforcement+learning&limit=5&fields=title,authors,year,citationCount,externalIds" | python -m json.tool

获取论文推荐

curl -s -X POST "https://api.semanticscholar.org/recommendations/v1/papers/" \
  -H "Content-Type: application/json" \
  -d '{"positivePaperIds": ["arXiv:2402.03300"], "negativePaperIds": []}' | python -m json.tool

作者档案

curl -s "https://api.semanticscholar.org/graph/v1/author/search?query=Yann+LeCun&fields=name,hIndex,citationCount,paperCount" | python -m json.tool

有用的 Semantic Scholar 字段

title, authors, year, abstract, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fieldsOfStudy, publicationVenue, externalIds(包含 arXiv ID、DOI 等)


完整研究流程

  1. 发现: python scripts/search_arxiv.py "your topic" --sort date --max 10
  2. 评估影响力: curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:ID?fields=citationCount,influentialCitationCount"
  3. 阅读摘要: web_extract(urls=["https://arxiv.org/abs/ID"])
  4. 阅读全文: web_extract(urls=["https://arxiv.org/pdf/ID"])
  5. 查找相关工作: curl -s "https://api.semanticscholar.org/graph/v1/paper/arXiv:ID/references?fields=title,citationCount&limit=20"
  6. 获取推荐: 向 Semantic Scholar 推荐端点发送 POST 请求
  7. 追踪作者: curl -s "https://api.semanticscholar.org/graph/v1/author/search?query=NAME"

速率限制

API速率认证
arXiv~1 请求 / 3 秒无需
Semantic Scholar1 请求 / 秒无需(使用 API 密钥可达100/秒)

备注

  • arXiv 返回 Atom XML——请使用辅助脚本或解析代码片段以获得清晰输出
  • Semantic Scholar 返回 JSON——通过 python -m json.tool 管道输出以提高可读性
  • arXiv ID:旧格式(hep-th/0601001) vs 新格式(2402.03300)
  • PDF:https://arxiv.org/pdf/{id} —— 摘要页:https://arxiv.org/abs/{id}
  • HTML(如可用):https://arxiv.org/html/{id}
  • 对于本地 PDF 处理,请参见 ocr-and-documents 技能

ID 版本管理

  • arxiv.org/abs/1706.03762 始终解析为最新版本
  • arxiv.org/abs/1706.03762v1 指向特定不可变版本
  • 生成引用时,保留您实际阅读的版本后缀以防止引用漂移(后续版本可能大幅更改内容)
  • API <id> 字段返回带版本的 URL(例如 http://arxiv.org/abs/1706.03762v7)

撤回论文

论文可能在提交后被撤回。出现这种情况时:

  • <summary> 字段包含撤回通知(查找 "withdrawn" 或 "retracted")
  • 元数据字段可能不完整
  • 在将结果视为有效论文之前,请务必检查摘要

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

相关技能