一个用于恢复 Kindle 受限导出的笔记的 Claude Code 技能。
A Claude Code skill that recovers export-blocked Kindle highlights

原始链接: https://github.com/l3a0/claude-plugins

`l3a0/claude-plugins` 代码库是一系列用于 Claude Code 的工具集合,其中包含一项强大的功能,可绕过亚马逊 Kindle 对笔记导出数量的限制。通常情况下,亚马逊会截断或隐藏用户的笔记,而这款仅限 macOS 使用的工具通过结合 Kindle Mac 应用的本地 SQLite 数据库、Kindle 云阅读器以及苹果 Vision 框架的本地 OCR 技术,能够 100% 恢复你的高亮笔记,包括那些被导出上限屏蔽的内容。 最终产出的文件是一个清晰、逐字的 Markdown 文档,其中包含了按位置标注的所有笔记。该工具专为个人使用而设计,依赖于你自己的认证浏览器和应用数据,以确保隐私安全。 **主要前提条件:** * **系统:** macOS、Chrome(需启用 Apple Events)以及新版 Kindle Mac 应用。 * **依赖项:** 安装了 "Control Chrome" MCP 扩展的 Claude Desktop、Xcode 命令行工具以及 Python 3。 该工具自动化了提取过程,为研究人员和读者重新掌握其知识产权提供了可靠的解决方案。完整的技术文档和项目背后的故事可在作者的 [Substack](https://baowebdev.substack.com) 上查看。

一篇 Hacker News 上的讨论介绍了一款由开发者 `l3a0` 开发的新工具,该工具可以恢复被亚马逊导出限制所截断或屏蔽的 Kindle 读书笔记。 用户经常遇到笔记“被隐藏或截断”的问题,导致无法获取自己的标注内容。`l3a0` 通过一种基于 macOS 的方案绕过了这些限制:同步 Mac 版 Kindle 应用的本地 SQLite 数据库以获取精确的标注位置,从 Kindle Cloud Reader 截取图像,并利用 Apple Vision 进行端侧 OCR(光学字符识别)以找回丢失的文本。 该讨论帖引发了关于从 Kindle 生态导出数据之难的广泛讨论。评论者指出,亚马逊正日益收紧限制,导致一些用户转而使用 KOReader 等更易于管理笔记的替代性电子阅读器。虽然 `l3a0` 的方案目前仅限于 macOS 且需要借助 Claude Code 来自动化处理,但它为读者提供了一种无需破解 DRM 或依赖第三方云服务的有效途径,以找回属于自己的标注。参与者强调,确保个人笔记保持可访问且不依赖于封闭的专有平台,这类工具的重要性正日益凸显。
相关文章

原文

A personal collection of Claude Code skills, published as a single plugin under the l3a0 namespace. This repo is both the plugin and its own marketplace.

I write about how these tools get built — and about technology, business, and finance — at baowebdev.substack.com.

claude plugin marketplace add l3a0/claude-plugins
claude plugin install l3a0@l3a0

Skills are invoked as /l3a0:<skill-name> (the bare /<skill-name> also works while no other installed command claims the name), and Claude auto-invokes them when a request matches a skill's description.

Export a heavily-highlighted book from Amazon's notebook page and some highlights come back cut off mid-sentence, while others come back as a bare location number with no text at all, under this notice:

"Some highlights have been hidden or truncated due to export limits."

Those are your own notes, in your own account, capped by a budget Amazon doesn't document and you can't raise. This skill gets them back: it extracts every highlight for a book from the Kindle notebook (read.amazon.com/notebook) into one combined, verbatim, location-cited Markdown file — including the highlights the export limit truncates or hides entirely, which are recovered from the Mac Kindle app's synced annotation positions plus the Cloud Reader's rendered pages.

Proven on four real books: 2,432 highlights extracted, 815 of them export-blocked (454 truncated + 361 fully hidden) — every one recovered, with recovered text landing within a couple of characters of the Kindle app's own position ruler (median residual 0–1). Every gotcha in the skill was earned by real debugging across those runs. The build story — why the export limit exists, the three unlocks that beat it, and what a library of exports becomes — is written up in How to Take Back Your Kindle Highlights, also published on Substack.

Scope: this exports your own highlights from your own Amazon account, by driving your own logged-in browser session and reading files the Kindle app stores on your Mac. The output is for your personal notes — book text is copyrighted, so keep extracted notes private.

Prerequisites (macOS only)

The pipeline is macOS-only three times over: browser control runs over AppleScript, OCR uses Apple's Vision framework, and highlight positions come from the Mac Kindle app's data files.

  1. Claude Desktop with the "Control Chrome" extension — Anthropic's browser-control MCP, installed in one click from Claude Desktop → Settings → Extensions. It is the skill's verified path for executing JavaScript in your real Chrome (any browser MCP that can run JS in the tab can substitute). It requires a Chrome setting: Chrome menu bar → View → Developer → Allow JavaScript from Apple Events → check → quit and relaunch Chrome.
  2. Google Chrome, signed in to your Amazon account (the skill drives read.amazon.com).
  3. The current Mac Kindle app (App Store; bundle id com.amazon.Lassen — not the classic Kindle.app), signed in to the same Amazon account, with the book downloaded. Its synced annotation database provides exact highlight extents with no export limit.
  4. Xcode Command Line Tools (xcode-select --install) — the bulk-recovery path compiles a small Swift OCR helper (swiftc) that uses Apple Vision.
  5. python3 — builds the final Markdown and runs a localhost receiver (127.0.0.1:8931) that the reader page POSTs captures to.
  1. Scrapes all highlights from the notebook page DOM to JSON (verbatim typography preserved).
  2. Reads exact character-precise highlight positions from the Kindle app's SQLite database — including highlights the web export hides completely.
  3. For blocked text, captures the Cloud Reader's rendered pages via canvas (no OS screenshots needed), OCRs them locally with Apple Vision (zero tokens), and cuts the text to the known positions.
  4. Emits one Markdown file with ### Location N sections, blockquoted verbatim text, and flags for anything recovered or approximate, then runs a QA pass.

MIT

联系我们 contact @ memedata.com