/cafci

name: cafci
description: "Datos de fondos comunes de inversion argentinos via CAFCI (Camara Argentina de Fondos Comunes de Inversion). Combina catalogo JSON (1152 fondos, 4615 clases, fees, IDs, metadata), snapshot diario XLSX (VCP, patrimonio, market share, variaciones), ficha individual markdown (rendimientos TNA por periodo) y composicion de cartera (top activos). Sin API key."
license: MIT

CAFCI — Fondos Comunes de Inversion Argentinos

Skill para consultar informacion publica de **fondos comunes de inversion en Argentina** via las 4 fuentes oficiales de [CAFCI](https://www.cafci.org.ar) (Camara Argentina de Fondos Comunes de Inversion).

Cubre **1152 fondos** y **4615 clases** activas al 2026-06: Money Market, Renta Fija, Renta Variable, Renta Mixta, PyMes, Retorno Total, Infraestructura, Fondos Cerrados, ASG, RG900.

---

⚠️ Aviso Legal

• API publica sin documentacion oficial. **Los endpoints pueden cambiar sin aviso** (como paso con la API REST anterior, discontinuada en 2026-04).
• Respetar terminos de uso del CAFCI.
• Los datos son **delayed** (cierre del dia habil, ~18hs ART).
• Para uso comercial intensivo, contactar al CAFCI para feeds oficiales.
• **Rendimientos pasados no garantizan rendimientos futuros.**

---

📌 Importante: API REST anterior DISCONTINUADA

La API REST `api.pub.cafci.org.ar/tipo-renta`, `/fondo/{id}`, `/estadisticas/...` fue **discontinuada en 2026-04** (HTTP 403 "Route not allowed"). El unico path que sigue activo en ese host es `/pb_get`.

Esta skill usa las **4 fuentes alternativas** que la reemplazaron:

1. `/consulta-de-fondos.json` (catalogo completo) 2. `/pb_get` (XLSX diario) 3. `defuddle.md/.../fondos/{F}?clase={C}` (ficha markdown) 4. `.../fondos/{F}?clase={C}` (HTML para composicion de cartera)

---

Scripts

| Script | Descripcion | |--------|-------------| | **[fetch_cafci.py](./scripts/fetch_cafci.py)** | Script principal: todos los endpoints + funciones de consulta |

**Requiere:** `pip install openpyxl` (para parsear el XLSX diario).

---

Uso rapido

# ── DATASETS ENTEROS (con cache local diario) ──────────────────────────

# Catalogo completo: 1152 fondos, 4615 clases con IDs, honorarios, metadata
py scripts/fetch_cafci.py catalogo
py scripts/fetch_cafci.py catalogo -o catalogo.json    # guarda 2.7MB
py scripts/fetch_cafci.py catalogo --no-cache          # fuerza refetch

# Snapshot diario: VCP, patrimonio, variaciones (dia/mes/YTD/12m)
py scripts/fetch_cafci.py diario
py scripts/fetch_cafci.py diario -o diario.json
py scripts/fetch_cafci.py diario --no-cache

# ── CONSULTAS SOBRE EL CACHE ───────────────────────────────────────────

# Buscar fondo por nombre (parcial, case-insensitive)
py scripts/fetch_cafci.py buscar "ahorro"
py scripts/fetch_cafci.py buscar "delta"
py scripts/fetch_cafci.py buscar "renta fija"

# Resolver IDs (mas compacto: solo fondo_id, clase_id, nombres)
py scripts/fetch_cafci.py resolve "ieb estrategico"
py scripts/fetch_cafci.py resolve "1810"

# Top N por patrimonio en una categoria del diario
py scripts/fetch_cafci.py top "Mercado de Dinero Peso Argentina"
py scripts/fetch_cafci.py top "Mercado de Dinero Peso Argentina" --limit 20
py scripts/fetch_cafci.py top "Renta Variable Peso Argentina"
py scripts/fetch_cafci.py top "Renta Fija Peso Argentina" --limit 5

# ── FICHAS INDIVIDUALES ────────────────────────────────────────────────

# Ficha markdown (rendimientos TNA: 7d/1m/90d/180d/YTD/12m + datos del fondo)
py scripts/fetch_cafci.py ficha 304 308              # 1810 Ahorro
py scripts/fetch_cafci.py ficha 1717 5772            # otro fondo
py scripts/fetch_cafci.py ficha 304 308 -o ficha.md  # guarda markdown

# Composicion de cartera (top activos + porcentaje)
py scripts/fetch_cafci.py cartera 304 308
py scripts/fetch_cafci.py cartera 1717 5772

# Ficha COMPLETA todo-en-uno (combina catalogo + diario + ficha + cartera)
py scripts/fetch_cafci.py fondo 304 308
py scripts/fetch_cafci.py fondo 304 308 -o 1810_ahorro_completo.json

# ── COMBINADO ──────────────────────────────────────────────────────────

# Catalogo + diario juntos (sin fichas individuales)
py scripts/fetch_cafci.py all -o cafci_snapshot.json

# ── OUTPUT ─────────────────────────────────────────────────────────────

# Modo silencioso (solo JSON/markdown, sin logs)
py scripts/fetch_cafci.py top "Mercado de Dinero Peso Argentina" -q

---

Endpoints disponibles

| Modo | Data | URL | |------|------|-----| | `catalogo` | Catalogo: 1152 fondos, 4615 clases, IDs, honorarios, metadata | `GET /consulta-de-fondos.json` | | `diario` | Snapshot diario: VCP, patrimonio, market share, variaciones | `GET /pb_get` (XLSX) | | `ficha FONDO CLASE` | Ficha markdown: rendimientos TNA por periodo | `GET defuddle.md/.../fondos/{F}?clase={C}` | | `cartera FONDO CLASE` | Composicion de cartera (top activos + %) | `GET .../fondos/{F}?clase={C}` (HTML) | | `buscar QUERY` | Buscar fondos por nombre parcial | (local, sobre catalogo) | | `resolve QUERY` | Resolver fondoId/claseId desde nombre | (local, sobre catalogo) | | `top CATEGORIA` | Top N por patrimonio en una categoria | (local, sobre diario) | | `fondo FONDO CLASE` | Ficha completa todo-en-uno (combina los 4 endpoints) | (local + 4 requests) | | `all` | Snapshot catalogo + diario | (local + 2 requests) |

**Total: 4 endpoints HTTP + 5 funciones de consulta sobre cache.**

---

Cache local

Los datasets pesados (catalogo + diario) se cachean **una vez por dia** en el directorio temporal del sistema:

$TMP/cafci-catalog-YYYY-MM-DD.json    (~2.7 MB)
$TMP/cafci-daily-YYYY-MM-DD.json      (~1-2 MB)

• Windows: `C:\Users\<user>\AppData\Local\Temp\`
• Linux/Mac: `/tmp/`

Si vas a hacer multiples consultas en el dia (typical workflow), reusan el cache automaticamente. Forzar refetch con `--no-cache`.

---

Tipos de renta soportados

| Tipo | Cantidad fondos | |------|-----------------| | Renta Fija | 542 | | Renta Mixta | 271 | | Mercado de Dinero | 96 | | Renta Variable |