Metadata-Version: 2.4
Name: annas-archive-downloader
Version: 1.0.0
Summary: Anna's Archive batch ebook downloader — Claude Code & Codex skill
Author: pkuasule
License: MIT
Project-URL: Homepage, https://github.com/realpkuasule/anne-archive-downloader
Project-URL: Repository, https://github.com/realpkuasule/anne-archive-downloader
Project-URL: Issues, https://github.com/realpkuasule/anne-archive-downloader/issues
Keywords: annas-archive,ebook,downloader,claude-code,codex,skill,shadow-library,batch-download
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: playwright>=1.40
Requires-Dist: curl_cffi>=0.7

# Anna's Archive Downloader

Automate batch ebook downloads from [Anna's Archive](https://annas-archive.gl) using Fast Download links.

A skill for Claude Code and Codex.

## Prerequisites

- **Anna's Archive membership** (for Fast Download access)
- **Running proxy** on port 7897 (Clash/V2Ray)
- Python 3.10+ with `playwright` and `curl_cffi`

```bash
pip install playwright curl_cffi
```

## Usage

1. Edit `download.py`:
   ```python
   BOOKS = [
       ("Book Title", "md5_hash_from_annas_archive"),
   ]
   DOWNLOAD_DIR = Path("/where/to/save")
   ```

2. Run:
   ```bash
   python3 download.py
   ```

3. Log in once in the Chrome window that opens. Session persists for future runs.

## How It Works

```
Playwright persistent Chrome → login once
  → For each book:
      MD5 page → click Fast Download → capture CDN redirect
      → curl_cffi download from CDN → save to disk
```

## Files

- `SKILL.md` — Skill documentation (triggers, patterns, common mistakes)
- `download.py` — Reusable download script

## License

MIT
