Crawlera middleware for Scrapy
Project description
scrapy-crawlera provides easy use of Crawlera with Scrapy.
Installation
You can install scrapy-crawlera using pip:
pip install scrapy-crawlera
Configuration
Add the Crawlera middleware including it into the DOWNLOADER_MIDDLEWARES in your settings.py file:
DOWNLOADER_MIDDLEWARES = { ... 'scrapy_crawlera.CrawleraMiddleware': 610 }
Then there are two ways to enable it.
Through settings.py:
CRAWLERA_ENABLED = True CRAWLERA_APIKEY = 'apikey'
Through spider attributes:
class MySpider: crawlera_enabled = True crawlera_apikey = 'apikey'
How to use it
With the middleware, the usage of crawlera is automatic, every request will go through crawlera without nothing to worry about.
Remember that you are now making request to Crawlera, and the Crawlera service will be the one actually making the requests to the different sites.
If you need to specify special Crawlera Headers, just apply them as normal Scrapy Headers.
Here we have an example of specifying a Crawlera header into a Scrapy request:
scrapy.Request( 'http://example.com', headers={ 'X-Crawlera-Max-Retries': 1, ... }, )
Remember that you could also set which headers to use by default by all requests with DEFAULT_REQUEST_HEADERS
Changes
v1.2.2 (2017-01-19)
Fix Crawlera error stats key in Python 3.
Add support for Python 3.6.
v1.2.1 (2016-10-17)
Fix release date in README.
v1.2.0 (2016-10-17)
Recommend middleware order to be 610 to run before RedirectMiddleware.
Change default download timeout to 190s or 3 minutes 10 seconds (instead of 1800s or 30 minutes).
Test and advertize Python 3 compatiblity.
New crawlera/request and crawlera/request/method/* stats counts.
Clear Scrapy DNS cache for proxy URL in case of connection errors.
Distribute plugin as universal wheel.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for scrapy_crawlera-1.2.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 906655abfb9b750e75f7f209be4784bcdbd1af0b3685980f64754f8c0e7bb224 |
|
MD5 | 7f4ce63664e9dd0cec4b832b139525b5 |
|
BLAKE2b-256 | 4b7588cd6615a76089ba22167d1b3ca4e84cfd0598d3aab4d8c32c7aa0eaf9ee |