xilele777/poirot/arxiv

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

Searching Papers

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

Basic search

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

Clean output (parse XML to readable format)

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

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.