¿Qué hace cli-anything-zotero?
cli-anything-zotero es un CLI nativo para agentes de Zotero desktop. No reimplementa Zotero. En su lugar, compone las superficies locales reales de Zotero:
Instalación
pip install -e .
Puntos de Entrada
cli-anything-zotero
python -m cli_anything.zotero
Restricciones Importantes
search items,item export,item citationyitem bibliographyrequieren que la API Local de Zotero esté habilitada.note adddepende del contexto de la GUI en vivo de Zotero y espera que la misma biblioteca esté seleccionada en la aplicación.- El soporte de adjuntos PDF en el momento de la importación se limita a elementos creados en la misma sesión del conector; la carga de adjuntos arbitrarios de elementos existentes aún está fuera del alcance.
- Los comandos experimentales de escritura SQLite son solo locales, solo para bibliotecas de usuario, y deben tratarse como operaciones de usuario avanzado no estables.
- Si una clave simple está duplicada entre bibliotecas, establezca
session use-library <id>antes de los comandos de seguimiento.
Grupos de Comandos
App
Comandos de inspección de la aplicación y tiempo de ejecución.
| Comando | Descripción |
|---|---|
status | Ejecutar status. |
version | Ejecutar version. |
launch | Ejecutar launch. |
enable-local-api | Ejecutar enable-local-api. |
ping | Ejecutar ping. |
Collection
Comandos de inspección y selección de colecciones.
| Comando | Descripción |
|---|---|
list | Ejecutar list. |
find | Ejecutar find. |
tree | Ejecutar tree. |
get | Ejecutar get. |
items | Ejecutar items. |
use-selected | Ejecutar use-selected. |
create | Ejecutar create. |
Item
Comandos de inspección y renderizado de elementos.
| Comando | Descripción |
|---|---|
list | Ejecutar list. |
find | Ejecutar find. |
get | Ejecutar get. |
children | Ejecutar children. |
notes | Ejecutar notes. |
attachments | Ejecutar attachments. |
file | Ejecutar file. |
export | Ejecutar export. |
citation | Ejecutar citation. |
bibliography | Ejecutar bibliography. |
context | Ejecutar context. |
analyze | Ejecutar analyze. |
add-to-collection | Ejecutar add-to-collection. |
move-to-collection | Ejecutar move-to-collection. |
Search
Comandos de inspección de búsquedas guardadas.
| Comando | Descripción |
|---|---|
list | Ejecutar list. |
get | Ejecutar get. |
items | Ejecutar items. |
Tag
Comandos de inspección de etiquetas.
| Comando | Descripción |
|---|---|
list | Ejecutar list. |
items | Ejecutar items. |
Style
Comandos de inspección de estilos CSL instalados.
| Comando | Descripción |
|---|---|
list | Ejecutar list. |
Import
Comandos oficiales de importación y escritura de Zotero.
| Comando | Descripción |
|---|---|
file | Ejecutar file. |
json | Ejecutar json. |
Note
Leer y agregar notas secundarias.
| Comando | Descripción |
|---|---|
get | Ejecutar get. |
add | Ejecutar add. |
Session
Comandos de sesión y contexto REPL.
| Comando | Descripción |
|---|---|
status | Ejecutar status. |
use-library | Ejecutar use-library. |
use-collection | Ejecutar use-collection. |
use-item | Ejecutar use-item. |
use-selected | Ejecutar use-selected. |
clear-library | Ejecutar clear-library. |
clear-collection | Ejecutar clear-collection. |
clear-item | Ejecutar clear-item. |
history | Ejecutar history. |
Ejemplos
Estado del Runtime
Inspeccionar rutas de Zotero y disponibilidad del backend.
cli-anything-zotero app status --json
Leer Colección Seleccionada
Persistir la colección seleccionada en la GUI de Zotero.
cli-anything-zotero collection use-selected --json
Renderizar Cita
Renderizar una cita usando la API Local de Zotero.
cli-anything-zotero item citation <item-key> --style apa --locale en-US --json
Agregar Nota Secundaria
Crear una nota secundaria bajo un elemento existente de Zotero.
cli-anything-zotero note add <item-key> --text "Conclusión clave" --json
Construir Contexto LLM
Ensamblar contexto estructurado para análisis posteriores del modelo.
cli-anything-zotero item context <item-key> --include-notes --include-links --json
Versión
0.1.0