Saucebox Registry
← Browse

@openags/paper-search

A

Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc). Use when the user asks to find papers, search for research, look up academic literature, download a paper PDF, or extract text from a paper.

skillclaude

Install

agr install @openags/paper-search --target claude

Writes 1 file into .claude/skills/, pinned to git-affddf3a.

  • .claude/skills/paper-search/SKILL.md

Document

name: paper-search description: Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc). Use when the user asks to find papers, search for research, look up academic literature, download a paper PDF, or extract text from a paper.

Paper Search

Search, download, and read academic papers via the paper-search CLI.

CLI Usage

All commands run via:

paper-search <command> [args]

If paper-search is not available, install it with uv tool install paper-search-mcp. Optional API keys can be configured in ~/.config/paper-search-mcp/.env.

Search

paper-search search "<query>" -n <max_per_source> -s <sources> -y <year>
  • -n: results per source (default: 5)
  • -s: comma-separated sources or "all" (default: all)
  • -y: year filter for Semantic Scholar (e.g. "2020", "2018-2022")

For speed, prefer targeted sources (-s arxiv,semantic,crossref) over "all" unless broad coverage is needed.

Download PDF

paper-search download <source> <paper_id> [-o ./downloads]

Read (extract text)

paper-search read <source> <paper_id> [-o ./downloads]

List sources

paper-search sources

Output

search and download return JSON. read returns plain text. Config warnings go to stderr and can be ignored.

Sources

arxiv, pubmed, biorxiv, medrxiv, google_scholar, iacr, semantic, crossref, openalex, pmc, core, europepmc, dblp, openaire, citeseerx, doaj, base, zenodo, hal, ssrn, unpaywall

Optional (env vars): ieee (IEEE_API_KEY), acm (ACM_API_KEY)

Workflow

  1. Search with targeted sources to find papers
  2. Present results as a table: title, authors, year, source, DOI/URL
  3. If the user wants full text, use read <source> <paper_id>
  4. If the user wants the PDF, use download <source> <paper_id> and report the saved path

Trustgrade A

  • passBody integrity

    Whether the stored document is plausibly the kind of file the artifact declares, rather than something fetched by mistake.

  • passType matchnot applicable to this artifact type

    Whether the artifact is really the kind of thing its metadata claims it is.

  • passFreshness

    How long since the source repository was last pushed to.

  • passPrompt injection

    Scans the artifact's own text for instructions aimed at your agent rather than at you.

  • passLicense

    Whether the source repository declares an SPDX license permissive enough to redistribute.

How the grade is calculated

Each check contributes 0 points when it passes, 1 when it warns, and 2 when it fails. The total maps to a letter:

  • Aevery check passed
  • Bone warning
  • Ctwo warnings
  • Dprompt injection or body integrity failed, or three warnings
  • Fone of those failed, and something else is wrong

These are automated hygiene checks, not a security audit, and not a dependency or vulnerability scan. A grade of A means nothing was flagged — not that the artifact is safe.

Versions

  • git-affddf3a4dc42026-07-31