whatisgithub

What is paper-scraper?

gao-pooh/paper-scraper — explained in plain English

Analysis updated 2026-05-18

71PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

In one sentence

A Python tool that searches and batch-downloads academic PDFs from ScienceDirect and INFORMS using your institutional login.

Mindmap

mindmap
  root((repo))
    What it does
      Search papers by keyword
      Batch download PDFs
      Read Chrome cookies
    Tech stack
      Python
      curl_cffi
      Chrome DevTools
    Use cases
      Collect papers for a literature review
      Browse a journal by volume
      Search by author or ISSN
    Audience
      Researchers
    Setup
      Needs institutional access
      Needs Chrome installed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Batch download PDFs from ScienceDirect using an existing institutional Chrome login.

USE CASE 2

Search INFORMS PubsOnLine by keyword, journal, or author and export results to a spreadsheet.

USE CASE 3

Collect a large set of papers for a literature review without clicking through each article.

What is it built with?

Pythoncurl_cffibrowser-cookie3openpyxl

How does it compare?

gao-pooh/paper-scraperprimeintellect-ai/experiments-autonomous-speedrunningwanshuiyin/aris-in-ai-offer
Stars717171
LanguagePythonPythonPython
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audienceresearcherresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an active institutional login through Chrome, and the Chrome path is hardcoded to macOS by default.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Paper-scraper is a Python tool for searching and batch-downloading academic papers from two platforms: ScienceDirect (Elsevier) and INFORMS PubsOnLine. It is aimed at researchers who have institutional access to these journals through a university or library and want to collect large numbers of PDFs without clicking through each article manually. You can search by keyword, journal name, author, ISSN, or a combination of criteria. Results come back as spreadsheet or JSON files containing paper titles, authors, abstracts, and links. If you have an active institutional login in Chrome, the tool can read your browser cookies automatically so you do not have to copy credentials by hand. Downloading PDFs from ScienceDirect is technically more involved because Cloudflare blocks normal web requests. The tool handles this by launching Chrome in a special debug mode, navigating to each article page inside your existing browser session, and intercepting the PDF bytes before they reach the screen. This bypasses the block without requiring you to install extra browser automation software beyond Chrome itself. For INFORMS, the PDF endpoints are simpler and a valid session cookie is sufficient. All output files are saved to a local results folder, organized by search query and timestamp. PDFs are named by author and year. The project is written in Python 3.8 and above. Running it requires installing a few Python packages (curl_cffi, websocket-client, browser-cookie3, and openpyxl). The scripts currently hardcode the Chrome path for macOS, though Linux and Windows users can point the script to their own Chrome binary with a small config change. An interactive wizard mode is available for first-time users who prefer prompts over command-line flags.

Copy-paste prompts

Prompt 1
Help me install the dependencies this scraper needs with pip.
Prompt 2
Explain how the ScienceDirect scraper uses Chrome DevTools Protocol to get around Cloudflare.
Prompt 3
How do I point this script at my Chrome install if I'm on Linux or Windows instead of macOS?
Prompt 4
Walk me through running the interactive wizard mode for the INFORMS scraper.

Frequently asked questions

What is paper-scraper?

A Python tool that searches and batch-downloads academic PDFs from ScienceDirect and INFORMS using your institutional login.

What language is paper-scraper written in?

Mainly Python. The stack also includes Python, curl_cffi, browser-cookie3.

What license does paper-scraper use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is paper-scraper to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is paper-scraper for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.