科研 Skill
论文检索助手
paper-lookup
跨学术数据库检索论文元数据
Skill 说明
10 个学术库 REST 检索一站式入口(PubMed / PMC / bioRxiv / medRxiv / arXiv / OpenAlex / Crossref / Semantic Scholar / CORE / Unpaywall),输入关键词 / 标题 / DOI,输出统一格式 JSON 论文列表(title / authors / year / abstract / DOI / venue / 引用数),全部免 key 公共 API | 输入:关键词 / 标题 / DOI | 输出:统一格式 JSON 论文列表(title / authors / year / abstract / DOI / venue / 引用数);覆盖 PubMed / PMC / bioRxiv / arXiv / OpenAlex / Crossref / Semantic Scholar / CORE / Unpaywall
SKILL.md
Paper Lookup
Use the available tools to find papers and verify them against authoritative sources.
Core Workflow
-
Start with web search for ordinary lookups. When available, prefer
web_searchfor topic, title, author, DOI/PMID, and preprint lookups. For a known URL, open it directly withweb_fetch. You can target a site such as PubMed or arXiv in the web query. -
Verify the useful hits. Use
web_fetchon publisher, journal, DOI, or official repository pages. Check the title, authors, year, and identifier where available. For findings about the paper, use the abstract or full text from the source page. Search snippets are leads. Return the verified papers once they answer the request. -
Use an academic API when it adds something the task needs. Examples include an explicitly requested database or query syntax, a reproducible systematic search, a batch export, identifier conversion, a citation graph, or missing results or metadata after web search. If web search is unavailable, choose a relevant database using the guide below. OpenAlex and the arXiv API are optional for ordinary lookups.
-
Read the relevant reference file before an API call. The files in
references/contain endpoint details, query formats, and examples. See Making API Calls for transport and error handling. -
Return results. Give the verified citation, source link, and relevance. Report gaps and distinguish a failed query from an empty result. For API-based requests, list the databases and endpoints queried and include the requested structured results.
Database Selection Guide
Use this guide after deciding that a database API is needed.
By Use Case
| User is asking about... | Primary database(s) | Also consider |
|---|---|---|
| Papers on a biomedical topic | PubMed | Semantic Scholar, OpenAlex |
| Full text of a biomedical article | PMC | CORE |
| Biology preprints | bioRxiv | Semantic Scholar, OpenAlex |
| Health/medical preprints | medRxiv | Semantic Scholar, OpenAlex |
| Physics, math, or CS preprints | arXiv | Semantic Scholar, OpenAlex |
| Papers across all fields | OpenAlex | Semantic Scholar, Crossref |
| A specific paper by DOI | Crossref | Unpaywall, Semantic Scholar |
| Open access PDF for a paper | Unpaywall | CORE, PMC |
| Citation graph (who cites whom) | Semantic Scholar | OpenAlex |
| Author's publications | Semantic Scholar | OpenAlex |
| Paper recommendations | Semantic Scholar | -- |
| Full text (any field) | CORE | PMC (biomedical only) |
| Journal/publisher metadata | Crossref | OpenAlex |
| Funder information | Crossref | OpenAlex |
| Convert between PMID/PMCID/DOI | PMC (ID Converter) | Crossref |
| Recent preprints by date | bioRxiv, medRxiv | arXiv |
Cross-Database Queries
| User is asking about... | Databases to query |
|---|---|
| Everything about a paper (metadata + citations + OA) | Crossref + Semantic Scholar + Unpaywall |
| Comprehensive literature search | PubMed + OpenAlex + Semantic Scholar |
| Find and read a paper | PubMed (find) + Unpaywall (OA link) + PMC or CORE (full text) |
| Preprint and its published version | bioRxiv/medRxiv + Crossref |
| Author overview with citation metrics | Semantic Scholar + OpenAlex |
When a query spans multiple needs (e.g., "find papers about CRISPR and get me the PDFs"), query the relevant databases in parallel.
Common Identifier Formats
Different databases use different identifier systems. If a query fails, the identifier format may be wrong.
| Identifier | Format | Example | Used by |
|---|---|---|---|
| DOI | 10.xxxx/xxxxx | 10.1038/nature12373 | All databases |
| PMID | Integer | 34567890 | PubMed, PMC, Semantic Scholar |
| PMCID | PMC + digits | PMC7029759 | PMC, Europe PMC |
| arXiv ID | YYMM.NNNNN | 2103.15348 | arXiv, Semantic Scholar |
| OpenAlex ID | W + digits | W2741809807 | OpenAlex |
| Semantic Scholar ID | 40-char hex | 649def34f8be... | Semantic Scholar |
| ORCID | 0000-XXXX-XXXX-XXXX | 0000-0001-6187-6610 | OpenAlex, Crossref |
| ISSN | XXXX-XXXX | 0028-0836 | Crossref, OpenAlex |
Cross-referencing IDs: Semantic Scholar accepts DOI, PMID, PMCID, and arXiv ID via prefixes (e.g., DOI:10.1038/nature12373, PMID:34567890, ARXIV:2103.15348). OpenAlex accepts DOI and PMID via prefixes (doi:10.1038/..., pmid:34567890). Use the PMC ID Converter to translate between PMID, PMCID, and DOI.
API Keys and Access
Most of these databases are fully open. A few benefit from API keys for higher rate limits.
Databases requiring or benefiting from API keys
| Database | Env Variable | Required? | Registration |
|---|---|---|---|
| NCBI (PubMed, PMC) | NCBI_API_KEY | No (3 req/s without, 10 with) | https://www.ncbi.nlm.nih.gov/account/settings/ |
| CORE | CORE_API_KEY | Yes for full text | https://core.ac.uk/services/api |
| Semantic Scholar | S2_API_KEY | No (shared pool without) | https://www.semanticscholar.org/product/api#api-key-form |
| OpenAlex | OPENALEX_API_KEY | Recommended | https://openalex.org/settings/api |
Fully open databases (no key needed)
| Database | Notes |
|---|---|
| bioRxiv / medRxiv | No auth, no documented rate limits |
| arXiv | No auth, max 1 request per 3 seconds |
| Crossref | No auth; add mailto param for polite pool (2x rate limit) |
| Unpaywall | No auth; requires email parameter |
Loading API keys
- Check the environment first -- the key may already be exported (e.g.,
$NCBI_API_KEY). - Fall back to
.env-- check.envin the current working directory. - Proceed without -- most APIs still work at lower rate limits. Tell the user which key is missing and how to get one.
Making API Calls
Use your environment's HTTP fetch tool to call REST endpoints:
| Platform | HTTP Fetch Tool | Fallback |
|---|---|---|
| Claude Code | WebFetch | curl via Bash |
| Gemini CLI | web_fetch | curl via shell |
| Windsurf | read_url_content | curl via terminal |
| Cursor | No dedicated fetch tool | curl via run_terminal_cmd |
| Codex CLI | No dedicated fetch tool | curl via shell |
| Cline | No dedicated fetch tool | curl via execute_command |
If the fetch tool fails, fall back to curl via whatever shell tool is available.
Special cases
- arXiv returns Atom XML, not JSON. Parse it or use
curland extract the relevant fields. Consider piping through a simple parser if available. - PMC eFetch returns JATS XML for full text. This is expected -- full text articles are in XML format.
- Crossref and Unpaywall benefit from including a
mailtoparameter or email for the polite/fast pool.
Request guidelines
- For NCBI APIs (PubMed, PMC): max 3 req/sec without key, 10 with key. Make requests sequentially.
- For arXiv: max 1 request every 3 seconds. Be patient.
- For Crossref: 5 req/sec (public), 10 req/sec (polite pool with
mailto). - For other APIs with no strict limits, you can query multiple databases in parallel.
- If you get HTTP 429 (rate limit), wait briefly and retry once.
Error recovery
- Check the identifier format -- use the Common Identifier Formats table. A PMID won't work in arXiv, an arXiv ID won't work in PubMed directly.
- Try alternative identifiers -- if a DOI fails in one database, try the title or PMID instead.
- Try a different database -- if PubMed returns nothing for a CS paper, try Semantic Scholar or OpenAlex.
- Report the failure -- tell the user which database failed, the error, and what you tried instead.
Output Format
For ordinary lookups, return the verified citations with links and a short relevance note. For database-specific or structured requests, use this format:
## Databases Queried
- **PubMed** -- esearch + esummary for "CRISPR gene therapy"
- **Unpaywall** -- DOI lookup for 10.1038/...
## Results
### PubMed
[raw JSON response or formatted results]
### Unpaywall
[raw JSON response]
If API results are large, present the most relevant portion and note that more data is available. Include raw JSON or parsed XML when requested.
Available Databases
Read the relevant reference file before making any API call.
Biomedical Literature
| Database | Reference File | What it covers |
|---|---|---|
| PubMed | references/pubmed.md | 37M+ biomedical citations, abstracts, MeSH terms |
| PMC | references/pmc.md | 10M+ full-text biomedical articles (JATS XML), ID conversion |
Preprint Servers
| Database | Reference File | What it covers |
|---|---|---|
| bioRxiv | references/biorxiv.md | Biology preprints (browse by date/DOI, no keyword search) |
| medRxiv | references/medrxiv.md | Health sciences preprints (browse by date/DOI, no keyword search) |
| arXiv | references/arxiv.md | Physics, math, CS, biology, economics preprints (keyword search, Atom XML) |
Multidisciplinary Indexes
| Database | Reference File | What it covers |
|---|---|---|
| OpenAlex | references/openalex.md | 250M+ works, authors, institutions, topics, citation data |
| Crossref | references/crossref.md | 150M+ DOI metadata, journals, funders, references |
| Semantic Scholar | references/semantic-scholar.md | 200M+ papers, citation graphs, AI-generated TLDRs, recommendations |
Open Access & Full Text
| Database | Reference File | What it covers |
|---|---|---|
| CORE | references/core.md | 37M+ full texts from OA repositories worldwide |
| Unpaywall | references/unpaywall.md | OA status and PDF links for any DOI |
相关科研 Skill
中药材分子鉴定用ITS2等DNA条形码鉴定药材基原物种,处理多基原与降解样品局限。适用于药材真伪鉴别研究,不替代法定检验。
中药网络药理学用TCMSP等数据库构建成分-靶点-通路网络并做富集分析,批判性讨论方法学局限。适用于中药机制假设生成与论文方法复核。
中医术语标准与知识图谱建立中医药术语与WHO/ICD-11标准的映射,设计本体并用Neo4j构建知识图谱。适用于数据整合与科研检索,不作临床决策系统。
方剂配伍规律挖掘对方剂做药名规范化、关联规则与网络聚类分析,发现候选核心药组。适用于用药规律挖掘,结果仅为待验证假设,不作处方依据。
证候与症状数据分析对症状量表数据做术语规范、潜在类别与因子分析,探索统计学证候模式。适用于证候分型研究,结果不用于个体辨证诊断。
泵用混合物热力学计算Calculates thermodynamic properties and mixture phase behavior for pump applications using the thermo Python library’s DIPPR/NIST correlations. Use for VLE or mixture property calculations.
常见问题
论文检索助手能做什么?
10 个学术库 REST 检索一站式入口(PubMed / PMC / bioRxiv / medRxiv / arXiv / OpenAlex / Crossref / Semantic Scholar / CORE / Unpaywall),输入关键词 / 标题 / DOI,输出统一格式 JSON 论文列表(title / authors / year / abstract / DOI / venue / 引用数),全部免 key 公共 API | 输入:关键词 / 标题 / DOI | 输出:统一格式 JSON 论文列表(title / authors / year / abstract / DOI / venue / 引用数);覆盖 PubMed / PMC / bioRxiv / arXiv / OpenAlex / Crossref / Semantic Scholar / CORE / Unpaywall。
如何安装论文检索助手?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「论文检索助手」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
论文检索助手需要哪些权限?
该科研 Skill声明需要:本地文件、联网。安装前会再次列出,由你确认后才会生效。
论文检索助手经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。