Fetch academic papers from Sci-Hub given a DOI. Automatically downloads PDFs and saves them to research/papers/ with clean filenames. Use when the user provides a DOI or requests a paper from PubMed.
---
name: paper-fetcher
description: Fetch academic papers from Sci-Hub given a DOI. Automatically downloads PDFs and saves them to research/papers/ with clean filenames. Use when the user provides a DOI or requests a paper from PubMed.
---
# Paper Fetcher
Automated academic paper retrieval from Sci-Hub.
## Usage
**Simple fetch:**
```
Get paper: 10.1038/nature12345
```
**Multiple papers:**
```
Fetch these papers:
- 10.1016/j.cell.2023.01.001
- 10.1038/s41586-2023-06789-0
- 10.1126/science.abc1234
```
**With context:**
```
Get the epitalon paper: 10.1007/s12603-011-0032-7
```
## What It Does
1. Takes DOI as input
2. Navigates to https://www.sci-hub.su/DOI
3. Downloads the PDF
4. Saves to `research/papers/` with clean filename
5. Returns confirmation with file path
## Output Location
```
workspace/
└── research/
└── papers/
├── paper_10.1038_nature12345.pdf
├── paper_10.1016_j.cell.2023.01.001.pdf
└── ...
```
## Filename Format
`paper_[DOI with slashes replaced].pdf`
Examples:
- DOI: `10.1038/nature12345` → `paper_10.1038_nature12345.pdf`
- DOI: `10.1016/j.cell.2023.01.001` → `paper_10.1016_j.cell.2023.01.001.pdf`
## Workflow
When user provides a DOI:
1. **Extract DOI** - Parse from message (with or without https://doi.org/ prefix)
2. **Navigate Sci-Hub** - Use browser to load https://www.sci-hub.su/DOI
3. **Wait for PDF** - Let page load and find download link
4. **Download** - Save PDF to research/papers/
5. **Confirm** - Report success with file path
## Error Handling
**If paper not found on Sci-Hub:**
- Report that Sci-Hub couldn't find it
- Suggest checking the DOI format
- User can try manual search
**If download fails:**
- Report the error
- Provide Sci-Hub URL for manual download
## Integration
**With Obsidian Sync:**
- Papers saved in research/papers/
- Can create notes linking to PDFs
- Sync metadata to Obsidian vault
**With Research Automation:**
- Fetch papers discovered in research runs
- Build reference library automatically
- Cross-reference with protocol notes
## Tips
**Finding DOIs:**
- PubMed: Listed in article details
- Paper itself: Usually on first page
- Google Scholar: In citation info
**Format flexibility:**
- With prefix: `https://doi.org/10.1038/nature12345` ✅
- Without prefix: `10.1038/nature12345` ✅
- Either format works
**Batch fetching:**
- Send multiple DOIs at once
- Processed sequentially
- All saved to research/papers/
---
**Status:** Active
**Sci-Hub Domain:** https://www.sci-hub.su
**Save Location:** research/papers/
don't have the plugin yet? install it then click "run inline in claude" again.