| 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:
uv run --directory <REPO_PATH> paper-search <command> [args]
Replace <REPO_PATH> with the absolute path to your clone of this repository.
Search
uv run --directory <REPO_PATH> 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
uv run --directory <REPO_PATH> paper-search download <source> <paper_id> [-o ./downloads]
Read (extract text)
uv run --directory <REPO_PATH> paper-search read <source> <paper_id> [-o ./downloads]
List sources
uv run --directory <REPO_PATH> 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
- Search with targeted sources to find papers
- Present results as a table: title, authors, year, source, DOI/URL
- If the user wants full text, use
read <source> <paper_id>
- If the user wants the PDF, use
download <source> <paper_id> and report the saved path
