Skip to main content

A full-featured web UI for Scrapyd cluster management, with Scrapy log analysis & visualization supported.

Project description

English | 简体中文

ScrapydWeb: A full-featured web UI for Scrapyd cluster management, with Scrapy log analysis & visualization supported.

PyPI - scrapydweb Version Downloads - total PyPI - Python Version Coverage Status GitHub license Twitter

Scrapyd x ScrapydWeb

Recommended Reading

How to efficiently manage your distributed web scraping projects



  • Scrapyd Cluster Management

    • Group, filter and select any number of nodes
    • Execute command on multinodes with just a few clicks
  • Scrapy Log Analysis

    • Stats collection
    • Progress visualization
    • Logs categorization
  • All Scrapyd JSON API Supported

    • Deploy project, Run Spider, Stop job
    • List projects/versions/spiders/running_jobs
    • Delete version/project
  • Enhancements

    • Basic auth for web UI
    • HTML caching for the Log and Stats page
    • Auto eggify your projects
    • Email notice
    • Mobile UI

Getting Started


Make sure that Scrapyd has been installed and started on all of your hosts.

Note that if you want to visit your Scrapyd server remotely, you have to manually set the bind_address to bind_address = and restart Scrapyd to make it visible externally.

Installing ScrapydWeb

  • use pip:
pip install scrapydweb
  • use git:
git clone
cd scrapydweb
python install

Starting ScrapydWeb

  1. Start ScrapydWeb via the scrapydweb command. (Your would be asked to add your SCRAPYD_SERVERS in the generated config file on first startup.)
  2. Visit (It's recommended to use Google Chrome to get the best experience.)

Browser Support

The latest version of Google Chrome, Firefox and Safari.


Running the tests

$ git clone
$ cd scrapydweb

# To create isolated Python environments
$ pip install virtualenv
$ virtualenv venv/scrapydweb
# Or specify your Python interpreter: $ virtualenv -p /usr/local/bin/python3.7 venv/scrapydweb
$ source venv/scrapydweb/bin/activate

# Install dependent libraries
(scrapydweb) $ python install
(scrapydweb) $ pip install pytest
(scrapydweb) $ pip install coverage

# Make sure Scrapyd has been installed and started, then update the custom_settings item in tests/
(scrapydweb) $ vi tests/
(scrapydweb) $ curl

(scrapydweb) $ coverage run --source=scrapydweb -m pytest tests/ -s -vv
(scrapydweb) $ coverage run --source=scrapydweb -m pytest tests -s -vv
(scrapydweb) $ coverage report
# To create an HTML report, check out htmlcov/index.html
(scrapydweb) $ coverage html

Built With


Detailed changes for each release are documented in the




This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scrapydweb-1.0.0rc2.tar.gz (565.4 kB view hashes)

Uploaded source

Built Distribution

scrapydweb-1.0.0rc2-py3-none-any.whl (615.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page