weread-book-exporter README

README проекта с github.com/WANGXIN-567/weread-book-exporter. Одним файлом markdown: README.md.

📚 WeRead Book Exporter (weread-book-exporter)

Python 3.9+ Playwright License: MIT

将微信读书 Web 端已购或会员书籍无损抓取全书全文,并一键导出为 精排 PDF、标准 EPUB 以及 纯 Markdown 笔记(适配 Obsidian / Notion)。

自动保留原书的目录结构、标题层级、引文/重点段落样式与高清插图,提供舒适的大字号双字体排版,方便个人深度学习、全文检索与知识库归档。

WeRead Book Exporter 排版预览


✨ 核心特性

1. 100% 全书完整抓取(攻克网页端翻页漏字问题)

许多传统的微信读书抓取脚本在默认的上下滚动模式下运行,受限于网页端超长虚拟滚动容器的分片机制,翻页时极易跳过章节下半部分内容。

2. 原生级层次还原与断句修复

3. 一键导出三大常用格式

导出格式 适用场景 特性说明
精排 PDF (.pdf) iPad 批注、电脑阅读、打印 苹方正文 + 楷体引文大字号排版,内置封面、可点击目录页、PDF 侧边栏书签大纲 (Outline) 与页码
标准 EPUB (.epub) Apple Books / Kindle / 阅读器 内嵌多字体排版样式、完整目录导航树与原书高清插图
Markdown (.md) Obsidian / Notion / 个人知识库 提供纯 Markdown 版(引文自动转为 > 引用块)与带样式标签版,方便检索与做笔记

4. 温和抓取与防频控机制


🚀 快速开始

1. 安装依赖(国内极速安装,仅需几秒)

# 克隆仓库
git clone https://github.com/WANGXIN-567/weread-book-exporter.git
cd weread-book-exporter

# 使用国内高速镜像安装依赖(推荐腾讯云或阿里云,稳定不报 403)
pip install -r requirements.txt -i https://mirrors.cloud.tencent.com/pypi/simple/
# 备用阿里云镜像:
# pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

⚡ 免下载 200MB 浏览器:代码内置了智能浏览器检测,会自动直接调用电脑自带的 Microsoft Edge 或 Google Chrome;如果系统未安装上述浏览器,可执行 playwright install chromium 补充下载。

2. 一键抓取并导出全格式电子书(核心推荐)

直接复制微信读书网页版的完整链接(支持任意已购/会员书籍):

# 直接粘贴整条网页链接(或书籍 ID 均可):
python main.py https://weread.qq.com/web/reader/3b132980813ab94eeg013129

提示:

  • 首次运行时会自动弹出浏览器窗口,使用微信扫码登录一次即可。
  • 脚本会自动完成「全书章节遍历 ➔ 原版高清封面下载 ➔ 插图下载 ➔ 精排 PDF 渲染 ➔ 双字体 EPUB 导出 ➔ Markdown 笔记生成」全流程!
  • 所有文件最终保存在 output/ 目录下。

(高级用法:如需分步运行,也可单独执行 python crawl_weread.py <链接或ID> 与 python export_book.py <链接或ID>)


🛠️ 工作流程

flowchart LR
    A["微信读书网页版\n(自动切换双栏翻页)"] --> B["底层文本与插图捕获\n逐页提取字号/字重/坐标"]
    B --> C["段落重组与清洗\n合并跨行断句 & 去重"]
    C --> D["多格式导出引擎\nPDF / EPUB / Markdown"]

⚠️ 免责声明 (Disclaimer)

  1. 本工具仅用于个人学习、读书笔记整理与前端渲染技术研究。
  2. 请支持正版阅读,仅对您个人合法拥有阅读权限的书籍使用本工具,导出的文件请勿用于任何商业用途或公开传播。
  3. 本仓库仅包含通用转换脚本,不包含任何受版权保护的书籍内容或个人登录信息。

如果这个工具对你的阅读与笔记整理有帮助,欢迎点亮一颗 Star ⭐ 支持!

weread-book-exporter (WANGXIN-567/weread-book-exporter)

Ищем в базе…

Что это такое?Инструмент на Python, который сохраняет полный текст книг, купленных в веб-читалке WeRead, и экспортирует их в вёрстанный PDF, EPUB или заметки в Markdown с иллюстрациями на своих местах.
Какие форматы я получу и где их можно использовать?Вёрстанный PDF для аннотирования на iPad, чтения на компьютере и печати, EPUB для Apple Books или Kindle и простой или оформленный Markdown для Obsidian и Notion.
Как это запустить?Установите зависимости, вставьте в скрипт полную веб-ссылку на книгу в WeRead и дождитесь окончания работы. При первом запуске откроется окно браузера, в котором нужно один раз отсканировать QR-код WeChat. Результаты сохраняются в папку output/.
Нужно ли устанавливать браузер?Обычно нет: скрипт использует Microsoft Edge или Google Chrome, которые уже есть на вашем компьютере. Если ни один из них не установлен, выполните 'playwright install chromium', чтобы скачать браузер. Нужен Python.
Большая книга будет экспортироваться целую вечность?Скорее всего, да, это задумано так. Переход между страницами занимает случайные 8–20 секунд, а каждые 10–20 страниц скрипт делает паузу на 1–2 минуты, чтобы не перегружать сервер.
Сохранятся ли главы, цитаты и картинки?Да. Скрипт распознаёт названия глав, цитаты, ключевые абзацы и жирные подзаголовки, а затем встраивает все оригинальные иллюстрации в высоком разрешении в порядке чтения.
Как не теряется текст на границах страниц?Читалка переключается на горизонтальную постраничную навигацию в две колонки. Скрипт собирает команды рисования Canvas и координаты колонок и восстанавливает текстовый поток каждой страницы по порядку, поэтому текст не пропускается и не повторяется между страницами.
Как выглядит результат в Markdown?Есть простая версия, где цитаты превращаются в блоки > (blockquote), и оформленная версия с тегами. Обе предназначены для поиска и ведения заметок в Obsidian или Notion.
Автор
WANGXIN-567
Размер
0.7 MB
Звёзды
863
Обновлён
КоммитNov 01
Возраст
18 д
Коммиты · 90 дней