Alterlab Arxiv

arXiv Database

Overview

This skill provides Python tools for searching and retrieving preprints from arXiv.org via its public Atom API. It supports keyword search, author search, category filtering, arXiv ID lookup, and PDF download. Results are returned as structured JSON with titles, abstracts, authors, categories, and links.

The script declares its requests dependency via a PEP 723 inline header, so the most reliable way to run it is uv run scripts/arxiv_search.py ... (resolves deps automatically). The python scripts/arxiv_search.py ... examples below work when requests is already installed.

When to Use This Skill

Use this skill when:

• Searching for preprints in CS, ML, AI, physics, math, statistics, q-bio, q-fin, or economics
• Looking up specific papers by arXiv ID (e.g., 2309.10668)
• Tracking an author's recent preprints
• Filtering papers by arXiv category (e.g., cs.LG, cs.CL, stat.ML)
• Downloading PDFs for full-text analysis
• Building literature review datasets for AI/ML research
• Monitoring new submissions in a subfield

Does NOT Trigger

Core Search Capabilities

1. Keyword Search

Search for papers by keywords in titles, abstracts, or all fields.

bashCopy code
python scripts/arxiv_search.py \
  --keywords "sparse autoencoders" "mechanistic interpretability" \
  --max-results 20 \
  --output results.json

With category filter:

bashCopy code
python scripts/arxiv_search.py \
  --keywords "transformer" "attention mechanism" \
  --category cs.LG \
  --max-results 50 \
  --output transformer_papers.json

Search specific fields:

bashCopy code
# Title only
python scripts/arxiv_search.py \
  --keywords "GRPO" \
  --search-field ti \
  --max-results 10

# Abstract only
python scripts/arxiv_search.py \
  --keywords "reward model" "RLHF" \
  --search-field abs \
  --max-results 30

2. Author Search

au: matches author names only — the API cannot filter by affiliation, so au:anthropic or au:deepmind return nothing (or only papers where an organization is listed as a collective author). To follow a lab, query its members by name; to follow a whole institution, use alterlab-openalex (institution filter).

bashCopy code
python scripts/arxiv_search.py \
  --author "Yoshua Bengio" \
  --max-results 50 \
  --output bengio_papers.json

bashCopy code
python scripts/arxiv_search.py \
  --author "Ilya Sutskever" \
  --category cs.LG \
  --max-results 20

3. arXiv ID Lookup

Retrieve metadata for specific papers:

bashCopy code
python scripts/arxiv_search.py \
  --ids 2309.10668 2406.04093 2310.01405 \
  --output sae_papers.json

Full arXiv URLs also accepted:

bashCopy code
python scripts/arxiv_search.py \
  --ids "https://arxiv.org/abs/2309.10668"

4. Category Browsing

List recent papers in a category:

bashCopy code
python scripts/arxiv_search.py \
  --category cs.AI \
  --max-results 100 \
  --sort-by submittedDate \
  --output recent_cs_ai.json

5. PDF Download

bashCopy code
python scripts/arxiv_search.py \
  --ids 2309.10668 \
  --download-pdf papers/

Batch download from search results:

pythonCopy code
import json
from scripts.arxiv_search import ArxivSearcher

searcher = ArxivSearcher()

# Search first
results = searcher.search(query="ti:sparse autoencoder", max_results=5)

# Download all
for paper in results:
    arxiv_id = paper["arxiv_id"]
    searcher.download_pdf(arxiv_id, f"papers/{arxiv_id.replace('/', '_')}.pdf")

arXiv Categories

Computer Science (cs.*)

Statistics & Math

Other Relevant Categories

Full list: see references/api_reference.md.

Query Syntax

The arXiv API uses prefix-based field searches combined with Boolean operators.

Field prefixes:

• ti: - Title
• au: - Author
• abs: - Abstract
• cat: - Category
• all: - All fields (default)
• co: - Comment
• jr: - Journal reference
• id: - arXiv ID

Boolean operators (must be UPPERCASE):

Copy code
ti:transformer AND abs:attention
au:bengio OR au:lecun
cat:cs.LG ANDNOT cat:cs.CV

Grouping with parentheses:

Copy code
(ti:sparse AND ti:autoencoder) AND cat:cs.LG
au:"Chris Olah" AND (abs:interpretability OR abs:alignment)

Date ranges (GMT, YYYYMMDDTTTT, inclusive):

Copy code
cat:cs.LG AND submittedDate:[202501010000 TO 202501312359]

Validation (since the Nov 2025 backend migration): malformed queries — unbalanced parentheses, empty prefixes like au:, nested field syntax — return HTTP 400 with an Atom error entry (<summary>Invalid query string: …</summary>) instead of an empty 200. Bare terms are auto-prefixed (pineapple → all:pineapple); add raw=1 to disable that rewriting. The script surfaces these errors instead of reporting zero results.

Examples:

pythonCopy code
from scripts.arxiv_search import ArxivSearcher

