arxiv-viewer

# arXiv Viewer

Access, search, download, and read academic papers from arXiv using a hybrid API + Actionbook approach.

## Architecture Overview

```
┌─────────────────────────────────────────────────────────────┐
│                     arxiv-viewer                            │
├─────────────────┬─────────────────┬─────────────────────────┤
│   arXiv API     │  arxiv.org Web  │      ar5iv.org          │
│   (WebFetch)    │  (Actionbook)   │    (Actionbook)         │
├─────────────────┼─────────────────┼─────────────────────────┤
│ • Metadata      │ • Latest list   │ • Read sections         │
│ • Search        │ • Trending      │ • Extract figures       │
│ • By ID lookup  │ • Advanced      │ • Extract citations     │
│                 │   search form   │ • Get outline           │
└─────────────────┴─────────────────┴─────────────────────────┘
```

## Tool Priority

**By Feature:**

| Feature | Primary Tool | Fallback |
|---------|--------------|----------|
| Paper metadata | WebFetch (API) | browser-fetcher |
| Search | WebFetch (API) | browser-fetcher |
| Latest papers | browser-fetcher (Actionbook) | WebFetch (API) |
| Trending | browser-fetcher (Actionbook) | - |
| Advanced search | browser-fetcher (Actionbook) | WebFetch (API) |
| Read HTML section | html-reader (Actionbook) | Read (PDF) |
| Download PDF | Bash (curl) | - |

## Workflow Rules

### ⚠️ Agent Waiting Rule

**After launching browser-fetcher or html-reader agents:**
1. ✅ **MUST wait for ALL agents to complete**
2. ⛔ **DO NOT** use WebFetch/WebSearch while waiting
3. ✅ Only use fallback tools after agents have failed

---

## Data Sources

### 1. arXiv API (WebFetch)

**Best for:** Quick metadata lookup, simple search

```
Base URL: http://export.arxiv.org/api/query
```

| Parameter | Description |
|-----------|-------------|
| search_query | Search with field prefixes (ti:, au:, abs:, cat:) |
| id_list | Comma-separated arXiv IDs |
| max_results | 1-2000 (default: 10) |
| sortBy | relevance / submitt