pyzotero

Resumen general de pyzotero skill

Qué hace pyzotero

pyzotero es un cliente Python para la Zotero Web API v3. El skill de pyzotero te ayuda a leer, crear, actualizar y eliminar ítems, colecciones, etiquetas, adjuntos y exportaciones de citas de Zotero sin tener que construir llamadas a la API manualmente.

Quién debería usarlo

Es ideal para personas que trabajan con gestión automatizada de referencias, flujos de trabajo bibliográficos o mantenimiento de bibliotecas al estilo Zoterosync, especialmente en pyzotero para Academic Research, limpieza de bibliografías mediante scripts y pipelines de investigación que necesitan una integración fiable con Zotero.

Por qué vale la pena instalar este skill

El valor principal del skill de pyzotero es que convierte Zotero en un backend de biblioteca programable. En lugar de depender de un prompt puntual, obtienes una forma repetible de consultar metadatos, gestionar bibliotecas personales o de grupo, recuperar adjuntos y exportar formatos de cita con menos errores de API.

Cómo usar el skill de pyzotero

Instalar pyzotero

Usa el paquete de Python directamente y añade el extra de CLI solo si necesitas la búsqueda local de la app de escritorio de Zotero:

uv add pyzotero
uv add "pyzotero[cli]"

Si estás evaluando opciones de instalación de pyzotero, la CLI solo sirve cuando quieres buscar en una app local de Zotero en ejecución; el trabajo con la API remota no la necesita.

Empieza con los datos de entrada correctos

Una solicitud sólida para usar pyzotero debería incluir:

• tipo de biblioteca: user o group
• la operación: leer, crear, actualizar, eliminar, exportar o buscar
• el objeto de destino: clave del ítem, clave de la colección, etiqueta, adjunto o búsqueda guardada
• el formato de salida: objetos de Python, JSON, BibTeX, CSL-JSON o citas HTML

Ejemplo de estructura de prompt:

Usa pyzotero para listar los ítems de mi biblioteca de grupo, filtra los artículos de revista etiquetados como reviewed y exporta los resultados como CSL-JSON.

Lee los archivos en este orden

Para una configuración práctica, lee primero SKILL.md y después las referencias específicas que coincidan con tu tarea:

• references/authentication.md para claves de API, IDs de usuario y modo local
• references/read-api.md y references/search-params.md para recuperación y filtrado
• references/write-api.md para flujos de trabajo de crear, actualizar y eliminar
• references/files-attachments.md y references/full-text.md para PDFs e indexación
• references/exports.md para BibTeX, CSL-JSON y salida de citas
• references/error-handling.md para límites de tasa, conflictos y campos inválidos

Flujo de trabajo práctico para usar mejor pyzotero

1. Confirma si necesitas acceso a la API remota o solo búsqueda local.
2. Define las credenciales para la biblioteca correcta antes de llamar a métodos.
3. Prueba primero una llamada de lectura y luego amplía a acciones por lotes.
4. Usa claves, no títulos, para actualizar y eliminar.
5. Añade paginación o límites de salida desde el principio para que el resultado sea utilizable.

Preguntas frecuentes sobre el skill de pyzotero

¿pyzotero es solo para programadores?

No. Es más útil en flujos de trabajo con Python, pero también resulta accesible para personas sin mucha experiencia que pueden seguir una instalación breve y pasar entradas estructuradas. Si solo necesitas exportar citas manualmente de vez en cuando, quizá te convenga más un prompt normal de Zotero.

¿pyzotero funciona con bibliotecas personales y de grupo?

Sí. El skill de pyzotero admite ambas, pero una instancia de Zotero queda vinculada a una sola biblioteca. Eso importa cuando necesitas moverte entre una biblioteca personal y una biblioteca compartida de laboratorio o de equipo.

¿Cuándo no debería usar pyzotero?

No uses pyzotero si solo quieres dar formato rápido a una cita puntual dentro de Zotero, o si necesitas búsqueda de texto completo sin una app de escritorio de Zotero local. La CLI depende de Zotero local; la API no ofrece el mismo comportamiento de búsqueda local de texto completo.

¿pyzotero es bueno para Academic Research?

Sí, especialmente para gestión por lotes de literatura, limpieza de referencias, manejo de adjuntos y exportaciones reproducibles. Es menos útil si tu tarea consiste sobre todo en leer artículos en vez de organizar o transformar datos de Zotero.

Cómo mejorar el skill de pyzotero

Dale al skill los datos de la biblioteca que faltan

La mayor mejora de calidad viene de especificar desde el principio el contexto de la biblioteca. Para pyzotero, incluye el ID de la biblioteca, si es user o group, y si quieres modo local o la API remota. Sin eso, las respuestas suelen quedarse genéricas o elegir la vía de acceso incorrecta.

Sé explícito sobre la forma de los datos que quieres

Indica si quieres un solo ítem, una lista de ítems, un árbol de colecciones, metadatos de adjuntos o un archivo de exportación. Las buenas entradas para pyzotero se parecen a esto:

• “devuelve solo claves y títulos”
• “actualiza abstractNote para estas claves de ítem”
• “exporta los 50 primeros resultados como BibTeX”
• “encuentra PDFs cuyo texto completo mencione gene editing”

Vigila los modos de fallo más comunes

Los errores más habituales de pyzotero son usar títulos en lugar de claves, omitir la configuración de autenticación y intentar hacer demasiadas escrituras por lotes de una sola vez. Otro problema frecuente es esperar búsqueda local de texto completo solo con la API. Si los resultados no cuadran, comprueba si la consulta debe usar metadatos del ítem, texto completo o filtros de colección.

Itera después del primer intento

Si la primera salida es demasiado amplia, afínala añadiendo tipo de ítem, lógica de etiquetas, clave de colección o rango de fechas. Si la primera escritura o actualización es arriesgada, pide a pyzotero que haga un dry-run del payload o que muestre los campos exactos del ítem antes de aplicar cambios. Esta es la forma más rápida de mejorar el uso de pyzotero en flujos de trabajo de investigación reales.