Saltar a contenido

Cómo integrar Zotero

Zotero es el puente entre tu curaduría humana y el stack: vos guardás papers manualmente, el stack los usa como fuente prioritaria. Esta guía resuelve el setup y el uso diario.

Principio Codina (UPF)

El humano cura, la IA ejecuta. Cuando corrés find_top_sources --prefer-zotero, el stack prioriza TU biblioteca sobre APIs externas.

Setup inicial (una sola vez)

1. Crear cuenta y API key

  • Cuenta: zotero.org/user/register (free tier: 300 MB).
  • API key: zotero.org/settings/keys → Create new private key.
  • Allow library access ✓
  • Allow write access ✓ (para agregar desde DOI)
  • User ID: en la misma página dice "Your userID for use in API calls is XXXXXXX" (7-8 dígitos).

2. Agregar credenciales al .env

ZOTERO_API_KEY=tu_key_aca
ZOTERO_USER_ID=tu_numero_aca

Nunca en .env.example

El .env.example es público. Sin comentarios inline — van con # en líneas separadas.

3. Verificar conexión

python tools/zotero_sync.py --list

Items: 0 es normal si recién creaste la cuenta.

Uso diario

Guardar mientras leés

Instalá el Zotero Connector (Chrome/Firefox/Edge/Safari). Un click guarda metadata completa + PDF. Compatible con Google Scholar, ScienceDirect, Springer, IEEE Xplore, arXiv, PubMed y más.

Comandos de referencia rápida

Comando Qué hace
zotero_sync.py --list Listar items de la biblioteca
zotero_sync.py --export FILE.bib Exportar a BibTeX
zotero_sync.py --search "query" Buscar en la biblioteca
zotero_sync.py --add-doi DOI Agregar paper desde DOI
zotero_sync.py --sync Sync bidireccional (en conflicto, Zotero gana)
find_top_sources.py --prefer-zotero Priorizar biblioteca en el ranking

Priorizar Zotero en la búsqueda

python tools/find_top_sources.py --claim "SHM digital twin" --prefer-zotero

Flujo: busca primero en TU biblioteca; si hay match con sim ≥ 0.4 → usa esa fuente con score 1.0; si no, cae al flujo normal (OpenAlex + Scopus + Semantic Scholar + CrossRef).

Troubleshooting

HTTP 403 al correr --list

API key inválida o sin permisos de lectura. Verificá "Allow library access" en settings/keys.

--add-doi falla con 403

La key no tiene Allow write access. Editá la key y marcalo.

Items: 0 aunque subí papers

Cache de Zotero (TTL 1h). Forzá refresh: rm -rf .cache/zotero/ && python tools/zotero_sync.py --list.

Better BibTeX (nivel pro)

Para uso profesional, instalá el plugin Better BibTeX: citation keys estables (autor_año), export automático en tiempo real, integración con LaTeX.

Ver también

Fuente canónica

Deriva de docs/shared/ZOTERO_GUIDE.md.