Skip to content

HezaoHezao/poirot / poirot/backend/agents/skill/builtin_skills/research/arxiv

arxiv

Flagged

Search arXiv papers by keyword, author, category, or ID.

FileKindSize
SKILL.mdskill md3.1 KB
---
name: arxiv
description: "Search arXiv papers by keyword, author, category, or ID."
allowed-tools:
  - bash
  - browse_page
enabled: true
related-skills: [academic-paper-review, systematic-literature-review]
license: MIT
author: Adapted from hermes-agent (Nous Research, MIT)
---

# arXiv Research

Search and retrieve academic papers from arXiv via their free REST API. No API
key, no dependencies — just `bash` with `curl`.

## Quick Reference

| Action | Command |
|--------|---------|
| Search papers | `bash("curl -s 'https://export.arxiv.org/api/query?search_query=all:QUERY&max_results=5'")` |
| Get specific paper | `bash("curl -s 'https://export.arxiv.org/api/query?id_list=2402.03300'")` |
| Read abstract | `browse_page(url="https://arxiv.org/abs/2402.03300")` |
| Read full paper (PDF) | `browse_page(url="https://arxiv.org/pdf/2402.03300")` |

## Searching Papers

The API returns Atom XML. Parse with `python3` for clean output.

### Basic search

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

### Clean output (parse XML to readable format)

```bash
curl -s "https://export.arxiv.org/api/query?search_query=all:GRPO+reinforcement+learning&max_results=5&sortBy=submittedDate&sortOrder=descending" | python3 -c "
import sys, xml.etree.ElementTree as ET
ns = {'a': 'http://www.w3.org/2005/Atom'}
root = ET.fromstring(sys.stdin.read())
for entry in root.findall('a:entry', ns):
    title = entry.find('a:title', ns).text.strip().replace('\n', ' ')
    published = entry.find('a:published', ns).text[:10]
    summary = entry.find('a:summary', ns).text.strip()[:200]
    link = entry.find('a:id', ns).text
    print(f'{published} | {title}')
    print(f'  {link}')
    print(f'  {summary}...')
    print()
"
```

## Search Query Syntax

| Field | Example |
|-------|---------|
| All fields | `all:transformer` |
| Title | `ti:attention` |
| Author | `au:vaswani` |
| Abstract | `abs:reinforcement` |
| Category | `cat:cs.CL` |
| Combine (AND) | `all:transformer+AND+ti:attention` |
| Combine (OR) | `all:LLM+OR+all:large+language+model` |

## Common Categories

- `cs.CL` — Computation and Language (NLP)
- `cs.CV` — Computer Vision
- `cs.LG` — Machine Learning
- `cs.AI` — Artificial Intelligence
- `stat.ML` — Machine Learning (Stats)
- `physics` — Physics

## Workflow

1. **Search** by keyword/author/category to find relevant papers
2. **Read abstracts** from search results
3. **Fetch full abstract page** with `browse_page` for promising papers
4. **Read PDF** with `browse_page` for full content (if needed)

## Pitfalls

- **Rate limiting**: arXiv API asks for 3-second间隔 between requests. Don't
  hammer it.
- **Query too specific**: `"diffusion models in computer vision for medical
  imaging"` returns 0 results. Use 2-3 core keywords + category filter.
- **sortBy=relevance** is usually better than `submittedDate` for topical
  searches; use `submittedDate` only when user wants chronological order.
- **PDF parsing**: `browse_page` on PDF URLs may return raw text or fail on
  some papers. Prefer abstract pages for reliable content.
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall