APIs académicas integradas¶
El pipeline Belico se apoya en un conjunto de APIs bibliográficas para búsqueda de papers, resolución de DOI, verificación de citas y acceso open access. Esta tabla refleja el estado real de integración (FASE D — v3.1.0).
Estado de integración¶
| API | Estado | Uso |
|---|---|---|
| OpenAlex | ✅ Activo (smoke test PASS) | Búsqueda de papers + metadata + citaciones |
| CrossRef | ✅ Activo (smoke test PASS) | DOI resolution + metadata |
| ArXiv | ✅ Activo | Preprints CS / Physics / Math |
| PubMed | ✅ Activo | Papers biomédicos |
| DOAJ | ✅ Activo | Open access journals |
| Semantic Scholar | 🟡 Configurable | Búsqueda complementaria |
| SciELO | 🟡 Planificado FASE F | Corpus LATAM |
| Unpaywall | 🟡 Planificado FASE F | Acceso gratuito a papers |
| ORCID | 🟡 Planificado FASE F | Author profiles |
ArXiv siempre HTTPS
Las URLs de ArXiv deben usar https:// (nunca http://) — es una RED LINE
del ecosistema. Ver Reglas y RED LINES.
API keys¶
Las dos APIs activas por defecto (OpenAlex + CrossRef) son gratuitas y no requieren key obligatoria, pero conviene declarar una key heredada para subir el rate limit del "polite pool" de OpenAlex.
# .env
OPENALEX_API_KEY=... # openalex.org (gratis, default heredada)
SEMANTIC_SCHOLAR_API_KEY=... # semanticscholar.org (gratis)
ANTHROPIC_API_KEY=... # Anthropic Console (para sub-agentes LLM)
Detalles de configuración en la guía API keys.
Verificar conectividad¶
El comando belico smoke-check corre los tests reales contra OpenAlex y
CrossRef y reporta latencia + status por API.
# Smoke test de las APIs reales (requiere red)
belico smoke-check
# Solo una API
belico smoke-check --apis openalex
# Output JSON para CI
belico smoke-check --json-output
Ver la Referencia de la CLI para todos los flags.
Dónde se consumen¶
| Tool | API(s) | Para qué |
|---|---|---|
find_top_sources.py |
OpenAlex, CrossRef, Semantic Scholar | Ranking de fuentes para una contribución |
check_novelty.py |
OpenAlex | Veredicto de originalidad (ORIGINAL / INCREMENTAL / DUPLICATE) |
style_calibration.py |
OpenAlex | Descarga papers reales del venue destino para el Style Card |
verify_citations.py |
CrossRef | Resolución de DOI + watch de retracciones |
literature_rag.py |
OpenAlex, ArXiv, PubMed | Corpus para el RAG de literatura |
Para el detalle de flags de cada tool ver la API Python.