[danielh-official]

Adds a new ao3 plugin that enables users to create EPUB ebooks from Archive of Our Own (AO3) stories for reading in Apple Books.

Summary

This plugin provides two workflows for converting AO3 fanfiction into EPUBs:

• Fetch mode: Downloads a work from an AO3 URL, parses it, and lets users select chapters
• Paste mode: Accepts chapter text pasted directly, useful when network access is unavailable

Key Changes

• ao3.py: Main script that fetches works from AO3 URLs, parses HTML to extract chapters and metadata, and supports chapter selection via intuitive syntax (e.g., "1-3, 7", "latest 2")
• epub.py: Builds valid EPUB 3 files from chapter data, with proper metadata, styling, and table of contents
• html_clean.py: Lightweight HTML parser and sanitizer that converts user-generated content to safe XHTML suitable for ebooks, preserving formatting (italics, bold, links) while removing scripts and dangerous elements
• paste.py: Converts pasted plain text into structured chapter data, with support for chapter heading detection and scene break markers
• selfcheck.py: Comprehensive test suite validating parsing, chapter selection, and EPUB generation
• SKILL.md: Documentation covering usage, rules for respectful AO3 access, and setup instructions
• plugin.json: Plugin metadata for agent marketplaces

Implementation Details

• Respects AO3's terms of service: one request per work, 5+ second throttling between requests, honest User-Agent, automatic caching, and single retry on rate limits
• Handles edge cases: one-shots, locked works, multi-chapter works with notes, anonymous authors
• Chapter selection supports flexible syntax: ranges ("1-3"), ordinal selections ("latest 2", "first 5"), and mixed ("1, 3-5, 7")
• Partial chapter selections automatically label the book (e.g., "The Lake House (ch 1-3, 7)") to avoid collisions in Books
• EPUB output includes proper language codes, metadata preservation, and CSS styling for readability

https://claude.ai/code/session_01Qp5oiTGA7KoCTXW1yfxAa1