https://github.com/my8100/scrapydweb

Web app for Scrapyd cluster management, Scrapy log analysis & visualization, Auto packaging, Timer tasks, Monitor & Alert, and Mobile UI. Docs 文档 :point_right:
https://github.com/my8100/scrapydweb

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

Last synced: about 9 hours ago
JSON representation

Web app for Scrapyd cluster management, Scrapy log analysis & visualization, Auto packaging, Timer tasks, Monitor & Alert, and Mobile UI. Docs 文档 :point_right:

Host: GitHub
URL: https://github.com/my8100/scrapydweb
Owner: my8100
License: gpl-3.0
Created: 2018-09-30T19:11:44.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2025-02-19T14:41:45.000Z (2 months ago)
Last Synced: 2025-04-23T20:55:59.701Z (about 9 hours ago)
Topics: 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
Language: Python
Homepage: https://github.com/my8100/files
Size: 3.05 MB
Stars: 3,267
Watchers: 72
Forks: 578
Open Issues: 60
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- License: LICENSE

Awesome Lists containing this project

awesome - scrapydweb - ScrapydWeb: Web app for Scrapyd cluster management (Scrapy Distributed)
awesome-scrapy - ScrapydWeb

README

        :abc: English | [:mahjong: 简体中文](https://github.com/my8100/scrapydweb/blob/master/README_CN.md)

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

[![PyPI - scrapydweb Version](https://img.shields.io/pypi/v/scrapydweb.svg)](https://pypi.org/project/scrapydweb/)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/scrapydweb.svg)](https://pypi.org/project/scrapydweb/)

[![CircleCI](https://circleci.com/gh/my8100/scrapydweb/tree/master.svg?style=shield)](https://circleci.com/gh/my8100/scrapydweb/tree/master)

[![codecov](https://codecov.io/gh/my8100/scrapydweb/branch/master/graph/badge.svg)](https://codecov.io/gh/my8100/scrapydweb)

[![Coverage Status](https://coveralls.io/repos/github/my8100/scrapydweb/badge.svg?branch=master)](https://coveralls.io/github/my8100/scrapydweb?branch=master)

[![Downloads - total](https://static.pepy.tech/badge/scrapydweb)](https://pepy.tech/project/scrapydweb)

[![GitHub license](https://img.shields.io/github/license/my8100/scrapydweb.svg)](https://github.com/my8100/scrapydweb/blob/master/LICENSE)

[![Twitter](https://img.shields.io/twitter/url/https/github.com/my8100/scrapydweb.svg?style=social)](https://twitter.com/intent/tweet?text=@my8100_%20ScrapydWeb:%20Web%20app%20for%20Scrapyd%20cluster%20management,%20with%20support%20for%20Scrapy%20log%20analysis%20%26%20visualization.%20%23python%20%23scrapy%20%23scrapyd%20%23webscraping%20%23scrapydweb%20&url=https%3A%2F%2Fgithub.com%2Fmy8100%2Fscrapydweb)

##

![servers](https://raw.githubusercontent.com/my8100/scrapydweb/master/screenshots/servers.png)

## Scrapyd :x: ScrapydWeb :x: LogParser

### :book: Recommended Reading

[:link: How to efficiently manage your distributed web scraping projects](https://github.com/my8100/files/blob/master/scrapydweb/README.md)

[:link: How to set up Scrapyd cluster on Heroku](https://github.com/my8100/scrapyd-cluster-on-heroku)

## :eyes: Demo

[:link: scrapydweb.herokuapp.com](https://scrapydweb.herokuapp.com)

## :rocket: Sponsor

This project is supported by [IPRoyal](https://iproyal.com/?r=802099). You can get premium quality proxies at unbeatable prices

with a discount using [this referral link](https://iproyal.com/?r=802099)!

## :stars: Features

View contents

- :diamond_shape_with_a_dot_inside: Scrapyd Cluster Management

  - :100: All Scrapyd JSON API Supported

  - :ballot_box_with_check: Group, filter and select any number of nodes

  - :computer_mouse: **Execute command on multinodes with just a few clicks**

- :mag: Scrapy Log Analysis

  - :bar_chart: Stats collection

  - :chart_with_upwards_trend: **Progress visualization**

  - :bookmark_tabs: Logs categorization

- :battery: Enhancements

  - :package: **Auto packaging**

  - :male_detective: **Integrated with [:link: *LogParser*](https://github.com/my8100/logparser)**

  - :alarm_clock: **Timer tasks**

  - :e-mail: **Monitor & Alert**

  - :iphone: Mobile UI

  - :closed_lock_with_key: Basic auth for web UI

## :computer: Getting Started

View contents

### :warning: Prerequisites

:heavy_exclamation_mark: **Make sure that [:link: Scrapyd](https://github.com/scrapy/scrapyd) has been installed and started on all of your hosts.**

:bangbang: Note that for remote access, you have to manually set 'bind_address = 0.0.0.0' in [:link: the configuration file of Scrapyd](https://scrapyd.readthedocs.io/en/latest/config.html#example-configuration-file)

and restart Scrapyd to make it visible externally.

### :arrow_down: Install

- Use pip:

```bash

pip install scrapydweb

```

:heavy_exclamation_mark: 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:

```bash

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

```

Or:

```bash

git clone https://github.com/my8100/scrapydweb.git

cd scrapydweb

python setup.py install

```

### :arrow_forward: Start

1. Start ScrapydWeb via command `scrapydweb`. (a config file would be generated for customizing settings at the first startup.)

2. Visit http://127.0.0.1:5000 **(It's recommended to use Google Chrome for a better experience.)**

### :globe_with_meridians: Browser Support

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

## :heavy_check_mark: Running the tests

View contents




```bash

$ 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 http://127.0.0.1:6800

# '-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

```

## :building_construction: Built With

View contents




- Front End

  - [:link: Element](https://github.com/ElemeFE/element)

  - [:link: ECharts](https://github.com/apache/incubator-echarts)

- Back End

  - [:link: Flask](https://github.com/pallets/flask)

## :clipboard: Changelog

Detailed changes for each release are documented in the [:link: HISTORY.md](https://github.com/my8100/scrapydweb/blob/master/HISTORY.md).

## :man_technologist: Author

| [](https://github.com/my8100)
 [_my8100](https://github.com/my8100) |

| --- |

## :busts_in_silhouette: Contributors

| [](https://github.com/simplety)
 [_Kaisla](https://github.com/simplety) |

| --- |

## :copyright: License

This project is licensed under the GNU General Public License v3.0 - see the [:link: LICENSE](https://github.com/my8100/scrapydweb/blob/master/LICENSE) file for details.

## :star: Stargazers over time

[![Stargazers over time](https://starchart.cc/my8100/scrapydweb.svg?variant=adaptive)](https://starchart.cc/my8100/scrapydweb)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/my8100/scrapydweb

Awesome Lists containing this project

README