Search arXiv and return compact paper metadata.

Provide a raw query (arXiv field syntax, e.g. au:hinton AND cat:cs.LG) and/or the structured shortcuts category (cat:), author (au:), title (ti:), abstract (abs:) which are AND-combined. Or pass id_list to fetch specific papers by id.

sort_by is one of relevance, lastUpdatedDate, submittedDate; sort_order is ascending or descending. max_results is capped at 2000 per call — page with start for more (up to 30000 total).

If session_id is given, returned papers are pinned to that session's cache so they won't be evicted while the session is open.

Fetch full metadata for one paper by arXiv id.

Accepts any id form: 2401.12345, arXiv:2401.12345v2, an arxiv.org/abs/... URL, hep-th/9901001, or a 10.48550/arXiv... DOI. Served from cache when possible. Returns normalized metadata plus derived pdf / abs / html / source URLs.

Read a paper's full text, paginated so large papers don't overflow context.

Extraction prefers arXiv HTML/LaTeX source and falls back to PDF; the result is cached permanently per exact version. page is 1-based; page_size is characters per page. The response reports total_pages and has_more so you can request the next page. To read a specific version, include it in the id (2401.12345v1); a bare id resolves to the latest.

Download a paper's raw pdf or source (LaTeX tarball) into the cache.

Returns the local path. Use read_paper if you want extracted text rather than the raw file.

Open a caching session. Papers fetched with this session_id are pinned (never evicted) until :func:end_session, so repeated work over intervals never refetches the same paper.

Close a session, unpinning its papers so they become eligible for eviction.

Report the papers pinned to a session.

Report cache usage: paper count, disk usage, limits, sessions.

List cached papers (most-recently-accessed first) with size and pin state.

Evict cached papers. By default leaves papers pinned to open sessions; set drop_pinned to remove everything.

List arXiv subject categories for building cat: filters.

Pass a group prefix (e.g. cs, math, astro-ph) to narrow, or a full category id (cs.AI) to get its description.