Readwise Reader CLI
Conecta Readwise Reader a Claude Code
Pega un prompt. Claude te pregunta qué quieres hacer con tu biblioteca, instala el CLI oficial de Readwise y te guía paso a paso para iniciar sesión.
Abre Claude Code
Tú haces esto- 1Abre Claude Desktop
- 2Haz clic en la pestaña Claude Code
- 3Elige cualquier carpeta para trabajar
Pega este prompt
Claude CodeClaude te hará unas preguntas, revisará tu ordenador, instalará el CLI y te dirá exactamente cómo iniciar sesión. Solo tienes que seguirle.
Después, prueba con estos
Cuando Claude confirme que está conectado, pídele cosas como:
Enséñame los últimos 10 artículos que guardé en Reader
Busca en mi biblioteca todo lo que tengo sobre 'spaced repetition'
Resume el documento que más he resaltado este mes
Archiva los artículos de mi inbox que ya leí al 100%
El CLI en detalle
Lo que el prompt monta por ti, para quien prefiera hacerlo a mano.
Setup
Instala en 3 pasos
Instala el CLI
Requiere Node.js. Una instalación global deja el comando readwise en tu PATH.
Copia tu token de acceso
Un token de cuenta (no caduca salvo que lo revoques). Cópialo desde los ajustes de Readwise.
readwise.io/access_tokenInicia sesión y verifica
El login por token es headless (sin navegador), ideal para scripts y cron. La auth queda cacheada, así que solo lo haces una vez.
Reference
Qué puedes ejecutar
Los comandos con prefijo reader- actúan sobre tus documentos de Reader; los readwise- sobre tus highlights. Añade --json a cualquier comando para salida legible por agentes, y --help para ver todas sus opciones.
| Comando | Qué hace |
|---|---|
| reader-list-documents | Lista documentos por ubicación (new, later, shortlist, archive, feed), con filtros y selección de campos. |
| reader-search-documents | Búsqueda semántica sobre todo lo guardado, opcionalmente por categoría, autor o fecha. |
| reader-get-document-details | Trae el contenido completo de un documento en Markdown, listo para resumir o citar. |
| reader-create-document | Guarda una URL (Reader la scrapea) o Markdown en crudo, con título, tags y notas. |
| reader-move-documents | Mueve documentos entre ubicaciones: archiva lo leído, manda cosas a later. |
| reader-export-documents | Exporta toda la biblioteca (o un delta desde una fecha) como ZIP de ficheros Markdown. |
| Comando | Qué hace |
|---|---|
| readwise-list-highlights | Lista tus highlights más recientes, o filtra por libro o fecha. |
| readwise-search-highlights | Búsqueda semántica y full-text sobre cada highlight que has hecho. |
| reader-get-document-highlights | Trae todos los highlights de un documento concreto de Reader. |
| reader-create-highlight | Resalta un pasaje con una nota y tags opcionales. |
| readwise-get-daily-review | Trae el repaso diario (repetición espaciada) de highlights pasados. |
Ubicaciones de Reader: new (inbox), later, shortlist, archive, feed.
Capacidades
- Búsqueda semántica sobre toda tu biblioteca: cada palabra de cada artículo, PDF y newsletter está indexada.
- Lee y escribe: guardar, resaltar, etiquetar, mover y exportar, no solo consultar.
- Lista para agentes: salida --json en cada comando y --help para todas las opciones.
- Headless: el login por token funciona en scripts y cron, sin navegador.
Limitaciones
- Requiere una suscripción activa de Readwise (Reader incluido); no hay plan gratis para la API.
- Tiene rate limit (del orden de 20 peticiones/minuto en list y get); el CLI cachea, usa --refresh para forzar.
- Los highlights vienen planos y newest-first, así que un documento muy resaltado inunda la lista.
- No hay una ubicación "leído": usa el campo reading_progress para saber qué terminaste de verdad.