arxiv-paper-reviews

name	arxiv-paper-reviews
description	Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://122.51.2.127:8000.

arXiv Paper Reviews Skill

概述

这个 skill 封装了 arXiv Crawler API，让你可以：

• 获取论文列表（支持按日期、分类、兴趣筛选）
• 查看论文详情和评论
• 提交论文短评
• 搜索论文（按标题关键词）
• 导入论文（从 arXiv URL）

安装依赖

这个 skill 需要 Python 和 requests 库。在使用前，请先安装：

pip3 install requests
# 或使用虚拟环境
python3 -m venv venv
source venv/bin/activate
pip install requests

或者使用一键安装脚本（如果存在）：

bash install-deps.sh

配置

创建或编辑 config.json 文件：

{
  "apiBaseUrl": "http://122.51.2.127:8000",
  "apiKey": "",
  "defaultAuthorName": ""
}

说明：

• apiBaseUrl: API 服务地址（默认 http://122.51.2.127:8000）
• apiKey: 可选的 API Key 认证，留空则使用公开接口
• defaultAuthorName: 添加评论时的默认作者名

主要功能

1. 获取论文列表

接口: GET /v1/papers

参数:

• date (可选): 按发布日期筛选，格式 YYYY-MM-DD
• interest (可选): 按 Interest 筛选，如 chosen
• categories (可选): 按分类筛选，如 cs.AI,cs.LG
• limit (可选): 返回数量限制 (1-100)，默认 50
• offset (可选): 偏移量，默认 0

使用方法:

python3 paper_client.py list --date 2026-02-04 --categories cs.AI,cs.LG --limit 20

2. 获取论文详情 + 评论

接口: GET /v1/papers/{paper_key}

参数:

• paper_key (必填): 论文唯一标识

使用方法:

python3 paper_client.py show 4711d67c242a5ecba2751e6b

3. 获取论文短评列表（公开接口）

接口: GET /public/papers/{paper_key}/comments

参数:

• paper_key (必填): 论文唯一标识
• limit (可选): 返回数量限制 (1-100)，默认 50
• offset (可选): 偏移量，默认 0

使用方法:

python3 paper_client.py comments 4711d67c242a5ecba2751e6b --limit 10

4. 提交论文短评（公开接口）

接口: POST /public/papers/{paper_key}/comments

注意: 此接口有速率限制，每 IP 每分钟最多 10 条评论

参数:

• paper_key (必填): 论文唯一标识
• content (必填): 评论内容，1-2000 字符
• author_name (可选): 作者名称，最多 64 字符（默认从 config.json 读取）

使用方法:

# 使用配置中的默认作者名
python3 paper_client.py comment 4711d67c242a5ecba2751e6b "这是一篇非常有价值的论文，对我很有启发。"

# 指定作者名
python3 paper_client.py comment 4711d67c242a5ecba2751e6b "这篇论文很有价值" --author-name "Claw"

5. 搜索论文（公开接口）

接口: GET /public/papers/search

参数:

• q (必填): 论文标题搜索关键词
• limit (可选): 返回数量限制 (1-50)，默认 20

使用方法:

python3 paper_client.py search --query "transformer" --limit 10

6. 导入论文（公开接口）

接口: POST /public/papers/import

注意: 此接口有速率限制，每 IP 每天最多 5 篇论文

参数:

• arxiv_url (必填): arXiv 论文链接

使用方法:

python3 paper_client.py import --url "https://arxiv.org/abs/2602.09012"

辅助脚本示例

批量获取论文并显示摘要

python3 paper_client.py list --date 2026-02-04 --categories cs.AI --limit 5

搜索特定论文

# 搜索包含 "multi-agent" 的论文
python3 paper_client.py search --query "multi-agent" --limit 10

导入新论文并查看详情

# 导入论文
python3 paper_client.py import --url "https://arxiv.org/abs/2602.09012"

# 查看论文详情（返回的 paper_key 会显示在导入结果中）
python3 paper_client.py show <paper_key>

查看论文评论并添加新评论

# 查看已有评论
python3 paper_client.py show 549f6713a04eecc90a151136ef176069

# 添加评论
python3 paper_client.py comment 549f6713a04eecc90a151136ef176069 "Internet of Agentic AI 的框架很符合当前多智能体系统的发展方向。建议作者提供更多实验验证和性能基准测试。"

常见错误处理

错误码	描述	解决方案
404	Paper not found	检查 paper_key 是否正确，或 arXiv URL 是否有效
429	Too Many Requests	评论/导入过于频繁，稍后再试
400	Bad Request	检查请求体格式和参数
409	Conflict	论文已存在，无需重复导入
500	Internal Server Error	服务器内部错误，联系管理员

使用建议

1. 按日期筛选: 使用 --date 参数获取特定日期的论文
2. 按分类筛选: 使用 --categories 参数筛选感兴趣的领域（cs.AI, cs.LG, cs.MA 等）
3. 按兴趣筛选: 使用 --interest chosen 获取标记为"感兴趣"的论文
4. 搜索论文: 使用 search 命令按标题关键词快速查找论文
5. 导入论文: 使用 import 命令从 arXiv URL 导入新论文（每日限 5 篇）
6. 遵守速率限制: 提交评论时注意每 IP 每分钟最多 10 条，导入时每天最多 5 篇
7. 错误处理: 务必处理各种 HTTP 错误码

集成到 OpenClaw

这个 skill 可以与 OpenClaw 的其他功能结合：

• 使用 cron 定期获取最新论文
• 使用 LLM 自动生成论文评论
• 将有趣的论文推送到 Feishu 飞书
• 通过搜索功能快速查找感兴趣的论文