Agent skill

Arxiv API

by wentorai in wentorai/research-plugins

Search and retrieve preprints from the arXiv open-access repository

MITAuto-check passedResearch & Science

Install Arxiv API

skills CLI
$ npx skills add wentorai/research-plugins --skill arxiv-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wentorai/research-plugins arxiv-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/literature/search/arxiv-api .claude/skills/arxiv-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
arxiv-api
GitHub stars
298
Used in
1 other repo
Token cost
~1.2k tokens
SKILL.md length
464 words
Files
1
Skills in repo
405
Repo updated
First seen
Licence
MIT

At a glance

Search and retrieve preprints from the arXiv open-access repository

  • Tasks that involve Academic paper search
  • SKILL.md covers Overview, Authentication, Using the search_arxiv Tool and Core Endpoints (Raw API…, plus 3 more sections
  • Calls curl; reaches export.arxiv.org

What it does

Arxiv API is an agent skill from wentorai/research-plugins. Search and retrieve preprints from the arXiv open-access repository

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Academic paper search. It works with arXiv. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Academic paper search

Example prompts

  • “/arxiv-api”

What it can do on your machine

Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • export.arxiv.org

    Also links to:

    • info.arxiv.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Arxiv API loads about 1.2k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 464 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 464 words, ~1,232 tokens.

Download SKILL.mdSave it as .claude/skills/arxiv-api/SKILL.md (or your agent's skills folder).
name
arxiv-api
description
Search and retrieve preprints from the arXiv open-access repository

arXiv API Guide

Overview

The arXiv API provides programmatic access to the arXiv preprint repository, one of the most important open-access archives in the sciences. Founded in 1991, arXiv hosts over 2.4 million scholarly articles across physics, mathematics, computer science, quantitative biology, quantitative finance, statistics, electrical engineering and systems science, and economics.

Researchers use the arXiv API to build literature review tools, monitor new submissions in their fields, and integrate preprint search into automated research workflows. The API returns results in Atom XML format with rich metadata including titles, authors, abstracts, categories, DOIs, and journal references.

The API is free to use with no authentication required. It supports complex boolean queries across multiple fields and allows sorting by relevance, submission date, or last-updated date.

Authentication

No authentication required. The arXiv API is fully open. However, users must respect the rate limit of 3 requests per second. Excessive usage may result in temporary IP-based blocking. Including a descriptive User-Agent header is considered good practice.

Using the search_arxiv Tool

IMPORTANT: When calling the search_arxiv tool, use parameter name query (NOT search_query). The raw API uses search_query, but the tool wrapper accepts query.

search_arxiv({ query: "ti:transformer AND cat:cs.CL", sort_by: "submittedDate" })

Core Endpoints (Raw API Reference)

Query: Search for Articles
  • URL: GET http://export.arxiv.org/api/query
  • Parameters (raw API — the search_arxiv tool wraps these automatically):
    ParamTypeRequiredDescription
    search_querystringYesQuery string using arXiv field prefixes (ti, au, abs, cat, id)
    id_liststringNoComma-separated arXiv IDs for direct lookup
    startintegerNoStarting index for pagination (default: 0)
    max_resultsintegerNoNumber of results to return (default: 10, max: 30000)
    sortBystringNoSort field: relevance, lastUpdatedDate, submittedDate
    sortOrderstringNoascending or descending
  • Example:
    bash
    curl "http://export.arxiv.org/api/query?search_query=au:hinton+AND+ti:deep+learning&start=0&max_results=5&sortBy=submittedDate&sortOrder=descending"
  • Response: Atom XML feed with <entry> elements containing <title>, <summary>, <author>, <arxiv:primary_category>, <published>, <updated>, and <link> fields.
Show full SKILL.md (176 more words)Show less
ID Lookup: Retrieve Specific Papers
  • URL: GET http://export.arxiv.org/api/query
  • Parameters:
    ParamTypeRequiredDescription
    id_liststringYesComma-separated arXiv IDs (e.g., 2301.00001,2301.00002)
    max_resultsintegerNoNumber of results to return
  • Example:
    bash
    curl "http://export.arxiv.org/api/query?id_list=2301.07041&max_results=1"
  • Response: Atom XML feed with full metadata for the requested paper(s).

Rate Limits

The arXiv API enforces a rate limit of 3 requests per second. There is no daily request cap, but automated bulk downloading should be done using the arXiv bulk data access options instead of the API. If you exceed the rate limit, you will receive HTTP 503 responses. Implement exponential backoff and a minimum 3-second delay between requests to avoid being temporarily blocked.

Common Patterns

Monitor New Submissions in a Category

Track daily submissions in a specific arXiv category by querying with a date range and category filter:

bash
curl "http://export.arxiv.org/api/query?search_query=cat:cs.AI+AND+submittedDate:[202603010000+TO+202603092359]&sortBy=submittedDate&sortOrder=descending&max_results=50"
Build a Reading List from Keywords

Search across titles and abstracts for specific research topics:

bash
curl "http://export.arxiv.org/api/query?search_query=(ti:transformer+OR+abs:transformer)+AND+cat:cs.CL&max_results=20&sortBy=relevance"
Batch Metadata Retrieval

Retrieve metadata for multiple known papers in a single request:

bash
curl "http://export.arxiv.org/api/query?id_list=2301.07041,2302.13971,2303.08774&max_results=3"

References

© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/literature/search/arxiv-api of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Arxiv API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Arxiv API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arxiv API this skillwentorai/research-plugins2981 repos~1.2kAutomated safety check: PassMIT
Read arXiv Paperkarpathy/nanochat58k2 repos~494Automated safety check: PassMIT
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT
Citation ManagementK-Dense-AI/claude-scientific-writer2.4k3 repos~3.9kAutomated safety check: NotesMIT
Openalex Databaseneflibata-feng/MyArxiv-Agent12613 repos~3kAutomated safety check: PassCustom licence
Citation Managementneflibata-feng/MyArxiv-Agent12620 repos~8.1kAutomated safety check: NotesMIT

Similar skills

  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    58k GitHub starsUsed in 2 repos~494 tokens
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Citation Management

    K-Dense-AI/claude-scientific-writer

    Finds papers in OpenAlex, PubMed and Google Scholar, turns DOIs, PMIDs and arXiv IDs into clean BibTeX, and validates citations for a manuscript or thesis.

    2.4k GitHub starsUsed in 3 repos~3.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 13 repos~3k tokens
    Research & ScienceAuto-check passed
  • Citation Management

    neflibata-feng/MyArxiv-Agent

    Comprehensive citation management for academic research. An agent skill from neflibata-feng/MyArxiv-Agent.

    126 GitHub starsUsed in 20 repos~8.1k tokens
    Research & ScienceAuto-check: notes
  • Paper Research on arXiv

    XiaomiMiMo/MiMo-Code

    Searches arXiv, fetches metadata, generates BibTeX, downloads PDFs and finds citations and related papers using a bundled Python script.

    14k GitHub starsUsed in 1 repo~1.5k tokens
    Research & ScienceAuto-check passed

More from wentorai/research-plugins

All 405 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Works with

Questions about Arxiv API

What does Arxiv API do?

Search and retrieve preprints from the arXiv open-access repository. Arxiv API is an agent skill from wentorai/research-plugins.

When should I use Arxiv API?

Arxiv API fits situations like: tasks that involve Academic paper search.

How do I install Arxiv API in Claude Code?

Run `npx skills add wentorai/research-plugins --skill arxiv-api -a claude-code`. Or copy the skill folder (skills/literature/search/arxiv-api in wentorai/research-plugins) into .claude/skills/arxiv-api in your project. Claude Code loads it when a task matches its description.

How do I install Arxiv API in Codex?

Run `npx skills add wentorai/research-plugins --skill arxiv-api -a codex`. Or copy the skill folder (skills/literature/search/arxiv-api in wentorai/research-plugins) into .agents/skills/arxiv-api in your project. Codex loads it when a task matches its description.

Can I use Arxiv API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill arxiv-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/arxiv-api, .gemini/skills/arxiv-api, .github/skills/arxiv-api and .opencode/skills/arxiv-api in your project.

What does Arxiv API need to run?

Going by SKILL.md and its folder, Arxiv API needs the command-line tools its instructions call (curl).

Does Arxiv API access the network?

SKILL.md names 2 domains. In commands or code: export.arxiv.org; the agent is likely to contact it when it follows the instructions. As links in the text: info.arxiv.org. This is read from the text; nothing was executed.

Is Arxiv API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Arxiv API use?

Arxiv API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Arxiv API use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Arxiv API?

Skills that share tags, products or a category with Arxiv API: Read arXiv Paper (karpathy/nanochat, 58k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Citation Management (K-Dense-AI/claude-scientific-writer, 2.4k stars) and Openalex Database (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arxiv API?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.

Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.