Saltar a contenido

Cómo configurar las API keys

El pipeline consume varias APIs académicas y modelos LLM. Esta guía resuelve cómo obtener y configurar cada clave en el .env.

El archivo .env

Copiá el template y completá:

cp .env.example .env

Nunca commitees .env

Está en .gitignore. Sin comentarios inline — van con # en líneas separadas. Si una key se filtra, revocala y generá una nueva.

Claves del pipeline

Variable Para qué Dónde obtenerla Costo
ANTHROPIC_API_KEY Orquestador + sub-agentes Claude Anthropic Console $$$
OPENALEX_API_KEY Búsqueda de literatura openalex.org Gratis (free tier sin key)
SEMANTIC_SCHOLAR_API_KEY Style calibration semanticscholar.org/product/api Gratis (recomendado)
BELICO_API_EMAIL Polite pool (10x capacity) tu email Gratis
SUPABASE_URL + SERVICE_KEY reference_papers, patents supabase.com Opcional
ZOTERO_API_KEY + ZOTERO_USER_ID Biblioteca curada zotero.org/settings/keys Gratis
PEER_EMAIL + PEER_PASSWORD Ground motions sísmicos ngawest2.berkeley.edu Gratis

Claves mínimas

Para el pipeline básico solo necesitás:

OPENALEX_API_KEY=          # opcional — free tier funciona sin key
SEMANTIC_SCHOLAR_API_KEY=  # opcional pero recomendado
BELICO_API_EMAIL=tu_email@ejemplo.com  # eleva capacity en OpenAlex/SS

Polite pool

Setear BELICO_API_EMAIL hace que OpenAlex y Semantic Scholar reconozcan al cliente y eleven la capacity 10x. Es gratis y muy recomendado. Ver Cache y rate limiter.

Verificar que funcionan

belico smoke-check            # chequeo de APIs reales
belico smoke-check --apis openalex,crossref   # subset específico
belico smoke-check --json-output              # para CI

APIs sin key

Varias APIs funcionan sin credenciales en free tier:

  • OpenAlex — free tier sin key (con BELICO_API_EMAIL para polite pool).
  • CrossRef — público, sin key.
  • Unpaywall — solo requiere email.

Ver el detalle de cada API en APIs académicas.

Ver también

Fuente canónica

Deriva de la sección §Instalación del README.md.