Web app for Scrapyd cluster management, with support for Scrapy log analysis & visualization.

dashboard, log-analysis, log-parsing, scrapy, scrapy-log-analysis, scrapy-visualization, scrapyd, scrapyd-admin, scrapyd-api, scrapyd-cluster-management, scrapyd-control, scrapyd-keeper, scrapyd-log-analysis, scrapyd-manage, scrapyd-monitor, scrapyd-ui, scrapyd-visualization, spider
pip install scrapydweb==1.4.0


🔤 English | 🀄ī¸ įŽ€äŊ“中文

ScrapydWeb: Web app for Scrapyd cluster management, with support for Scrapy log analysis & visualization.

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


Scrapyd ❌ ScrapydWeb ❌ LogParser

📖 Recommended Reading

🔗 How to efficiently manage your distributed web scraping projects

🔗 How to set up Scrapyd cluster on Heroku

👀 Demo

🔗 scrapydweb.herokuapp.com

⭐ī¸ Features

View contents
  • 💠 Scrapyd Cluster Management

    • đŸ’¯ All Scrapyd JSON API Supported
    • ☑ī¸ 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
  • 🔋 Enhancements

    • đŸ“Ļ Auto packaging
    • đŸ•ĩ Integrated with 🔗 LogParser
    • ⏰ Timer tasks
    • 📧 Monitor & Alert
    • 📱 Mobile UI
    • 🔐 Basic auth for web UI

đŸ’ģ Getting Started

View contents

⚠ī¸ Prerequisites

❗ī¸ Make sure that 🔗 Scrapyd has been installed and started on all of your hosts.

â€ŧī¸ Note that for remote access, you have to manually set 'bind_address =' in 🔗 the configuration file of Scrapyd and restart Scrapyd to make it visible externally.

âŦ‡ī¸ Install

  • Use pip:
pip install scrapydweb

❗ī¸ Note that you may need to execute python -m pip install --upgrade pip first in order to get the latest version of scrapydweb, or download the tar.gz file from https://pypi.org/project/scrapydweb/#files and get it installed via pip install scrapydweb-x.x.x.tar.gz

  • Use git:
pip install --upgrade git+https://github.com/my8100/scrapydweb.git


git clone https://github.com/my8100/scrapydweb.git
cd scrapydweb
python setup.py install

â–ļī¸ Start

  1. Start ScrapydWeb via command scrapydweb. (a config file would be generated for customizing settings at the first startup.)
  2. Visit (It's recommended to use Google Chrome for a better experience.)

🌐 Browser Support

The latest version of Google Chrome, Firefox, and Safari.

✔ī¸ Running the tests

View contents
$ git clone https://github.com/my8100/scrapydweb.git
$ 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 setup.py 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/conftest.py
(scrapydweb) $ vi tests/conftest.py
(scrapydweb) $ curl

# '-x': stop on first failure
(scrapydweb) $ coverage run --source=scrapydweb -m pytest tests/test_a_factory.py -s -vv -x
(scrapydweb) $ coverage run --source=scrapydweb -m pytest tests -s -vv --disable-warnings
(scrapydweb) $ coverage report
# To create an HTML report, check out htmlcov/index.html
(scrapydweb) $ coverage html

🏗 Built With

View contents

📋 Changelog

Detailed changes for each release are documented in the 🔗 HISTORY.md.

👨‍đŸ’ģ Author


đŸ‘Ĩ Contributors


Šī¸ License

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