Skip to content
This repository has been archived by the owner on Sep 20, 2024. It is now read-only.

Saritasa/SpiderKeeper

 
 

Repository files navigation

Deprecated ⚠️

Moved to https://github.com/saritasa-nest/usummit-spiderkeeper

SpiderKeeper

Latest Version Python Versions The MIT License

A scalable admin ui for spider service

Features

  • Manage your spiders from a dashboard. Schedule them to run automatically
  • With a single click deploy the scrapy project
  • Show spider running stats
  • Provide api

Current Support spider service

Screenshot

job dashboard periodic job running stats

Getting Started

Installing

pip install spiderkeeper

Deployment


spiderkeeper [options]

Options:

  -h, --help            show this help message and exit
  --host=HOST           host, default:0.0.0.0
  --port=PORT           port, default:5000
  --username=USERNAME   basic auth username ,default: admin
  --password=PASSWORD   basic auth password ,default: admin
  --type=SERVER_TYPE    access spider server type, default: scrapyd
  --server=SERVERS      servers, default: ['http://localhost:6800']
  --database-url=DATABASE_URL
                        SpiderKeeper metadata database default: sqlite:////home/souche/SpiderKeeper.db
  --no-auth             disable basic auth
  -v, --verbose         log level
  

example:

spiderkeeper --server=http://localhost:6800

Usage

Visit: 

- web ui : http://localhost:5000

1. Create Project

2. Use [scrapyd-client](https://github.com/scrapy/scrapyd-client) to generate egg file 

   scrapyd-deploy --build-egg output.egg

2. upload egg file (make sure you started scrapyd server)

3. Done & Enjoy it

- api swagger: http://localhost:5000/api.html

Feed params

You may specify the following scrapy feed params in config.py:

  • FEED_URI - path that is used by scrapy to store feed. All storages (s3, ftp, local filesystem) are supported.
  • FEED_FORMAT - exported file format
  • EXPORT_URI - path where feed can be retrieved from.

FEED_URI and EXPORT_URI can contain the following params:

  • %(name)s - spider name
  • %(create_time)s - time of job execution start
  • %(job_id)s - job execution id
  • any other params from Args set while adding jobs.

If EXPORT_URI is not defined, export uri is equal to FEED_URI. If FEED_URI is also not defined, it is not passed to spider. The same is for FEED_FORMAT.

Example:

FEED_FORMAT = 'csv'
FEED_URI = 's3://bucket/%(name)s/%(job_id)s_%(create_time)s.csv'
EXPORT_URI = 'https://s3.amazonaws.com/bucket/%(name)s/%(job_id)s_%(create_time)s.csv'

If job has export uri (i.e. FEED_URI is defined in config.py), Export button is displayed on job detail page.

Note: need to install boto3 for uploading to s3.

TODO

  • Job dashboard support filter
  • User Authentication
  • Collect & Show scrapy crawl stats
  • Optimize load balancing

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Contributing

Contributions are welcomed!

交流反馈

Contact

捐赠

Contact

About

admin ui for scrapy/open source scrapinghub

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 49.9%
  • HTML 34.9%
  • JavaScript 14.6%
  • Other 0.6%