Agent skill
paper-search
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.
Install this agent skill to your Project
npx add-skill https://github.com/openags/paper-search-mcp/tree/main/claude-code
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
kirby-i18n-workflows
Manages Kirby multi-language workflows, translations, and localized labels. Use when dealing with languages, translation keys, placeholders, or importing/exporting translations.
kirby-security-and-auth
Secures Kirby sites with access restriction, user roles, permissions, and protected downloads. Use when implementing login/role-based access, permissions, or file protection.
kirby-headless-api
Exposes Kirby content to headless clients using the API, KQL, and JSON representations. Use when building API endpoints, KQL queries, or headless frontends.
kirby-performance-and-media
Improves Kirby performance and media delivery (cache tuning, CDN, responsive images, lazy loading). Use when optimizing page speed, caching, or image handling.
kirby-panel-and-blueprints
Designs Kirby blueprints and Panel UI, including blueprint reuse/extends, programmable blueprints, and custom Panel fields/sections/areas. Use when changing the Panel experience or schema.
kirby-upgrade-and-maintenance
Upgrades Kirby and maintains dependencies safely using composer audit, plugin compatibility checks, and official docs. Use when updating Kirby versions or making maintenance changes that affect runtime.
Didn't find tool you were looking for?