Paper Search
openags/paper-search-mcp
Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc).
学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server. An agent skill from dr-dumpling/paper-search-cli.
$ npx skills add dr-dumpling/paper-search-cli --skill paper-search -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dr-dumpling/paper-search-cli paper-search --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/dr-dumpling/paper-search-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/paper-search .claude/skills/paper-search && rm -rf skills-srcUse ~/.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/
Install the "paper-search" agent skill from https://github.com/dr-dumpling/paper-search-cli/tree/main/skills/paper-search into .claude/skills/paper-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-search", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/dr-dumpling/paper-search-cli/tree/main/skills/paper-searchType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add dr-dumpling/paper-search-cli --skill paper-search -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dr-dumpling/paper-search-cli paper-search --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dr-dumpling/paper-search-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/paper-search .agents/skills/paper-search && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "paper-search" agent skill from https://github.com/dr-dumpling/paper-search-cli/tree/main/skills/paper-search into .agents/skills/paper-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-search", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dr-dumpling/paper-search-cli --skill paper-search -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dr-dumpling/paper-search-cli paper-search --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dr-dumpling/paper-search-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/paper-search .cursor/skills/paper-search && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "paper-search" agent skill from https://github.com/dr-dumpling/paper-search-cli/tree/main/skills/paper-search into .cursor/skills/paper-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-search", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/dr-dumpling/paper-search-cli.git --path skills/paper-search--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add dr-dumpling/paper-search-cli --skill paper-search -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dr-dumpling/paper-search-cli paper-search --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dr-dumpling/paper-search-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/paper-search .gemini/skills/paper-search && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "paper-search" agent skill from https://github.com/dr-dumpling/paper-search-cli/tree/main/skills/paper-search into .gemini/skills/paper-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-search", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install dr-dumpling/paper-search-cli paper-searchInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add dr-dumpling/paper-search-cli --skill paper-search -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/dr-dumpling/paper-search-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/paper-search .github/skills/paper-search && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "paper-search" agent skill from https://github.com/dr-dumpling/paper-search-cli/tree/main/skills/paper-search into .github/skills/paper-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-search", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dr-dumpling/paper-search-cli --skill paper-search -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install dr-dumpling/paper-search-cli paper-search --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dr-dumpling/paper-search-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/paper-search .opencode/skills/paper-search && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "paper-search" agent skill from https://github.com/dr-dumpling/paper-search-cli/tree/main/skills/paper-search into .opencode/skills/paper-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-search", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
paper-search学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server. An agent skill from dr-dumpling/paper-search-cli.
Paper Search is an agent skill from dr-dumpling/paper-search-cli. 学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server。 用于:搜索论文、查找相似研究、做文献综述初筛、验证 PMID/DOI、下载论文 PDF、 调用 Crossref/OpenAlex/PubMed/PMC/Europe PMC/arXiv/bioRxiv/medRxiv/Semantic Scholar/CORE/OpenAIRE/DBLP/ACM/USENIX/OpenReview/IACR 等来源, 使用 Semantic Scholar Open Access snippet 索引检索论文正文片段中的方法学细节, 通过 Semantic Scholar Graph API 查询已知论文的施引文献和参考文献, 以及通过 EasyScholar 查询期刊影响因子、JCR/SSCI 分区、中科院分区、JCI、ESI、预警和等级指标。 当用户提到“搜文献”“找论文”“文献检索”“search papers”“find papers”“literature search” “查一下有没有相关研究”“帮我找几篇参考文献”“看看别人怎么做的”“别人怎么写” “Methods…
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/capability-routing.md`, `references/cli-contract.md` and `references/management-layer.md`).
It sits in Research & Science, covering Academic paper search. It works with Semantic Scholar, arXiv, Model Context Protocol and PubMed. The repository describes itself as: Agent-friendly CLI for academic paper, journal metric search and paper download. The licence is MIT.
2 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit d202649. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
npmgitFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm and git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
EASYSCHOLAR_KEYSEMANTIC_SCHOLAR_API_KEYFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Paper Search loads about 1.1k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 203 tokens; SKILL.md has 242 words of instructions outside code blocks.
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.
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.
The full file from dr-dumpling/paper-search-cli at commit d202649, republished under its MIT licence (© dr-dumpling). 242 words, ~1,139 tokens.
.claude/skills/paper-search/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.你是学术文献检索调度器。本 Skill 是 Routing Skill:负责把用户意图路由到 paper-search CLI,并维护证据、密钥和下载边界。优先通过 paper-search CLI 完成论文检索、元数据核验、施引/参考文献扩展、正文片段检索、期刊指标查询和 PDF 获取;不要把本 Skill 当作密钥、cookie、账号或下载策略的存储位置。
Reference 读取规则:
references/management-layer.md。references/capability-routing.md。paper-search run 工具名、输出格式或密钥边界时,读 references/cli-contract.md。paper-search --help / paper-search tools 冲突,以实际 CLI 为准,并报告需要更新 Skill。第一次使用、环境不确定,或用户问“现在能用哪些能力”时:
command -v paper-search
paper-search doctor --pretty需要给用户一份可读健康报告时:
paper-search doctor --format text安装缺失时先说明缺失;用户要求安装时再执行:
npm install -g paper-search-cli
paper-search setup
paper-search doctor --pretty用户问“如何更新”、安装后怀疑 Skill 过期,或 doctor/skills status 显示 Skill 不同步时,先区分包本体更新和 Skill 同步;不要只运行 skills update。完整流程查看 references/management-layer.md 的 Package Update And Capability Setup。
普通用户更新:
npm install -g paper-search-cli@latest
paper-search skills update --targets agents --pretty
paper-search doctor --pretty本地维护者更新:
git pull
npm install
npm run build
npm install -g .
paper-search skills update --targets agents --pretty
paper-search doctor --pretty缺少 API key 或 email 时,不要让用户在聊天里发送密钥;提示用户用 paper-search setup 或 paper-search config 在本机配置。
本 Skill 只有五个文献主功能。doctor、smoke、config、skills 是管理层命令,不属于文献任务本身。
| 用户意图 | 能力名 | 首选入口 | 关键边界 |
|---|---|---|---|
| 搜论文、找相关研究、验证 DOI/PMID、做文献初筛 | metadata_search | paper-search search 集成入口 / paper-search run search_* 精确工具入口 | 只返回和核验论文元数据;Sci-Hub 不属于搜索源 |
| 查询已知论文的施引文献或参考文献 | citation_expansion | paper-search run get_paper_citations / paper-search run get_paper_references | 需要已知 paperId、DOI 或 arXiv ID;不是关键词检索 |
| 查影响因子、JCR/SSCI/中科院分区、JCI、ESI、预警、期刊等级 | journal_metrics | paper-search journal-metrics / paper-search run query_journal_metrics | 这是期刊指标查询,不是论文检索;需要 EASYSCHOLAR_KEY |
| 获取或下载已确认论文的 PDF | pdf_discovery | paper-search download / paper-search run download_with_fallback | 先核验论文身份,再下载;Sci-Hub 是默认开启的最后 fallback |
| 在论文正文片段中找 Methods/参数/写法线索 | body_snippet_search | paper-search run search_semantic_snippets | 查 Semantic Scholar OA snippet 索引;需要 SEMANTIC_SCHOLAR_API_KEY;不是完整全文解析 |
开放式文献任务使用 Two-Stage Paper Workflow:
metadata_search:检索和核验文献条目,确认题名、作者、年份、期刊、DOI、PMID/PMCID、URL、摘要线索和相关性。pdf_discovery:下载选中的已核验条目;下载失败项记录原因,不阻塞其他条目。Direct Paper Request 可以跳过广泛发现:用户给出单个 DOI、PMID、PMCID、arXiv ID 或已核验清单并明确要求下载时,先核验目标身份,再进入下载。
关键论文输出前尽量验证:
paper-search run search_pubmed --arg query="37654321[PMID]" --arg maxResults=1 --pretty
paper-search run get_paper_by_doi --arg doi="10.xxxx/xxxxx" --pretty
paper-search run search_crossref --arg query="full paper title" --arg maxResults=3 --pretty规则:
config / doctor 输出应视为已脱敏,但不要复述、保存或写入任何原始密钥。| 场景 | 处理 |
|---|---|
| CLI 不存在 | 提示安装 npm install -g paper-search-cli |
| API key 缺失 | 提示运行 paper-search setup;不要索要或保存 key |
| EasyScholar key 缺失 | 提示运行 paper-search setup EASYSCHOLAR_KEY;不要让用户在聊天中发送 SecretKey |
| 429 限流 | 降低 --max-results,换平台,或提示配置可选 key |
| 0 结果 | 放宽关键词,换英文同义词,换平台,或用 --sources 扩展 |
| 下载失败 | 优先开放获取来源和 download_with_fallback,报告失败原因 |
| 用户要求完整正文 | 先下载 PDF;再交给当前环境可用的 PDF/MinerU 解析流程 |
© dr-dumpling, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 3 other files (references) in skills/paper-search of dr-dumpling/paper-search-cli.
Open the folder on GitHubat commit d202649
Paper Search 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Paper Search this skilldr-dumpling/paper-search-cli | 135 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Paper Searchopenags/paper-search-mcp | 2.8k | — | ~1.2k | Automated safety check: Notes | MIT | |
| Nature Academic Searchwp-a/nature-academic-search | 301 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Paper Searchopenags/paper-search-mcp | 2.8k | — | ~794 | Automated safety check: Notes | MIT | |
| Nature Academic Searchjing1312/nature-figure-skill | 168 | — | ~1.3k | Automated safety check: Notes | MIT | |
| Ai4scholar ResearchDrchronx/ai-agent-research-starter-kit | 137 | — | ~1.4k | Automated safety check: Pass | Custom licence |
openags/paper-search-mcp
Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc).
wp-a/nature-academic-search
A skill your agent uses when users ask to 找文献、做文献检索、查论文、查临床试验、核验引用、去重文献、设计 PubMed/MeSH 检索式、追踪上下游引文、解析 DOI/PMID/PMCID/arXiv/OpenAlex/Semantic Scholar/NCT ID, 或导出 RIS、BibTeX、NBIB、ENW;also use for…
openags/paper-search-mcp
Search, download, and read academic papers through the paper-search MCP tools (mcppaper-search), covering arXiv, PubMed, bioRxiv, Semantic Scholar, Crossref, OpenAlex and 15+ other sources.
jing1312/nature-figure-skill
Multi-source literature search, citation verification, MeSH search strategy, citation file management (.nbib/.ris/.bib conversion), and reference management (BibTeX, related articles, ID conversion)…
Drchronx/ai-agent-research-starter-kit
Use AI4Scholar for real scholarly literature tasks through MCP or the OpenClaw plugin: paper search, Google Scholar/Semantic Scholar/PubMed/arXiv/bioRxiv/medRxiv queries, PDF download and reading…
neflibata-feng/MyArxiv-Agent
Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).
Categories
学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server. An agent skill from dr-dumpling/paper-search-cli. Paper Search is an agent skill from dr-dumpling/paper-search-cli.
Paper Search fits situations like: tasks that involve Academic paper search.
Run `npx skills add dr-dumpling/paper-search-cli --skill paper-search -a claude-code`. Or copy the skill folder (skills/paper-search in dr-dumpling/paper-search-cli) into .claude/skills/paper-search in your project. Claude Code loads it when a task matches its description.
Run `npx skills add dr-dumpling/paper-search-cli --skill paper-search -a codex`. Or copy the skill folder (skills/paper-search in dr-dumpling/paper-search-cli) into .agents/skills/paper-search in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dr-dumpling/paper-search-cli --skill paper-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paper-search, .gemini/skills/paper-search, .github/skills/paper-search and .opencode/skills/paper-search in your project.
Going by SKILL.md and its folder, Paper Search needs the command-line tools its instructions call (npm and git) and credentials named EASYSCHOLAR_KEY and SEMANTIC_SCHOLAR_API_KEY. Our summary lists: Node.js; A credential in EASYSCHOLAR_KEY; A credential in SEMANTIC_SCHOLAR_API_KEY.
SKILL.md contains no URLs. Its commands use npm and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
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.
Paper Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.4k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Paper Search: Paper Search (openags/paper-search-mcp, 2.8k stars), Nature Academic Search (wp-a/nature-academic-search, 301 stars), Paper Search (openags/paper-search-mcp, 2.8k stars) and Nature Academic Search (jing1312/nature-figure-skill, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
dr-dumpling (a GitHub user) maintains it in dr-dumpling/paper-search-cli, which has 135 GitHub stars. The repository was last updated on June 22, 2026.
Source: dr-dumpling/paper-search-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.