How do I install the Arxiv skill?

Run npx skillmds@latest add ai4protein/arxiv in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Arxiv safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Arxiv?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Arxiv free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Unknown (arXiv content und….

ai4protein (@ai4protein) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Arxiv by ai4protein — Agent Skill

Name: Arxiv
Author: ai4protein

Arxiv

arXiv preprint server — keyword search the official API and download papers as PDF / HTML / source tarball. Use whenever the user mentions an arXiv ID (e.g. 2106.04559) or wants preprints on a topic in CS / physics / math / quantitative biology. For biomedical preprints specifically, prefer biorxiv skill.

ai4protein 6b02af6 3.0 KB Updated Sep 17, 2026

File contents

arXiv

Overview

Two complementary tools: query_arxiv (text search, returns JSON list inline) + download_arxiv_paper_by_id (fetches the actual paper as PDF / HTML / source tarball to disk).

Project Tools (VenusFactory2)

Tool	Args	Returns	Description
query_arxiv	`query` (text), `max_results` (default 5, max 50), `max_content_length` (default 10000)	JSON list of paper records (title, abstract, arxiv_id, authors, etc.) inline	Search-only; small JSON returned to agent context.
download_arxiv_paper_by_id	`arxiv_id` (e.g. `2106.04559`, `2106.04559v2`, `hep-th/9510017`), `out_dir`, `format` (`pdf` \| `html` \| `source`; default `pdf`), `timeout` (default 60s)	rich JSON envelope; file at `file_info.file_path` (`arxiv_<id>.pdf` etc.)	Download the actual paper.

When to Use Each

Goal	Tool
"Find papers about X"	`query_arxiv`
User provided an arxiv id and wants the PDF	`download_arxiv_paper_by_id`
Build a literature review pipeline (search → read PDFs)	`query_arxiv` → `download_arxiv_paper_by_id` for each result
Get the LaTeX source / figures for a paper	`download_arxiv_paper_by_id` with `format=source` (tar.gz)

ID Formats Accepted

Modern: 2106.04559, 2106.04559v2 (with version)
Old-style: hep-th/9510017, cond-mat/0411174
The tool strips the arxiv: / arXiv: prefix if present.

Format Details

`format`	URL pattern	When to use
`pdf` (default)	`https://arxiv.org/pdf/<id>.pdf`	Read the paper
`html`	`https://arxiv.org/html/<id>`	Modern papers only (post-2023); fails 404 on older papers
`source`	`https://export.arxiv.org/e-print/<id>`	LaTeX source as `.tar.gz` (for reproducing figures, extracting data, etc.)

Rate Limiting

arXiv asks for ~3-second spacing between requests. The tool doesn't enforce this internally; if you fire many in a loop, sleep yourself.
Bulk downloads should use the arXiv full-text bulk dataset on AWS S3, not this tool.

Common Mistakes

HTML format on an old paper: 404. Fall back to pdf.
PDF response is HTML: arXiv occasionally serves an error page with 200 OK; the tool checks %PDF magic bytes and returns DownloadError if the bytes aren't a real PDF.
No abstract from download_arxiv_paper_by_id: this tool only downloads; for abstract / metadata, use query_arxiv (or fetch the abstract page via WebFetch).

References

---name: arxivdescription: arXiv preprint server — keyword search the official API and download papers as PDF / HTML / source tarball. Use whenever the user mentions an arXiv ID (e.g. 2106.04559) or wants preprints on a topic in CS / physics / math / quantitative biology. For biomedical preprints specifically, prefer biorxiv skill.license: Unknown (arXiv content under various licenses, see paper metadat---# arXiv## OverviewTwo complementary tools: `query_arxiv` (text search, returns JSON list inline) + `download_arxiv_paper_by_id` (fetches the actual paper as PDF / HTML / source tarball to disk).## Project Tools (VenusFactory2)| Tool | Args | Returns | Description ||------|------|---------|--------------|| **query_arxiv** | `query` (text), `max_results` (default 5, max 50), `max_content_length` (default 10000) | JSON list of paper records (title, abstract, arxiv_id, authors, etc.) inline | Search-only; small JSON returned to agent context. || **download_arxiv_paper_by_id** | `arxiv_id` (e.g. `2106.04559`, `2106.04559v2`, `hep-th/9510017`), `out_dir`, `format` (`pdf` \| `html` \| `source`; default `pdf`), `timeout` (default 60s) | rich JSON envelope; file at `file_info.file_path` (`arxiv_<id>.pdf` etc.) | Download the actual paper. |## When to Use Each| Goal | Tool ||---|---|| "Find papers about X" | `query_arxiv` || User provided an arxiv id and wants the PDF | `download_arxiv_paper_by_id` || Build a literature review pipeline (search → read PDFs) | `query_arxiv` → `download_arxiv_paper_by_id` for each result || Get the LaTeX source / figures for a paper | `download_arxiv_paper_by_id` with `format=source` (tar.gz) |## ID Formats Accepted- Modern: `2106.04559`, `2106.04559v2` (with version)- Old-style: `hep-th/9510017`, `cond-mat/0411174`- The tool strips the `arxiv:` / `arXiv:` prefix if present.## Format Details| `format` | URL pattern | When to use ||---|---|---|| `pdf` (default) | `https://arxiv.org/pdf/<id>.pdf` | Read the paper || `html` | `https://arxiv.org/html/<id>` | Modern papers only (post-2023); fails 404 on older papers || `source` | `https://export.arxiv.org/e-print/<id>` | LaTeX source as `.tar.gz` (for reproducing figures, extracting data, etc.) |## Rate Limiting- arXiv asks for ~3-second spacing between requests. The tool doesn't enforce this internally; if you fire many in a loop, sleep yourself.- Bulk downloads should use [the arXiv full-text bulk dataset on AWS S3](https://info.arxiv.org/help/bulk_data_s3.html), not this tool.## Common Mistakes- **HTML format on an old paper**: 404. Fall back to `pdf`.- **PDF response is HTML**: arXiv occasionally serves an error page with 200 OK; the tool checks `%PDF` magic bytes and returns `DownloadError` if the bytes aren't a real PDF.- **No abstract from `download_arxiv_paper_by_id`**: this tool only downloads; for abstract / metadata, use `query_arxiv` (or fetch the abstract page via `WebFetch`).## References- [arXiv API user manual](https://info.arxiv.org/help/api/user-manual.html)- [arXiv Terms of Use](https://info.arxiv.org/help/api/tou.html)

Frequently asked questions