En pocas palabras: El skill gratuito y open source kindle-highlights, creado por el desarrollador l3a0, recupera en Claude Code los subrayados que Amazon trunca u oculta al exportar: en cuatro libros reales devolvió completos los 815 highlights bloqueados de un total de 2.432, en archivos Markdown con la ubicación citada.
Pedís el export de tus notas y Amazon responde con frases cortadas y destacados que aparecen solo como un número de ubicación. No es un error puntual: es un tope de exportación aplicado sin explicación, y castiga más fuerte a los libros densamente subrayados. Contra ese techo va kindle-highlights, un skill gratuito y open source para Claude Code que reconstruye los subrayados bloqueados y los entrega en archivos Markdown, con la ubicación citada.
El desarrollador l3a0 publicó el plugin en su marketplace personal de skills para Claude Code, la CLI de Anthropic que ejecuta tareas con sus modelos desde la terminal. Si alguna vez intentaste recuperar highlights de Kindle y te frenó el aviso de exportación limitada, esta herramienta ataca el problema de punta a punta: cruza la página de notas de Amazon, la base local de la app Kindle y las páginas del Cloud Reader.
Claude Code es la herramienta de línea de comandos de Anthropic para trabajar con sus modelos directamente en la terminal; acepta skills, módulos que se activan solos cuando tu pedido coincide con su descripción.
En 30 segundos
- Qué es: un skill open source para Claude Code que reconstruye los subrayados que el export web de Amazon corta o esconde.
- Los números: 2.432 highlights extraídos en 4 libros; 815 estaban bloqueados (454 truncados, 361 ocultos por completo) y los recuperó todos.
- Precisión: en mediana, el texto rescatado queda a 0–1 caracteres de las posiciones que registra la propia app Kindle.
- Requisito clave: solo macOS, con Chrome, la extensión Control Chrome de Claude Desktop, la app Kindle y Xcode Command Line Tools.
- Costo: el skill es gratis; el OCR corre en local con Apple Vision y consume cero tokens.
¿Por qué Kindle bloquea y trunca tus highlights?
Amazon aplica sobre tus propios subrayados un tope de exportación que no documenta y que nadie puede subir. Cuando un libro supera ese umbral, la página de notas de Amazon devuelve frases cortadas a la mitad y otros destacados reducidos a un número de ubicación sin texto, bajo este aviso: “Some highlights have been hidden or truncated due to export limits.”
Ponele que leíste un libro denso, de esos que subrayás cada dos páginas. Pedís el export, esperás, y te llega una lista mutilada: algunas citas terminan a mitad de idea y otras directamente figuran como “ubicación 1.234” sin una sola palabra de contexto. Según las mediciones del propio autor, en libros muy trabajados eso alcanza al 33,5% de las marcas. Son tus notas, en tu cuenta, sujetas a un “presupuesto de exportación” que Amazon no explica. (Sí, en serio.)
¿Por qué existe el límite? La explicación de fondo, con la tensión entre notas personales y derechos editoriales, la desarrolla el propio l3a0 en su ensayo How to Take Back Your Kindle Highlights. Lo verificable por tu cuenta es el comportamiento y el aviso.
¿Cuáles son los requisitos para usar el skill de Claude Code?
Necesitás una Mac y cinco piezas alrededor: Claude Desktop con la extensión Control Chrome, Chrome con JavaScript habilitado desde Apple Events, una sesión activa de Amazon, la app Kindle con el libro descargado y Xcode Command Line Tools. Sin alguna de esas, el pipeline no arranca.
| Componente | Función en el pipeline | Cómo conseguirlo |
|---|---|---|
| Claude Desktop + extensión “Control Chrome” | Maneja tu Chrome real y ejecuta JavaScript en la pestaña del notebook | Claude Desktop > Settings > Extensions, en un clic |
| Chrome de escritorio | Sesión de Amazon y lectura del DOM | Menú Ver > Developer > “Allow JavaScript from Apple Events”, y reiniciar el navegador |
| App Kindle para Mac | Base SQLite con posiciones carácter a carácter | App Store, misma cuenta de Amazon, libro descargado |
| Xcode Command Line Tools | Compila el helper de OCR escrito en Swift | Terminal: xcode-select --install |
| Python | Arma el Markdown final y levanta el receptor local | — |
¿Por qué tan quisquilloso con el sistema operativo? Porque tres dependencias son exclusivas de Apple: el control del navegador corre sobre AppleScript, el OCR usa el framework Vision y las posiciones de cada subrayado salen de los archivos de datos de la app Kindle de escritorio. Un skill “multiplataforma” esto no es (spoiler: tampoco lo promete). Ya lo cubrimos antes en nuestra guía completa sobre Claude.
¿Cómo ejecutar el skill para recuperar highlights de Kindle?
El flujo completo toma minutos y se resume en instalar, conectar el navegador, unificar cuentas y pedir el export. Estos son los pasos tal como los documenta el repositorio:
- Instalá el plugin: corré
claude plugin marketplace add l3a0/claude-pluginsy despuésclaude plugin install l3a0@l3a0. - Conectá el navegador: activá Control Chrome desde Claude Desktop y habilitá “Allow JavaScript from Apple Events” en Chrome; reiniciá el navegador.
- Unificá cuentas: logueá la misma cuenta de Amazon en Chrome y en la app Kindle. Acordate de descargar el libro en la app antes de seguir.
- Invocá el skill: pedile los highlights del libro por nombre, o simplemente plantéale la tarea.
- Recibí el Markdown: un archivo con secciones por capítulo, citas en blockquote, banderas de recuperación y un pase de QA al final.
Detalle útil: el skill también se dispara solo cuando tu pedido coincide con su descripción, sin que tengas que acordarte del comando exacto.
¿Dónde se guardan realmente tus highlights de Kindle?
Tus anotaciones viven en tres lugares, y el único con restricciones es el export web. El resto está en tu máquina.
La primera fuente es el DOM de la página de notas, de donde el skill raspa todo lo visible conservando la tipografía original. Acá viene lo bueno: la segunda es una base SQLite dentro de Kindle.app que sincroniza la extensión exacta de cada subrayado, carácter por carácter, sin pasar por ningún filtro de exportación. La tercera son las páginas que el Cloud Reader dibuja en el navegador, útiles cuando falta el texto. O sea, el tope de Amazon limita lo que te muestra el export, no lo que tu disco ya contiene.
¿Y si un highlight aparece oculto hasta en la web? Ahí entra el tercer recurso.
¿Cómo recupera el skill el texto truncado con OCR?
Para cada subrayado bloqueado, el skill captura la página renderizada del Cloud Reader vía canvas, le pasa OCR en local con Apple Vision (cero tokens de API) y recorta el texto según las posiciones que dicta la base de la app Kindle. Sin capturas de pantalla del sistema. Cubrimos ese tema en detalle en elegir entre Sonnet y Opus.
Abrís el notebook, el DOM te entrega lo visible, la SQLite aporta la extensión exacta de cada marca y, donde el texto falta, capturás la página renderizada del Cloud Reader con canvas, corrés el OCR de Apple en local y cortás el resultado justo donde indican esas posiciones. Cada truco del skill salió de debugging real: tipografía preservada, ubicaciones citadas y banderas que marcan qué fue recuperado y qué quedó aproximado.
La precisión medida es notable: en mediana, el texto rescatado queda a 0–1 caracteres de las posiciones exactas que guarda la propia app Kindle. ¿Alguien de afuera replicó los números? Todavía no.
¿Qué resultados tiene? 2.432 highlights en 4 libros reales
Según los registros del autor en su repositorio de GitHub, el pipeline procesó 2.432 highlights de cuatro libros reales y recuperó los 815 que el export había bloqueado. Todos recuperados, sin excepciones.
El desglose: 454 subrayados truncados (18,7% del total) y 361 ocultos por completo (14,8%), que sumados hacen el 33,5% de la biblioteca procesada. Que más de un tercio de tus marcas quede rehén del filtro da una idea de cuánto duele el límite en libros densamente subrayados, justo los que un investigador o un escritor más valora.
El relato completo del desarrollo, con decisiones de diseño y tropiezos incluidos, está en el Substack del autor; el código y las instrucciones, en el repo. Te puede servir nuestra cobertura de integrar Claude con Make.com.
¿El skill sirve con cualquier libro? Comparativa con otros métodos
Está probado en cuatro libros, no hay lista oficial de compatibilidad, y donde mejor rinde es en textos muy subrayados, que son justo los que el tope castiga. Contra las alternativas caseras, la diferencia es de categoría:
| Método | Qué obtenés | Techo | Salida |
|---|---|---|---|
| Export web (notebook de Amazon) | Solo lo que el filtro deja pasar | Tope no documentado; trunca y oculta | Texto parcial en la web |
| My Clippings.txt por USB | Notas hechas en el dispositivo físico | Excluye marcas creadas desde apps o nube | TXT plano, sin estructura |
| Skill kindle-highlights | Todos los subrayados, verbatim y con ubicación | Ninguno observado en las pruebas del autor | Markdown con QA y banderas |
Fijate que el clásico My Clippings.txt acumula lo que marcás en el dispositivo físico conectado por cable, en texto plano y sin jerarquía, y deja afuera buena parte de lo subrayado desde apps o desde la nube. Para llevar una biblioteca entera a Obsidian o Notion, en cambio, el Markdown del skill entra directo en ambos: Obsidian lo lee nativo y Notion lo importa como página.
¿Es legal extraer mis propios subrayados de Kindle?
No hay posición pública de Amazon sobre este skill ni una regla clara que marque el borde legal. Lo defendible: son tus notas, tomadas en tu cuenta, y el skill opera con tu sesión y con archivos que ya están en tu Mac.
Ahora bien, dos cautelas concretas. Primero, el texto del libro pertenece al editor, y el autor lo dice sin rodeos en el alcance del proyecto: el resultado es para tus notas personales, mantenelo privado. Segundo, automatizar tu sesión logueada roza términos de servicio que nadie llevó a tribunales; tomalo con pinzas y no publiques los volúmenes extraídos.
¿Hay alternativas en Windows o Linux?
Hoy no, al menos ninguna comparable con soporte oficial: el pipeline depende de tres tecnologías de Apple y el autor no anunció ports. Circulan workarounds experimentales en foros, pero vienen sin documentación ni números verificables. Complementá con capacidades y precios del API de Opus.
Eso sí: en PC el menú se reduce a copiar a mano desde el Cloud Reader, que funciona pero con 800 subrayados se vuelve una tarde perdida, o a conformarse con el export parcial de Amazon. Para equipos de investigación en Latinoamérica que manejan bibliotecas digitales grandes, el dato incómodo es que la herramienta más capaz del mercado hoy exige hardware de una sola marca. La pregunta es si eso dura, porque la demanda existe.
¿Qué está confirmado y qué falta confirmar?
Lo que sigue consta en fuentes primarias; lo que falta, nadie lo respondió todavía.
Confirmado (según el propio autor)
- Volumen probado: 2.432 highlights en 4 libros, con los 815 bloqueados recuperados por completo.
- Precisión: en mediana, 0–1 caracteres de diferencia frente a las posiciones que registra la app Kindle.
- Stack: AppleScript, Vision framework, base SQLite de Kindle.app, canvas del Cloud Reader y salida Markdown con QA.
Pendiente o sin respuesta
- Fecha de lanzamiento: el README no publica fecha.
- Réplica independiente: nadie externo publicó aún una verificación de los números.
- Posición de Amazon: silencio sobre el skill y sobre el propio límite.
- Versión multiplataforma: no anunciada.
Errores comunes al intentar recuperar tus highlights
Viendo cómo funciona el pipeline, estos son los tropiezos más previsibles:
Si además leés en Kindle y querés guardar tus notas, tenemos un artículo sobre recuperar highlights de Kindle que te va a servir.
- Correrlo en Windows o Linux: no va a arrancar; tres dependencias son de Apple. La única vía hoy es una Mac.
- No descargar el libro en la app Kindle primero: sin la base SQLite local no hay posiciones exactas, y los subrayados ocultos quedan irrecuperables en esa corrida.
- Saltarse el permiso de JavaScript de Apple Events: si no activás la opción en Ver > Developer de Chrome (y reiniciás el navegador), el control remoto falla casi sin avisar.
- Compartir el Markdown resultante: el texto subrayado es propiedad del editor; difundirlo te mete en terreno que el propio autor te pide evitar.
Preguntas Frecuentes
¿Qué es kindle-highlights y quién lo desarrolló?
Es un skill open source creado por el desarrollador l3a0 para Claude Code, la CLI de Anthropic. Su función es reconstruir los subrayados que el límite de exportación de Amazon corta u oculta: en sus pruebas recuperó los 815 highlights bloqueados de un total de 2.432 en cuatro libros.
¿Cuánto cuesta el skill para Kindle highlights?
Nada: el código es público y gratuito en GitHub. Necesitás una cuenta de Claude y una Mac con la app Kindle, y como el OCR corre en local con Apple Vision, el proceso no consume tokens adicionales.
¿En qué formato exporta los subrayados?
En Markdown verbatim: un archivo con secciones por capítulo, cada cita en blockquote con su ubicación y banderas que indican qué texto fue recuperado o aproximado. Como es Markdown puro, lo podés meter directo en Obsidian o importarlo a Notion.
¿Funciona con todos los libros de Kindle?
El autor lo validó en cuatro libros reales y no publica una matriz de compatibilidad. Donde más brilla es en títulos densamente subrayados, que son justo los que disparan el tope; en libros con pocas marcas, el export oficial zafa.
¿Amazon puede cerrar este método?
Podría hacerlo cambiando su web o sus apps, y hoy no existe respuesta oficial de la empresa. El skill funciona con tu propia sesión y con datos que ya están en tu computadora, así que conviene exportar tu biblioteca mientras la ventana siga abierta.
Conclusión
El cambio concreto: un límite opaco que llevaba años tratando tus notas como mercancía regulada dejó de ser un muro, porque alguien demostró con números que la información completa ya estaba en tu equipo. Para cualquiera que armó una biblioteca de subrayados durante años, poder recuperar highlights de Kindle completos, con ubicaciones citadas y en archivos buscables, es un golazo.
Mi opinión tras revisar el repo: es de las soluciones mejor resueltas que vi para este problema, aunque conviene moverse rápido, porque todo descansa sobre piezas (la web del notebook, la app Kindle) que Amazon puede cambiar cuando quiera. Si tenés una Mac y libros muy subrayados, instalá el plugin, probalo con un solo título y guardá el resultado en privado. Las notas son tuyas; el texto, no. Esa línea separa lo que podés hacer de lo que no deberías.
Fuentes
- GitHub – l3a0/claude-plugins – repositorio oficial del skill kindle-highlights y su marketplace
- Baowebdev (Substack) – ensayo del autor: How to Take Back Your Kindle Highlights
- Amazon – Read Notebook – página oficial de notas y subrayados, origen del límite de exportación