English | 简体中文 | 繁體中文

Powered by selenium, bookstw is a simple Python library to interact with Books.com.tw.

pip install bookstw

Let's get started with a simple example that logs in to Books.com.tw and takes the daily sign-in action:

from selenium.webdriver import Chrome
from selenium.webdriver.chrome.options import Options

from bookstw import BooksTWRunner
from bookstw.ocr.baidu import BaiduHandwritingOCR

if __name__ == "__main__":
    baidu_ocr = BaiduHandwritingOCR(
        proxy={"http": "", "https": ""},
        api_key="<YOUR_API_KEY>",
        secret_key="<YOUR_SECRET>"
    )
    options = Options()
    options.add_argument("--disable-gpu")
    options.add_argument("--disable-logging")
    options.add_argument("--log-level=3")
    options.add_argument("--headless")
    options.add_experimental_option("excludeSwitches", ["enable-logging"])
    chrome = Chrome(options)

    runner = BooksTWRunner(ocr=baidu_ocr, webdriver=chrome)
    runner.login("<YOUR_USERNAME>", "<YOUR_PASSWORD>")
    runner.daily_sign_in()

The above code snippet demonstrates how to sign in daily with bookstw.

The BaiduHandwritingOCR is used to solve the captcha. It calls the Baidu Handwriting OCR API to recognize the captcha image.

Currently, it is the only OCR provider supported by bookstw. However, you can implement your own OCR provider by inheriting the BaseOCR class.

Fork this repository and create the following secrets in your repository:

• BAIDU_API_KEY
• BAIDU_SECRET_KEY
• BOOKS_TW_USERNAME
• BOOKS_TW_PASSWORD

Change INSTALL_FROM environment variable to PyPI in .yml file if you want to install from PyPI, or keep it as Poetry to install from source.

Creates a new BooksTWRunner instance.

• ocr: The OCR provider used to solve the captcha.
• webdriver: The WebDriver used to interact with Books.com.tw.

Login to books.com.tw.

Captcha is solved using OCR.

• username: Username.
• password: Password.
• allow_manual_retry: Allow manual retry if OCR failed.
• ocr_retry: Number of retries for OCR.
• retry_delay: Delay between retries in seconds.

Daily sign in to get Read Mileage.

If already signed in, it will throw an exception.

• The "You haven't changed your password for a long time" dialog box is currently not being processed, which may cause Github Actions to fail.