¿Qué escribiste cuando terminaste Pride and Prejudice? En este diario de lectura, la respuesta es “I kept noticing who misunderstood whom.” (No dejaba de fijarme en quién malinterpretaba a quién). Corresponde a la edición en tapa blanda de Penguin, ISBN 9780141439518, y la terminaste el 8 de noviembre. La frase sigue ahí cuando abres un chat nuevo.
Vas a crear Shelf Notes, un diario de lectura privado en Google Sheets. Open Library aporta los datos de la edición, tú aportas la fecha y la idea que quieres conservar, y un Agent de Quickchat AI los pone en la misma fila después de que tú lo confirmes.
Descarga el kit inicial de Shelf Notes. Abre Shelf Notes.xlsx para ver el ejemplo terminado. Usa los dos archivos TSV para crear tu propio diario en Google Sheets. Empiezan una entrada antes, cuando la persona todavía está leyendo. El kit también contiene la configuración exacta de las Action y Main Prompt.
1. ¿Qué edición tienes en tu estantería?
Prueba la búsqueda antes de conectar nada. Abre la edición con el ISBN 9780141439518. Es un libro en inglés de 435 páginas en tapa blanda publicado por Penguin Books en 2003. La novela de Jane Austen apareció por primera vez en 1813. Ambas fechas pertenecen a Pride and Prejudice, pero solo una describe el ejemplar que tienes sobre la mesa.
- Crea una cuenta o inicia sesión en Quickchat AI. Usa tu agente vacío o elige Add new AI Agent → Set up manually. Ponle el nombre Shelf Notes. Necesitarás una cuenta de Google para el diario y créditos de IA disponibles para probar una conversación.
- Antes de añadir notas personales, abre Your Website → Install → Availability and access. Desactiva Widget & Embed access, pon Chat Page Access en Nobody y deja los demás canales desconectados. Usa AI Preview en tu panel una vez hayas iniciado sesión.
- En Identity → Main Prompt, pega
main-prompt.txtdel kit. Le indica al agente que muestre la entrada propuesta y espere una confirmación aparte. - En Actions & MCPs → Add Action → API Action → Create manually, crea las dos acciones GET de abajo. En cada una, usa When to run → AI decides, añade un parámetro obligatorio de tipo Text llamado
isbnen What to ask the user first y deja el cuerpo vacío. Quita los espacios y guiones del número, conservando los ceros iniciales y unaXfinal en ISBN-10.
| Nombre de la acción | URL de la API | Qué usar del resultado |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | En Query Params, introduce isbn={{isbn}}, fields=key,title,author_name,first_publish_year y limit=1. La obra aporta el autor y el año original de la novela. |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | Comprueba que el número proporcionado aparezca en isbn_13 o isbn_10. Lee la editorial, la fecha de la edición y el idioma cuando estén presentes. Añade la clave devuelta /books/ a https://openlibrary.org para el enlace de origen. |
Escribe el ISBN en la conversación. La acción lo inserta en una URL cuyo host queda fijo en el editor.
En la primera búsqueda también pedimos la lista de ediciones de la obra. Para este ISBN concreto, eso devolvió 4,042 IDs de edición. Al quitar ese campo, la respuesta quedó breve y solo incluyó la autora y el año original. La segunda solicitud siguió devolviendo la edición en tapa blanda que queríamos.
En Headers, asigna a cada solicitud un User-Agent con el valor ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), sustituyendo el contacto de ejemplo por el tuyo. Pega la API Action Description correspondiente desde action-recipes.md, guarda y activa cada acción. Prueba con “Look up ISBN 978-0-14-143951-8.”. Deberías ver la edición sin crear una entrada en el diario. Esta búsqueda personal no necesita una cuenta de Open Library. Úsala cuando alguien pregunte por un libro y sigue las directrices de uso de la API de Open Library.
2. ¿Qué va en el diario de lectura?
Separa en columnas los datos del catálogo y tus propias observaciones. Podrías prestarle a alguien esta edición exacta y discrepar sobre todos los personajes. El ISBN sigue siendo el mismo. Tu nota pertenece a tu lectura, identificada aquí como PAP-01.
- Abre Actions & MCPs → Add Action → Google Sheets → Connect. Autoriza la cuenta de Google que será la propietaria del diario y luego elige Open sheet. La conexión crea una hoja de cálculo en Drive con su permiso
drive.file. La guía para conectar Google Sheets muestra las pantallas de autorización. Si es tu diario personal, abre Compartir en Hojas de cálculo de Google y deja Acceso general en Restringido. - Desactiva la acción inicial activa,
log_lead_to_google_sheet. Conserva su nombre y copia su API Endpoint con el ID del archivo ya completado. Deja desactivada la acción inicial. Crearás acciones separadas para este diario.
Abre el archivo creado para este agente. La acción inicial ya contiene el ID de la hoja de cálculo que necesitas.
- Cambia el nombre de la pestaña Leads a Events y sustituye su contenido por
Events.tsv, empezando en A1. Antes de pegar, da formato de Plain text a las columnas B (ISBN) y F (fecha). Añade una segunda pestaña llamada Status. En una hoja de ejemplo nueva, usa File → Settings → Locale → United States para que las fórmulas de abajo acepten comas.
Empieza con la fila 2. PAP-01 sigue en curso, con “Started with the Netherfield visit.” en G2. Cuando confirmes, la entrada finalizada aparecerá en la fila 3.
Las ocho columnas de Events, en este orden, son reading_id, isbn, title, edition_url, status, reading_date, note y conversation. La última celda contiene un enlace de vuelta a la conversación. El primer evento del starter dice reading el 2 de noviembre. Su nota es “Started with the Netherfield visit.”.
Mantén un mismo ID de lectura mientras un libro pasa de reading a finished. Elige uno nuevo cuando vuelvas a ese libro para releerlo.
3. ¿Cómo guardas una nota de lectura con un ISBN?
La búsqueda responde a “¿Qué libro es?”. Guardar responde a una pregunta distinta: “¿Es esto lo que quiero recordar?”. Configura una Action para añadir la fila confirmada y otra para comprobar qué contiene realmente la hoja de cálculo.
- Crea una API Action llamada
append_reading_event. Copia la URL de Google Sheets de la acción inicial, conservando todo hasta su ID de archivo real. Sustituye el resto por/values/Events!A:H:append. Define POST y añade la entrada de Query ParamsvalueInputOption=RAW. El modo de entrada sin procesar conserva los ISBN y trata como texto una nota que empiece por=. - En Headers, define
AuthorizationcomoBearer {{google_sheets_access_token}}yContent-Typecomoapplication/json. Quickchat AI completa el token en el momento de la solicitud. - Añade seis parámetros obligatorios de Text llamados
reading_id,isbn,title,edition_url,statusyreading_date. Añade un parámetro opcional de Text llamadonotecon el valor por defecto en blanco. Eligereading,finished,pausedoabandonedpara el estado. Usa la fecha de la persona lectora comoYYYY-MM-DD. - En API Endpoint → Body, pega el JSON de abajo. Los dos pares de corchetes significan una fila con ocho celdas.
conversation_urlviene incorporado. Pega la descripción para añadir del kit en API Action Description. - Crea
read_reading_journalcomo una GET para la misma hoja de cálculo, terminando en/values/Events!A2:H1000. Dale el mismo encabezado Bearer, la descripción del historial del kit, sin parámetros y con el cuerpo vacío. Guarda y habilita ambas Actions.
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
La matriz se alinea con las columnas A a H. Si mantienes la nota en la séptima posición, tus palabras quedan en la columna G.
Con la fila inicial ya puesta, envía el siguiente mensaje en AI Preview.
Look up ISBN 978-0-14-143951-8. I finished PAP-01 on 2026-11-08. My note: I kept noticing who misunderstood whom.
Comprueba la edición propuesta, el ID, la fecha y la puntuación. En este punto, Events todavía debe contener solo la entrada inicial. Luego di “Yes, that is my edition. Save PAP-01 with that status, date and note.”. Debería aparecer un segundo evento en la fila 3.
La propuesta te da una última oportunidad de revisar el ISBN y tu redacción. Puedes corregir cualquiera de los dos antes de que cambie el diario de lectura.
En nuestra prueba en vivo, la propuesta dejó intacta la fila inicial. Tras la confirmación, Shelf Notes revisó el diario, volvió a comprobar el ISBN, añadió una sola fila y leyó la fila nueva. En Inbox, despliega append_reading_event y compara el updates.updatedRange de Google con las celdas de tu hoja. Si una solicitud agota el tiempo de espera, busca la fila antes de intentarlo de nuevo. Referencia de Google Sheets para añadir filas
Google informó de una fila y ocho celdas actualizadas en Events!A3:H3. Selecciona G3 para comparar su texto con la nota que aprobaste.
4. ¿Qué puedes preguntar en una conversación nueva?
Abre una conversación nueva en AI Preview y pregunta “What was the last note I saved for PAP-01?”. En nuestra prueba, el agente volvió a leer Events y devolvió “I kept noticing who misunderstood whom.” La fila 2 sigue guardando la nota anterior de Netherfield. Google puede omitir las celdas vacías del final de una fila devuelta, así que es normal que el enlace de conversación de tu fila inicial aparezca en blanco.
Para “Which books am I still reading?”, dos eventos de una misma lectura darían una respuesta engañosa si contaras cada fila. Usa la pestaña Status para seleccionar el último evento añadido de cada ID de lectura.
- Pega
Status.tsven Status!A1. Su fórmula en A2 enumera cada ID de lectura una sola vez. B2 usa una búsqueda de coincidencia exacta empezando desde el final de Events. Rellena B2 hacia abajo junto a los ID nuevos a medida que crece tu registro. D2 cuenta los ID cuyo estado más reciente esfinished. - Crea
read_reading_status, otra GET con el mismo encabezado bearer, usando el sufijo/values/Status!A1:B1000. Pega la descripción de estado del kit, deja vacíos el cuerpo y los parámetros, luego guárdala y habilítala. - Pregunta qué libros están terminados. En el ejemplo, Status tiene una lectura terminada,
PAP-01. Para una segunda lectura de la novela, asígnalePAP-02. Así podrás distinguir lo que notaste la primera vez de lo que notaste la segunda.
Copia las tres fórmulas de Google Sheets
Status!A2 enumera los identificadores.
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2 busca el evento más reciente para el ID de la columna A.
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2 cuenta las lecturas terminadas.
=COUNTIF(B2:B1000,"finished")
La receta cubre 999 eventos. Antes de que una entrada nueva vaya a caer por debajo de la fila 1000, amplía a la vez los rangos de lectura y los rangos de las fórmulas. Ten en cuenta las notas largas y las colecciones grandes al decidir cuánto historial devolver en una sola conversación. Referencia de XLOOKUP de Google Sheets
5. ¿Funciona con el libro que tienes sobre la mesa?
Coge otro libro y prueba con su ISBN impreso. Pide la edición y luego detente. Una buena primera comprobación es poder consultar un libro sin añadirlo. Después, dale un ID de lectura y una frase que solo tú podrías haber escrito. Confírmala, cierra el chat y pide que te devuelva esa frase.
Para hacer comprobaciones reproducibles, usa Testing → Simulation y luego revisa Actions & MCPs → View logs y las celdas de destino. Prueba con un ISBN no reconocido, rechaza una entrada propuesta y guarda una nota de prueba que empiece por =1+1. Los dos primeros casos no deberían alterar el historial. El último debería mostrar los caracteres literales en la celda de la nota.
También hicimos que la hoja local guardara una fila y luego agotara el tiempo de espera antes de responder. Shelf Notes volvió a leer la fila, informó del tiempo de espera y no hizo una segunda inserción. Puedes comprobar ese mismo detalle en el registro de la acción si alguna vez un guardado te deja con la duda de si volver a pulsar Enviar.
En la prueba de edición no encontrada, el catálogo devolvió 404. El agente pidió otro identificador y el diario mantuvo sus dos filas.
Si prefieres configurar el agente desde otro asistente, el kit incluye una solicitud de configuración para el conector de cuenta de Quickchat AI. Adjunta action-recipes.md y main-prompt.txt, y luego dale setup-request.txt. Revisa las cinco Actions, completa tú mismo la autorización de Google y haz la misma prueba de lectura. Conector de ChatGPT · Conector de Claude · Guía de configuración de la cuenta
Preguntas frecuentes
¿Cómo añado un libro a Google Sheets usando su ISBN?
Usa el ISBN impreso en tu ejemplar para buscar su edición en Open Library. Revisa el título, la editorial y el año, añade tu estado de lectura y tu nota, y luego confirma la fila. El kit inicial incluye los encabezados de la hoja, las fórmulas y las cinco recetas de Action de Quickchat AI.
¿Puedo usar un diario de lectura que ya tengo en Google Sheets?
Copia las entradas que quieras en la pestaña Events de la hoja de cálculo creada por la conexión de Quickchat AI. Haz coincidir las ocho columnas y conserva los ISBN como texto. Pegar el ID de otro archivo privado en la Action no le da permiso para abrir ese archivo.
¿Qué pasa si Open Library no encuentra mi ISBN?
Comprueba el número del código de barras o de la página de derechos, incluido cualquier cero inicial o la X final. Si aun así no se puede verificar la edición, deja el diario sin cambios. Un ISBN identifica una edición y no da acceso al texto completo del libro.
¿Cómo cuento los libros terminados y llevo el control de las relecturas?
Asigna a cada lectura su propio ID. Conserva ese ID cuando pauses o termines el libro, y asigna uno nuevo a una relectura. Cuenta las entradas terminadas en la pestaña Status. Así, dos lecturas terminadas de la misma edición cuentan dos veces, mientras que dos actualizaciones de una misma lectura cuentan una sola vez.
¿Puedo encontrar una nota de lectura después de cerrar el chat?
Sí. Pide el libro o el ID de lectura en un chat privado nuevo. La Action del historial vuelve a leer la pestaña Events, donde se guardan las entradas con fecha y tus palabras originales. La pestaña Status aporta el estado registrado más reciente de cada lectura.