Conectando o sumno ao Zotero — plugin open-source

TL;DR

O sumno-zotero é um plugin open-source que sincroniza, de uma direção só, a sua biblioteca do sumno para o Zotero 7+. Você gera um token em /conta/tokens, cola no plugin, e os papers que salvou no sumno aparecem como itens da sua coleção Zotero — com título, autores, ano, DOI, abstract e link de Open Access. Sem mais "copia e cola do BibTeX".

Repositório: github.com/sumno-app/sumno-zotero · Licença MIT.

Por que existe

Se você é pós-graduando no Brasil e usa Zotero para organizar bibliografia, provavelmente o seu fluxo hoje é mais ou menos assim:

1. Procura paper no Google Scholar ou Periódicos CAPES.
2. Tenta importar via DOI ou pelo conector do navegador.
3. Salva no Zotero, e às vezes os metadados vêm bagunçados — autor com inicial errada, nome do periódico em caixa alta, ano faltando.
4. Cita com plugin do Zotero ou exporta BibTeX no fim do mês.

O sumno cobre os passos 1 e 2 — busca em OpenAlex com filtros sensíveis a PT-BR, abstract resumido sob demanda, biblioteca pessoal com cap saudável. Mas até esta semana, o jeito de mover a sua biblioteca do sumno pro Zotero era: ir em /biblioteca, clicar Exportar BibTeX, abrir o .bib no Zotero. Funciona, mas exige atenção, e perde com o tempo (se você adiciona dez papers no sumno, precisa lembrar de re-exportar).

O plugin troca isso por um clique. Você abre o Zotero, vai em Tools → Sumno → Sync library, e a coleção fica em dia com a sua biblioteca do sumno.

Como funciona, em três passos

Instalação no Zotero 7+:

1. Baixe o arquivo .xpi da última release no GitHub.
2. No Zotero, Tools → Plugins → engrenagem (canto superior direito) → Install Plugin From File → escolha o .xpi. Como alternativa, arraste o .xpi direto na janela do Zotero.
3. Reinicie o Zotero.

Configuração do token:

1. No sumno, autenticado, vá em sumno.com.br/conta/tokens.
2. Clique Gerar token, dê um nome (ex.: Zotero do notebook), escolha a validade.
3. Copie o valor que aparece — ele só é mostrado uma vez. Cole em algum gerenciador de senhas se quiser guardar.
4. No Zotero, Tools → Sumno: Configure token → cole o token.

Sincronização:

1. No Zotero, Tools → Sumno: Sync library.
2. O plugin chama a API pública do sumno com o token no header Authorization: Bearer, recebe a lista de papers da sua biblioteca, e cria os itens correspondentes em uma coleção chamada Sumno (criada automaticamente se não existir).
3. Cada item já vem com título, autores em ordem, ano, DOI, URL de Open Access (quando o paper é OA), e o openalex_id original guardado no campo Extra — útil pra rastrear.

Não é sincronização automática em segundo plano. Você dispara quando precisa. Foi uma escolha consciente — sync automático em fundo costuma surpreender mal e queimar requisições silenciosamente.

O que está fora do escopo na primeira versão

Honestidade primeiro:

• Sem bidirecional. Itens criados no Zotero não voltam para o sumno. Isso é planejado para uma v1.0 futura — não sem dado de demanda real.
• Sem sync de notas, tags ou anotações do Zotero. Apenas os metadados do paper.
• Sem suporte ao Zotero 6 (a estrutura de plugin mudou no Zotero 7; manter compatibilidade com a antiga não vale o custo).
• Sem login OAuth — usamos token pessoal (PAT). Mais simples para um plugin único.
• Sem garantia de suporte 24/7. Issues do GitHub recebem resposta best-effort. Releases minor seguem feedback real de uso.

Como pensamos a segurança

O plugin é cliente. Ele lê — não escreve em servidor do sumno. O caminho do dado é:

1. Você gera um token pessoal em /conta/tokens. O sumno guarda apenas o hash SHA-256 do token, nunca o valor.
2. O token fica no Zotero.Prefs do Zotero (não em arquivo plano).
3. Toda requisição vai em HTTPS para sumno.com.br com o token no header Authorization: Bearer.
4. Cada token tem rate limit independente de 60 requisições por minuto.
5. Você pode revogar qualquer token a qualquer momento em /conta/tokens — clientes usando aquele token perdem acesso imediatamente.
6. Tokens podem ter expiração (30 / 90 / 365 dias ou sem expiração).
7. O plugin não envia nenhum dado do seu Zotero para o sumno. Não mexe na sua biblioteca pessoal do Zotero fora da coleção Sumno.

Se você quiser ver o código exato que roda no seu Zotero: está tudo em github.com/sumno-app/sumno-zotero, licença MIT, ~300 linhas de JavaScript puro.

Roadmap aberto

Sem datas — vai dependendo de uso real:

• v0.2.x — sync incremental (só novos itens desde a última sync), múltiplas coleções por nome.
• v0.3.x — sync das suas notas no sumno (quando a feature de notas existir).
• v1.0 — bidirecional, se houver demanda real (Zotero → sumno).
• Outras integrações (Obsidian, Roam, Mendeley) — só com defesa escrita e tração comprovada.

Sugestões de feature: abra uma issue no GitHub com o contexto do seu uso. Mais útil que pedido genérico.

Próximo passo

Se você ainda não tem conta no sumno, crie uma agora — Free permite 10 buscas e 5 sumarizações por mês, suficiente pra testar o plugin com 5-10 papers da sua área. Depois você decide se vale o plano Pesquisador.

— Gustavo