academic-paper-search
This skill should be used when the user asks to "search for academic papers", "find working papers on SSRN", "look up a DOI", "download paper PDF", "check open access availability", "search NBER papers", "find arXiv preprints", or "search CrossRef".
Install / Use
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill academic-paper-searchInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Finance & AccountingSupported Platforms
Our assessment of academic-paper-search
academic-paper-search scores 95/100 on our quality scale, 9th of 101 Finance & Accounting skills we index (top 9%).
Its SKILL.md is 14 KB long, well organised into 49 sections with 18 code examples: a thorough specification that gives an agent plenty to work with.
With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so academic-paper-search is actively maintained.
- Our last check on 2026-11-15 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
academic-paper-search compared with similar skills
All 4 of these similar skills score higher than academic-paper-search; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| academic-paper-search (this skill)by brycewang-stanford | 95 | 4.4k | 54d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install academic-paper-search?
- Run
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill academic-paper-search. The install tabs above show the steps for each supported agent. - Which AI agents does academic-paper-search work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is academic-paper-search safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is academic-paper-search still maintained?
- The repository was last updated about 2 months ago, so academic-paper-search is actively maintained.
Skill content
View source on GitHubname: academic-paper-search description: >- This skill should be used when the user asks to "search for academic papers", "find working papers on SSRN", "look up a DOI", "download paper PDF", "check open access availability", "search NBER papers", "find arXiv preprints", or "search CrossRef". Provides unified search, metadata retrieval, and PDF download across arXiv, NBER, SSRN, CrossRef, OpenAlex, Unpaywall, and Semantic Scholar. Covers economics, finance, social science, CS/AI, and all academic disciplines. allowed-tools:
- Bash
- Read
- Write
- Edit
- Glob
- Grep
- WebFetch
- WebSearch
- Agent
Academic Paper Search
A unified toolkit for discovering, retrieving metadata, and downloading academic papers across all major sources. The right API depends on the task β this skill routes to the best source.
Decision Tree: Which API to Use
What is needed?
β
ββ SEARCH for papers on a topic
β ββ arXiv preprints (CS/AI/Physics/Econ) βββ arXiv API
β ββ NBER working papers (economics) ββββββββ NBER API
β ββ SSRN working papers (social science) βββ OpenAlex (primary) + CrossRef prefix:10.2139
β ββ Published journal articles βββββββββββββ CrossRef API or OpenAlex
β ββ Broad multi-source search ββββββββββββββ OpenAlex API
β
ββ GET METADATA for a known paper
β ββ Have DOI βββ CrossRef (structured) or OpenAlex (richer)
β ββ Have arXiv ID βββ arXiv API
β ββ Have NBER number βββ NBER API
β ββ Have SSRN abstract ID βββ OpenAlex DOI lookup (DOI = 10.2139/ssrn.{id})
β
ββ FIND/DOWNLOAD PDF
β ββ Have DOI βββ Unpaywall API (check OA) β OpenAlex (alt PDF links)
β ββ arXiv paper βββ Direct: https://arxiv.org/pdf/{id}
β ββ NBER paper βββ Direct: https://www.nber.org/system/files/working_papers/w{n}/w{n}.pdf
β ββ SSRN paper βββ Unpaywall (~30%) or institutional repos (EconStor, IZA)
β
ββ IMPORT TO ZOTERO
ββ Always use zotero_add_by_doi (best metadata + auto PDF via Unpaywall cascade)
1. OpenAlex API (Best All-Round)
Free, no API key needed. Covers 250M+ works including SSRN, NBER, arXiv, all journals.
Add mailto=your@email.com for polite pool (faster responses).
Search by Source
# SSRN papers (source ID: S4210172589, NOT S4306400806 which is Europe PMC)
curl -s "https://api.openalex.org/works?filter=primary_location.source.id:S4210172589,default.search:social+preferences,publication_year:2024-2026&per_page=25&mailto=you@university.edu"
# NBER papers
curl -s "https://api.openalex.org/works?filter=primary_location.source.id:S4210174556,default.search:behavioral+economics&per_page=25&mailto=you@university.edu"
Search by Topic (All Sources)
curl -s "https://api.openalex.org/works?search=network+formation+game+theory&filter=publication_year:2024-2026&per_page=25&sort=cited_by_count:desc&mailto=you@university.edu"
DOI Lookup
curl -s "https://api.openalex.org/works/doi:10.2139/ssrn.4812743?mailto=you@university.edu"
Python Pattern
import requests
def openalex_search(query, source_id=None, year_from=2024, year_to=2026, per_page=25):
"""Search OpenAlex. source_id: S4210172589 (SSRN), S4210174556 (NBER), etc."""
filters = [f"default.search:{query}", f"publication_year:{year_from}-{year_to}"]
if source_id:
filters.insert(0, f"primary_location.source.id:{source_id}")
params = {
"filter": ",".join(filters),
"per_page": per_page,
"mailto": "you@university.edu"
}
data = requests.get("https://api.openalex.org/works", params=params).json()
results = []
for w in data.get("results", []):
pdf_urls = [loc["pdf_url"] for loc in w.get("locations", []) if loc.get("pdf_url")]
results.append({
"title": w["title"],
"doi": w.get("doi", "").replace("https://doi.org/", ""),
"year": w.get("publication_year"),
"authors": [a["author"]["display_name"] for a in w.get("authorships", [])],
"cited_by": w.get("cited_by_count", 0),
"pdf_urls": pdf_urls,
"landing_url": (w.get("primary_location") or {}).get("landing_page_url", ""),
})
return {"total": data.get("meta", {}).get("count", 0), "results": results}
Key Source IDs
Full reference: See
references/journal_identifiers.mdfor a comprehensive table of 77 verified OpenAlex Source IDs and CrossRef ISSNs covering Top 5 economics, AEA journals, finance, management, marketing, accounting, IS, and 15+ field journal categories.
| Source | OpenAlex ID | CrossRef ISSN | |--------|-------------|---------------| | SSRN Electronic Journal | S4210172589 | 1556-5068 | | NBER Working Papers | S2809516038 | N/A | | American Economic Review | S23254222 | 0002-8282 | | Quarterly Journal of Economics | S203860005 | 0033-5533 | | Econometrica | S95464858 | 0012-9682 |
Warning: OpenAlex source IDs are opaque and not guessable. Always verify
via https://api.openalex.org/sources?search=journal+name before using a new ID.
For verified IDs of 77 journals, consult references/journal_identifiers.md.
PDF from OpenAlex
primary_location.pdf_url is null for SSRN papers (Elsevier blocks it).
Check locations[].pdf_url for third-party repos β ~24% of SSRN papers have PDFs
via EconStor, IZA, MPRA, etc. These are real, downloadable PDFs.
2. CrossRef API (Best for DOI Metadata)
Free, no key needed. Add mailto= for 50 req/sec (vs 1 req/sec without).
Search with SSRN DOI Prefix
# All SSRN papers matching a query
curl -s "https://api.crossref.org/works?query=%22social+preferences%22&filter=prefix:10.2139,from-pub-date:2024-01-01&rows=25&sort=relevance&mailto=you@university.edu"
Search within a Journal
# See references/journal_identifiers.md for 77 verified ISSNs
# AER: 0002-8282, QJE: 0033-5533, JPE: 0022-3808, Econometrica: 0012-9682, REStud: 0034-6527
curl -s "https://api.crossref.org/journals/0002-8282/works?query=auction+mechanism&rows=10&mailto=you@university.edu"
DOI Lookup
curl -s "https://api.crossref.org/works/10.1257/aer.20171330?mailto=you@university.edu"
DOI Construction Rules
| Source | DOI Format | Example |
|--------|-----------|---------|
| SSRN | 10.2139/ssrn.{abstract_id} | 10.2139/ssrn.4812743 |
| NBER | 10.3386/w{number} | 10.3386/w34297 |
These predictable DOI formats allow constructing DOIs from paper IDs without making extra API calls.
Limitations
CrossRef returns title, authors, DOI, date, journal β but no abstracts for SSRN papers (Elsevier doesn't submit them to CrossRef). Use OpenAlex for richer metadata.
3. arXiv API (Preprints β CS/AI/Physics/Math/Econ)
Free, no key needed. Returns Atom XML. Rate limit: ~1 request per 3 seconds.
curl -s "https://export.arxiv.org/api/query?search_query=abs:social+preferences+AND+(cat:econ.TH+OR+cat:econ.GN)&max_results=20&sortBy=submittedDate&sortOrder=descending"
Search Prefixes
all: (full text), ti: (title), au: (author), abs: (abstract), cat: (category).
Boolean: AND, OR, ANDNOT. Exact phrase: %22social+preferences%22.
Economics Categories
econ.TH (Theory), econ.GN (General), econ.EM (Econometrics).
Caveat: The cat: filter in search_query does not always reliably restrict results
to specified categories β arXiv may still return papers from other fields.
Verify category matches in results and filter client-side if needed.
Direct PDF
https://arxiv.org/pdf/{id} # e.g. https://arxiv.org/pdf/2401.12345
https://arxiv.org/abs/{id} # abstract page
4. NBER API (Economics Working Papers)
Free, no key needed. Returns JSON.
# Search
curl -s "https://www.nber.org/api/v1/working_page_listing/contentType/working_paper/_/_/search?page=1&perPage=20&q=social+preferences"
# Filter by Program (replace _/_ with programs/{name})
curl -s "https://www.nber.org/api/v1/working_page_listing/contentType/working_paper/programs/Labor+Studies/search?page=1&perPage=20&q=minimum+wage"
# New this week
curl -s "https://www.nber.org/api/v1/working_page_listing/contentType/working_paper/_/_/search?page=1&perPage=20&newThisWeek=true"
Programs
Labor Studies, Economic Fluctuations and Growth, Industrial Organization, Public Economics, Development Economics, International Finance and Macroeconomics, Corporate Finance, Asset Pricing, Health Economics, etc.
Response Processing
Authors field contains HTML <a> tags β strip with: re.sub(r'<[^>]+>', '', text)
No built-in date filter β API sorts by relevance. Filter client-side by displaydate.
Direct PDF
https://www.nber.org/system/files/working_papers/w{number}/w{number}.pdf
5. Unpaywall API (Open Access PDF Finder)
Free, no key needed. Email as query param. 100,000 requests/day.
curl -s "https://api.unpaywall.org/v2/10.2139/ssrn.4812743?email=you@university.edu" \
| python3 -c "
import sys, json
d = json.load(sys.stdin)
print(f'OA: {d[\"is_oa\"]} ({d[\"oa_status\"]})')
pdf = (d.get('best_oa_location') or {}).get('url_for_pdf')
print(f'PDF: {pdf or \"none\"}')
# Check all locations for alternative PDFs
for loc in d.get('oa_locations', []):
if loc.get('url_for_pdf'):
print(f'Alt PDF: {loc[\"url_for_pdf\"]} ({loc[\"host_type\"]})')
"
OA Status Values
| Status | Meaning |
|--------|---------|
| gold | Published OA by publisher |
| green | Free copy in a repository |
| hybrid | OA article in subscription journal |
| bronze | Free to read on publisher site |
| closed | No free version found |
Platform-Specific PDF Availability
| Source | Unpaywall PDF Rate | Why | |--------|-------------------|-----| | arXiv | ~100% | Native OA, direct PDF links | | NBER | ~97% | Green OA via author/institution repos | | SSRN | ~30% | Cloudflare blocks Unpaywall; only finds institutional repo mirrors |
For SSRN papers where Unpaywall returns url_for_pdf=null, check oa_locations[]
for institutional repositories (EconStor, university repos) β follow their landing pages
to find PDF links.
6. Semantic Scholar API (Citations & Impact)
Free, no key needed. Rate limit: 100 requests per 5 minutes.
Warning: As of 2026, Semantic Scholar may return 429 errors frequently.
Consider registering for an API key at https://www.semanticscholar.org/product/api
for higher limits. Add header: x-api-key: YOUR_KEY.
# Search
curl -s "https://api.semanticscholar.org/graph/v1/paper/search?query=social+preferences+experiment&fields=title,year,authors,citationCount,externalIds,venue&limit=20&year=2024-2026"
# DOI lookup
curl -s "https://api.semanticscholar.org/graph/v1/paper/DOI:10.1257/aer.20171330?fields=title,year,authors,citationCount,abstract"
Field of Study Filter
fieldsOfStudy=Economics,Sociology,Political+Science,Business,Psychology
Warning: The Economics filter is very strict and may return 0 results.
Often better to search without it and filter manually.
When to Use
Best for: citation counts, finding related papers, author impact metrics. Not best for: SSRN-specific search (poor coverage), bulk downloading.
7. Tavily Search (Fallback for Any Source)
When APIs do not cover the need, Tavily can search any academic site. Particularly useful for SSRN (no public API) and as a fallback for any source.
# Via MCP tool
mcp__tavily__tavily-search({
"query": 'site:ssrn.com "social preferences" economics 2024 2025',
"search_depth": "advanced",
"max_results": 20,
"include_domains": ["ssrn.com", "papers.ssrn.com"]
})
# Also works for NBER, RePEc, etc.
mcp__tavily__tavily-search({
"query": 'site:nber.org "network formation" working paper',
"include_domains": ["nber.org"]
})
Recommended Workflows
Workflow A: Comprehensive Topic Search
For finding all recent papers on a topic across multiple sources:
1. OpenAlex: broad search (
Truncated for display β read the full file on GitHub.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 β pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way β as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an emβ¦
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVGβ¦
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
