K-Dense-AI/scientific-agent-skills / skills/paper-lookup
paper-lookup
FlaggedSearches 18 scholarly APIs for papers, preprints, citations, open-access full text, repository records, and journal OA status, and returns results with reproducible provenance. Covers PubMed, PMC, Europe PMC, bioRxiv, medRxiv, arXiv, OpenAlex, Crossref, Semantic Scholar, CORE, Unpaywall, OpenCitations, PubTator3, Zenodo, Figshare, ROR, BioStudies, and DOAJ. Use when searching for papers, citations, DOI/PMID/arXiv lookups, abstracts, full text, open-access PDFs, preprints, citation graphs, author publications, biomedical entity annotations, deposited records (Zenodo, Figshare, BioStudies), institution ROR IDs, or any scholarly literature query. Triggers on mentions of any supported database or requests like "find papers on X", "look up this DOI", "who cites this paper", or "get me the PDF".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 25.5 KB |
| references/arxiv.md | markdown | 11.9 KB |
| references/biorxiv.md | markdown | 6.7 KB |
| references/biostudies.md | markdown | 4.0 KB |
| references/core.md | markdown | 4.6 KB |
| references/crossref.md | markdown | 5.5 KB |
| references/doaj.md | markdown | 4.2 KB |
| references/europepmc.md | markdown | 9.0 KB |
| references/figshare.md | markdown | 3.1 KB |
| references/medrxiv.md | markdown | 5.0 KB |
| references/openalex.md | markdown | 5.5 KB |
| references/opencitations.md | markdown | 4.6 KB |
| references/pmc.md | markdown | 7.1 KB |
| references/pubmed.md | markdown | 4.5 KB |
| references/pubtator.md | markdown | 4.5 KB |
| references/ror.md | markdown | 4.2 KB |
| references/semantic-scholar.md | markdown | 7.1 KB |
| references/unpaywall.md | markdown | 3.5 KB |
| references/zenodo.md | markdown | 3.8 KB |
| scripts/_common.py | script | 8.2 KB |
| scripts/arxiv_atom.py | script | 8.0 KB |
| scripts/jats_to_text.py | script | 11.0 KB |
| scripts/openalex_abstract.py | script | 6.3 KB |
| scripts/paginate.py | script | 19.2 KB |
references/unpaywall.md
View on GitHub# Unpaywall API
Unpaywall tells you whether a legal, free copy of a scholarly article exists. Given a DOI, it returns open access status, PDF links, and location details.
## Base URL
```
https://api.unpaywall.org/v2
```
## Authentication
No API key. You must include your **email address** as a query parameter: `?email=you@example.com`
**Important:** Use a real email address. Unpaywall rejects placeholder emails like `test@example.com` with HTTP 422.
## Rate Limits
100,000 calls per day. For heavier use, download the database snapshot.
## Key Endpoints
### 1. DOI Lookup
```
GET /v2/{doi}?email=you@example.com
```
**Example:**
```
https://api.unpaywall.org/v2/10.1038/nature12373?email=you@example.com
```
### 2. Search (retired)
```
GET /v2/search?query={text}&email=you@example.com
```
**Retired on 2026-09-18; returns HTTP 410 Gone.** Use OpenAlex `/works?search=...` for discovery, or find papers in PubMed/Semantic Scholar and use the supported Unpaywall DOI lookup. Do not retry the retired search route.
## Response Format
### DOI Lookup response
```json
{
"doi": "10.1038/nature12373",
"doi_url": "https://doi.org/10.1038/nature12373",
"title": "Nanometre-scale thermometry in a living cell",
"year": 2013,
"published_date": "2013-07-31",
"genre": "journal-article",
"publisher": "Springer Nature",
"is_oa": true,
"oa_status": "green",
"best_oa_location": {
"url": "https://dash.harvard.edu/bitstream/1/...",
"url_for_pdf": "https://dash.harvard.edu/bitstream/1/...pdf",
"url_for_landing_page": "https://dash.harvard.edu/handle/...",
"host_type": "repository",
"version": "acceptedVersion",
"license": "cc-by",
"is_best": true,
"oa_date": "2016-01-01"
},
"first_oa_location": {...},
"oa_locations": [...],
"has_repository_copy": true,
"journal_name": "Nature",
"journal_issns": "0028-0836,1476-4687",
"journal_issn_l": "0028-0836",
"journal_is_oa": false,
"journal_is_in_doaj": false,
"z_authors": [
{"raw_author_name": "G. Kucsko", "author_position": "first"},
{"raw_author_name": "P. C. Maurer", "author_position": "middle"}
]
}
```
### OA Status values
| Status | Meaning |
|--------|---------|
| `gold` | Published in a fully OA journal |
| `hybrid` | OA in a subscription journal (publisher-hosted) |
| `bronze` | Free to read on publisher site but no OA license |
| `green` | Available via a repository (e.g., institutional, preprint) |
| `closed` | No free legal copy found |
### OA Location fields
| Field | Description |
|-------|-------------|
| `url` | Best URL (PDF if available, else landing page) |
| `url_for_pdf` | Direct PDF URL (null if no PDF) |
| `url_for_landing_page` | Landing page URL |
| `host_type` | `publisher` or `repository` |
| `version` | `submittedVersion`, `acceptedVersion`, `publishedVersion` |
| `license` | e.g., `cc-by`, `cc-by-nc`, `implied-oa`, or null |
| `is_best` | Whether this is the `best_oa_location` |
| `oa_date` | When first available at this location |
## Typical Workflow
1. You have a DOI from PubMed, Crossref, or another source
2. Call Unpaywall with the DOI
3. Check `is_oa` and `best_oa_location`; use `url_for_pdf` if non-null, otherwise the landing-page URL. OA does not guarantee a direct PDF.
4. Check `oa_status` to understand what kind of OA it is
5. If closed, report that Unpaywall found no OA copy. This does not establish that every possible copy requires a subscription.
## Official sources reviewed 2026-09-30
- https://unpaywall.org/products/api
- https://unpaywall.org/data-format
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |