f10w3r / sci-clone

A simple tool for cloning from Sci-hub.

             _____ __________     ________    ____  _   ________
            / ___// ____/  _/    / ____/ /   / __ \/ | / / ____/
            \__ \/ /    / /_____/ /   / /   / / / /  |/ / __/
           ___/ / /____/ /_____/ /___/ /___/ /_/ / /|  / /___
          /____/\____/___/     \____/_____/\____/_/ |_/_____/

               A simple tool for cloning from Sci-Hub.

• Python Version > 3.6

Procedure (by ISSN)

1. Query the Digital Object Identifier (DOI)/URL/PMID from crossref.org;
2. Download articles from Sci-Hub with the DOI/URL/PMID.

Installation

• The simple command:

pip install sci-clone

• or provide PyPI index if the above command fails:

pip install sci-clone -i https://pypi.org/simple

• or install from this repository if you cannot connect to PyPI:

pip install git+https://github.com/f10w3r/sci-clone

Default Sources

• Sci-Hub: sci-hub.wf

• DOI/URL/PMID: crossref.org

Usage

I. Download by DOI/URL.

sci-clone DOI/URL/PMID [DOI/URL/PMID] ...

Examples

• Download two articles with DOI/URL/PMID:

sci-clone 10.1126/science.1248506 https://www.jstor.org/stable/27854031

• Download with the DOI/URL/PMID within a file: papers.txt or papers.bib

sci-clone examples/papers.txt

sci-clone examples/papers.bib

II. Download by Year (from a journal).

sci-clone ISSN YEAR_FROM [YEAR_TO]

Examples

• Download articles from journal American Journal of Sociology (ISSN: 0002-9602) in year 2020:

sci-clone 0002-9602 2020

• Download articles from journal Sociology of Education (ISSN: 0038-0407) from year 2010 to 2012:

sci-clone 0038-0407 2010 2012

Useful Configs

• Download and save the files to directory papers (should be created before download):

sci-clone 0038-0407 2010 2012 -d papers

• If the default Sci-Hub URL is invalid, change it to another valid one:

sci-clone 10.1126/science.1248506 -s sci-hub.tw

Upgrade

pip install sci-clone --upgrade

Uninstallation

pip uninstall sci-clone

Notes

• Sci-Hub does not have every article that has DOI, the ones that not found are logged in file missing.log under each sub-directory.