searcher = ArxivSearcher()

# Papers about SAEs in ML
results = searcher.search(
    query="ti:sparse autoencoder AND cat:cs.LG",
    max_results=50,
    sort_by="submittedDate"
)

# Specific author in specific field
results = searcher.search(
    query='au:"Neel Nanda" AND cat:cs.LG',
    max_results=20
)

# Complex boolean query
results = searcher.search(
    query="(abs:RLHF OR abs:reinforcement learning from human feedback) AND cat:cs.CL",
    max_results=100
)

Output Format

All searches return structured JSON:

jsonCopy code
{
  "query": "id_list:2309.10668",
  "result_count": 1,
  "results": [
    {
      "arxiv_id": "2309.10668",
      "title": "Language Modeling Is Compression",
      "authors": ["Grégoire Delétang", "Anian Ruoss", "..."],
      "abstract": "Full abstract text...",
      "categories": ["cs.LG", "cs.AI", "cs.CL", "cs.IT"],
      "primary_category": "cs.LG",
      "published": "2023-09-19T14:50:38Z",
      "updated": "2024-03-18T23:15:47Z",
      "doi": "",
      "pdf_url": "https://arxiv.org/pdf/2309.10668v2",
      "abs_url": "https://arxiv.org/abs/2309.10668v2",
      "comment": "",
      "journal_ref": ""
    }
  ]
}

Common Usage Patterns

Literature Review Workflow

pythonCopy code
from scripts.arxiv_search import ArxivSearcher
import json

searcher = ArxivSearcher()

# 1. Broad search
results = searcher.search(
    query="abs:mechanistic interpretability AND cat:cs.LG",
    max_results=200,
    sort_by="submittedDate"
)

# 2. Save results
with open("interp_papers.json", "w") as f:
    json.dump({"result_count": len(results), "results": results}, f, indent=2)

# 3. Filter and analyze
import pandas as pd
df = pd.DataFrame(results)
print(f"Total papers: {len(df)}")
print(f"Date range: {df['published'].min()} to {df['published'].max()}")
print(f"\nTop categories:")
print(df["primary_category"].value_counts().head(10))

Track a Research Group

arXiv has no affiliation search, so track a group through its members' names (or switch to alterlab-openalex and filter works by institution ID):

pythonCopy code
searcher = ArxivSearcher()

members = ["Chris Olah", "Neel Nanda", "Tom Henighan"]  # the group's authors
query = "(" + " OR ".join(f'au:"{m}"' for m in members) + ") AND (cat:cs.LG OR cat:cs.CL)"

results = searcher.search(query=query, max_results=50, sort_by="submittedDate")
print(f"{len(results)} recent papers")

Monitor New Submissions

pythonCopy code
searcher = ArxivSearcher()

# Most recent ML papers
results = searcher.search(
    query="cat:cs.LG",
    max_results=50,
    sort_by="submittedDate",
    sort_order="descending"
)

for paper in results[:10]:
    print(f"[{paper['published'][:10]}] {paper['title']}")
    print(f"  {paper['abs_url']}\n")

Python API

pythonCopy code
from scripts.arxiv_search import ArxivSearcher

searcher = ArxivSearcher(verbose=True)

# Free-form query (uses arXiv query syntax)
results = searcher.search(query="...", max_results=50)

# Lookup by ID
papers = searcher.get_by_ids(["2309.10668", "2406.04093"])

# Download PDF
searcher.download_pdf("2309.10668", "paper.pdf")

# Build query from components
query = ArxivSearcher.build_query(
    title="sparse autoencoder",
    author="anthropic",
    category="cs.LG"
)
results = searcher.search(query=query, max_results=20)

Best Practices

1. Respect rate limits: The API requests 3-second delays between calls. The script handles this automatically.
2. Use category filters: Dramatically reduces noise. cs.LG is where most ML papers live.
3. Cache results: Save to JSON to avoid re-fetching.
4. Use sort_by=submittedDate for recent papers, relevance for keyword searches.
5. Max 2000 results per call: arXiv caps a single request at 2000 (the script clamps to this). For larger sets, paginate with the start parameter, up to a 30000 total cap.
6. arXiv IDs: Use bare IDs (2309.10668), not full URLs, in programmatic code.
7. Combine with alterlab-openalex: For citation counts and impact metrics arXiv doesn't provide.

Limitations

• No full-text search: Only searches metadata (title, abstract, authors, comments)
• No citation data: Use alterlab-openalex or Semantic Scholar for citations
• No affiliation search: au: matches author names only
• Max 2000 results per call: Use pagination (start) for larger sets, up to a 30000 total cap.
• Rate limited: ~1 request per 3 seconds recommended
• Atom XML responses: The script parses these into JSON automatically
• Search lag: New papers may take hours to appear in API results
• Strict query validation: invalid syntax returns HTTP 400 with an error entry (see Query Syntax)

Reference Documentation

• API Reference: See references/api_reference.md for full endpoint specs, all categories, and response schemas