book-fetch_skill

This skill downloads ebooks from Anna's Archive in pdf or epub and uploads them to MEGA, automating library building.

Python

2.5k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

3 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill book-fetch

_meta.json274 B
SKILL.md1.6 KB

Overview

This skill automates finding and fetching ebooks (EPUB/PDF) from Anna's Archive and mirrors them into a MEGA folder. It searches Anna's Archive (and LibGen mirrors when available), downloads the selected file, and uploads it to mega:/Books/ using rclone. It supports format preference, interactive picking, and a dry-run search mode.

How this skill works

The skill scrapes Anna's Archive search results to extract title, author, and MD5 identifiers. It follows MD5 links to locate LibGen mirror download endpoints or Anna's Archive fast/slow download links, downloads the file with a progress indicator, caches the file in /tmp/books/, and uploads it to MEGA via rclone copy. If LibGen mirrors are missing, the script falls back to Anna's Archive downloads and handles membership/rate-limit differences.

When to use it

You want an automated way to add a specific ebook to your MEGA library.
You need to search Anna's Archive or LibGen for a particular title or author.
You prefer a command-line tool with format preference (epub/pdf) and result selection.
You want to batch or scripted downloads with automatic upload to mega:/Books/
You need a dry-run mode to validate search results before downloading.

Best practices

Ensure rclone is configured and mega:/ is accessible (test with rclone ls mega:/).
Run inside the provided virtualenv to satisfy dependencies (requests, beautifulsoup4, lxml).
Use --dry-run to preview matches before consuming bandwidth or quota.
Prefer --format to pick PDF or EPUB according to your reader compatibility.
Monitor Anna's Archive membership and rate limits: fast_download may require an account.

Example use cases

Add a newly released textbook to your MEGA Books folder using the title and author.
Script nightly downloads of requested titles and automatically mirror them to MEGA.
Search multiple editions and pick the preferred result interactively with --pick.
Validate search results with --dry-run before initiating large downloads.
Fallback to Anna's Archive slow_download when LibGen mirrors are unavailable.

FAQ

Yes. Configure rclone with your MEGA credentials and verify access (rclone ls mega:/) before running the skill.

What formats are supported and how do I prefer one?

The skill prefers EPUB by default but you can force PDF with --format pdf.

Can I preview results without downloading?

Yes. Use --dry-run to perform searches and inspect matches without downloading files.

What happens if LibGen has no mirror for a book?

The script falls back to Anna's Archive fast_download or slow_download links; fast_download may require membership and slow_download is rate-limited.