README.md

GoodreadsMaster

Forked from Goodreads-Giveaway-BOT.

An automated Bot that enters the user onto Giveaways on Goodreads using Scrapy web-crawler.

Prerequisites

User

• The user needs to have a Goodreads Account.
• The user needs to have atleast one shipping address saved beforehand.

Installation

To run the bot, Scrapy needs to be installed on the system.

To install Scrapy using conda, run:

$ conda install -c conda-forge scrapy

Alternatively, installation through PyPI:

$ pip install Scrapy

Usage

Run the crawler

$ scrapy crawl giveaway_bot -a username="***email_id***" -a password="***password***"

This will start the bot with logging in using the Email ID and password provided as arguments. Once logged in, the spider will start, traversing through the Giveaway pages.

Features

• Verbose Output during execution of Spider

• Store the Entered Giveaways list in file : EnteredGiveaways.txt

• When the Giveaway is being entered, the "Also add this book to my to-read shelf." checkbox is un-ticked.

  Don't think this actually works, I might fix it at some point.

• Scrapy Settings:

  # Obey robots.txt rules
  ROBOTSTXT_OBEY = True
  
  # Enable and configure the AutoThrottle extension
  AUTOTHROTTLE_ENABLED = True
  
  #Enable Cookies that are received and keeps track of cookies sent by servers, 
  #and sends them back on subsequent requests
  #COOKIES_ENABLED = True
  

Disclaimer : The bot only Enters the user onto Giveaway, and does not guarantee that the user will win the Giveaway. Any reaction upon the use of the bot is upon the user and the user alone. Use at your own discretion.