O que cli-anything-zotero faz?
cli-anything-zotero é uma CLI nativa para agentes do Zotero desktop. Ela não reimplementa o Zotero. Em vez disso, combina as interfaces locais reais do Zotero:
Instalação
pip install -e .
Pontos de Entrada
cli-anything-zotero
python -m cli_anything.zotero
Restrições Importantes
search items,item export,item citationeitem bibliographyexigem que a API Local do Zotero esteja ativada.note adddepende do contexto ativo da GUI do Zotero e espera que a mesma biblioteca esteja selecionada no aplicativo.- O suporte a anexos PDF em tempo de importação é limitado a itens criados na mesma sessão do conector; o upload arbitrário de anexos para itens existentes ainda está fora do escopo.
- Comandos experimentais de escrita no SQLite são apenas locais, apenas para bibliotecas do usuário e devem ser tratados como operações não estáveis para usuários avançados.
- Se uma chave simples estiver duplicada entre bibliotecas, defina
session use-library <id>antes dos comandos subsequentes.
Grupos de Comandos
App
Comandos de inspeção do aplicativo e tempo de execução.
| Comando | Descrição |
|---|---|
status | Executar status. |
version | Executar version. |
launch | Executar launch. |
enable-local-api | Executar enable-local-api. |
ping | Executar ping. |
Collection
Comandos de inspeção e seleção de coleções.
| Comando | Descrição |
|---|---|
list | Executar list. |
find | Executar find. |
tree | Executar tree. |
get | Executar get. |
items | Executar items. |
use-selected | Executar use-selected. |
create | Executar create. |
Item
Comandos de inspeção e renderização de itens.
| Comando | Descrição |
|---|---|
list | Executar list. |
find | Executar find. |
get | Executar get. |
children | Executar children. |
notes | Executar notes. |
attachments | Executar attachments. |
file | Executar file. |
export | Executar export. |
citation | Executar citation. |
bibliography | Executar bibliography. |
context | Executar context. |
analyze | Executar analyze. |
add-to-collection | Executar add-to-collection. |
move-to-collection | Executar move-to-collection. |
Search
Comandos de inspeção de pesquisas salvas.
| Comando | Descrição |
|---|---|
list | Executar list. |
get | Executar get. |
items | Executar items. |
Tag
Comandos de inspeção de tags.
| Comando | Descrição |
|---|---|
list | Executar list. |
items | Executar items. |
Style
Comandos de inspeção de estilos CSL instalados.
| Comando | Descrição |
|---|---|
list | Executar list. |
Import
Comandos oficiais de importação e gravação do Zotero.
| Comando | Descrição |
|---|---|
file | Executar file. |
json | Executar json. |
Note
Ler e adicionar notas filhas.
| Comando | Descrição |
|---|---|
get | Executar get. |
add | Executar add. |
Session
Comandos de sessão e contexto do REPL.
| Comando | Descrição |
|---|---|
status | Executar status. |
use-library | Executar use-library. |
use-collection | Executar use-collection. |
use-item | Executar use-item. |
use-selected | Executar use-selected. |
clear-library | Executar clear-library. |
clear-collection | Executar clear-collection. |
clear-item | Executar clear-item. |
history | Executar history. |
Exemplos
Status de Execução
Inspecionar caminhos do Zotero e disponibilidade do backend.
cli-anything-zotero app status --json
Ler Coleção Selecionada
Persistir a coleção selecionada na GUI do Zotero.
cli-anything-zotero collection use-selected --json
Renderizar Citação
Renderizar uma citação usando a API Local do Zotero.
cli-anything-zotero item citation <item-key> --style apa --locale en-US --json
Adicionar Nota Filha
Criar uma nota filha sob um item existente do Zotero.
cli-anything-zotero note add <item-key> --text "Conclusão principal" --json
Montar Contexto para LLM
Montar contexto estruturado para análise por modelos downstream.
cli-anything-zotero item context <item-key> --include-notes --include-links --json
Versão
0.1.0