sci-clone 0.3.3.3

A simple script for downloading articles from Sci-Hub.

SCI-CLONE

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

A simple script for downloading articles from Sci-Hub.

The main idea:

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

Installation

$ pip install sci-clone

# or provide the PyPI index
$ pip install sci-clone -i https://pypi.org/simple

# or install from Github
$ pip install git+https://github.com/f10w3r/sci-clone

Default Sources

DOI: crossref.org

Sci-Hub: sci-hub.tf

Usage

I. Download by Year.

sci-clone issn --help for help.

Usage: sci-clone issn [OPTIONS] ISSN YEAR:[%Y]...

Arguments:
  ISSN          Journal ISSN (e.g.: 0002-9602)  [required]
  YEAR:[%Y]...  From year to year (e.g.: 2011 2012)  [required]

Options:
  -d, --dir PATH     Directory to download  [default: (dynamic)]
  -s, --scihub TEXT  Valid Sci-Hub URL  [default: sci-hub.tf]
  --help             Show this message and exit.

Examples

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

$ sci-clone issn 0002-9602 2020

2. Download articles from journal Sociology of Education (ISSN: 0038-0407) from year 2010 to 2012, save the files to directory AJS_2010-2012 (should be created in advance):

$ sci-clone issn 0038-0407 2010 2012 -d AJS_2010-2012

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

$ sci-clone issn 0038-0407 2010 2012 -s sci-hub.tw

II. Download by DOI.

sci-clone doi --help for help.

Usage: sci-clone doi [OPTIONS] DOI...

Arguments:
  DOI...  valid DOI(s)  [required]

Options:
  -d, --dir PATH     Directory to download  [default: (dynamic)]
  -s, --scihub TEXT  Valid Sci-Hub URL  [default: sci-hub.tf]
  --help             Show this message and exit.

Examples

• Download two articles with DOIs:

$ sci-clone doi 10.1126/science.1248506 10.1017/S0003055413000014

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.