# Arxiv Paper Reviews

> 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.

- Skill: `johnalbertini14-glitch/arxiv-paper-reviews` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/arxiv-paper-reviews`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/arxiv-paper-reviews/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/johnalbertini14-glitch/arxiv-paper-reviews

---


# arXiv Paper Reviews Skill

## 概述

这个 skill 封装了 arXiv Crawler API，让你可以：
- 获取论文列表（支持按日期、分类、兴趣筛选）
- 查看论文详情和评论
- 提交论文短评
- 搜索论文（按标题关键词）
- 导入论文（从 arXiv URL）

## 安装依赖

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

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

或者使用一键安装脚本（如果存在）：
```bash
bash install-deps.sh
```

## 配置

创建或编辑 `config.json` 文件：

```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

**使用方法**:
```bash
python3 paper_client.py list --date 2026-02-04 --categories cs.AI,cs.LG --limit 20
```

### 2. 获取论文详情 + 评论

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

**参数**:
- `paper_key` (必填): 论文唯一标识

**使用方法**:
```bash
python3 paper_client.py show 4711d67c242a5ecba2751e6b
```

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

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

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

**使用方法**:
```bash
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 读取）

**使用方法**:
```bash
# 使用配置中的默认作者名
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

**使用方法**:
```bash
python3 paper_client.py search --query "transformer" --limit 10
```

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

**接口**: `POST /public/papers/import`

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

**参数**:
- `arxiv_url` (必填): arXiv 论文链接

**使用方法**:
```bash
python3 paper_client.py import --url "https://arxiv.org/abs/2602.09012"
```

## 辅助脚本示例

### 批量获取论文并显示摘要

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

### 搜索特定论文

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

### 导入新论文并查看详情

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

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

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

```bash
# 查看已有评论
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 飞书
- 通过搜索功能快速查找感兴趣的论文