sci-clone 0.3.3.8

A simple tool for cloning from Sci-Hub.

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

               A simple tool for cloning from Sci-Hub. 

Procedure

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

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 your country cannot connect to PyPI:

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

Default Sources

• DOI: crossref.org

• Sci-Hub: sci-hub.tf

Usage

I. Download by DOI.

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

Arguments:
  DOI...  Valid DOI(s) or file (*.bib, *.txt)  [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

• Download with the DOIs within bib.txt file:

$ sci-clone doi bib.txt

II. Download by Year.

$ sci-clone issn --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

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

$ sci-clone issn 0002-9602 2020

• 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

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

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

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.