/morningstar

name: morningstar
description: "Morningstar Screener via API JSON publica: descarga masiva de 53 universes (102K+ listings, 39 paises, NYSE/Nasdaq/BCBA/etc) con 33 campos (precio, market cap, ratios, retornos 1d/1w/1m/3m/6m/12m/36m/60m/120m, deuda, dividend yield, sector, industria). Sin API key, sin auth."
license: MIT

Morningstar — Screener via API JSON

Skill para descargar la base de datos de acciones globales de [Morningstar](https://www.morningstar.com) usando un endpoint JSON interno descubierto por ingenieria inversa. Sin API key, sin autenticacion, sin rate limit agresivo.

---

⚠️ Aviso Legal

• Este endpoint **no es oficial** — fue descubierto interceptando el trafico XHR de la UI web del screener de Morningstar.
• Los datos provienen del sitio publico de Morningstar. Respetar los **terminos de servicio** del sitio.
• **Solo el endpoint `/security/screener` es accesible** sin auth. Otros endpoints de Morningstar (api-global, global, lt, etc.) requieren resolver AWS WAF challenge (no soportado por este skill).
• Para uso intensivo, respetar pausas de 0.5-1 segundo entre requests.

---

Scripts

| Script | Descripcion | |--------|-------------| | **[fetch_morningstar.py](./scripts/fetch_morningstar.py)** | Script principal: info, fields, search, screener, download |

---

Instalacion de dependencias

pip install requests

> Solo `requests` puro, sin dependencias extras.

---

Uso rapido

# === INFO ===
python scripts/fetch_morningstar.py info       # Stats del skill
python scripts/fetch_morningstar.py fields     # 33 campos disponibles

# === BUSCAR TICKERS (por nombre, multi-universe) ===
python scripts/fetch_morningstar.py search Apple --universe XNAS
python scripts/fetch_morningstar.py search Apple --universe XNAS XFRA XBUE
python scripts/fetch_morningstar.py search YPF --universe XBUE
python scripts/fetch_morningstar.py search "MercadoLibre" --universe XNAS BVMF

# === DESCARGA MASIVA (screener) ===
python scripts/fetch_morningstar.py screener --universe XNAS
python scripts/fetch_morningstar.py screener --universe XBUE
python scripts/fetch_morningstar.py screener --universe XNAS XLON XTKS

# === DESCARGA POR PAIS ===
python scripts/fetch_morningstar.py screener --country AR
python scripts/fetch_morningstar.py screener --country US
python scripts/fetch_morningstar.py screener --country DE

# === DESCARGA COMPLETA (53 universes, 100K+ listings) ===
python scripts/fetch_morningstar.py screener --all

# === GUARDAR A ARCHIVO ===
python scripts/fetch_morningstar.py screener --universe XBUE -o argentina.json
python scripts/fetch_morningstar.py screener --universe XNAS -o nasdaq.csv
python scripts/fetch_morningstar.py screener --country AR -o ar.csv
python scripts/fetch_morningstar.py search "YPF" --universe XBUE -o ypf_results.json

# === DOWNLOAD (alias de screener) ===
python scripts/fetch_morningstar.py download --universe XBUE -o ar.csv

# === MODO SILENCIOSO (solo JSON, sin logs) ===
python scripts/fetch_morningstar.py search Apple --universe XNAS -q
python scripts/fetch_morningstar.py screener --universe XBUE -q -o ar.json

# === CAMPOS ESPECIFICOS (--fields) ===
python scripts/fetch_morningstar.py screener --universe XNAS --fields Ticker Name ClosePrice MarketCap PERatio

---

Modos disponibles

| Modo | Descripcion | Ejemplo | |------|-------------|---------| | `info` | Stats del skill, dominios, token, #universes, #campos | `python fetch_morningstar.py info` | | `fields` | Lista los 33 securityDataPoints disponibles con descripcion | `python fetch_morningstar.py fields` | | `search` | Buscar tickers por nombre en uno o varios universes | `python fetch_morningstar.py search Apple --universe XNAS` | | `screener` | Descarga masiva de uno o varios universes (toda la DB) | `python fetch_morningstar.py screener --universe XNAS` | | `download` | Alias de `screener` | `python fetch_morningstar.py download --universe XNAS` |

Flags

| Flag | Descripcion | Ejemplo | |------|-------------|---------| | `--universe XNAS` | Uno o varios universe codes (sin prefijo `E0EXG$`) | `--universe XNAS XBUE` | | `--country AR` | Codigos de pais ISO (39 paises soportados) | `--country AR US DE` | | `--all` | Todos los 53 universes (~100K listings, demora ~1-2 min) | `--all` | | `--fields Ticker Name` | Sub-set de campos (default: los 33) | `--fields Ticker Name ClosePrice` | | `--output archivo.json` | Guardar a JSON | `-o data.json` | | `--output archivo.csv` | Guardar a CSV (flat) | `-o data.csv` | | `-q` / `--quiet` | Solo JSON, sin logs | `-q` |

---

Cobertura

**53 universes, 102,093 listings, 39 paises** — ver [assets/UNIVERSES.md](./assets/UNIVERSES.md).

Top 10 universes

| Universe | Exchange | Pais | Listings | |----------|----------|------|----------| | `XFRA` | Frankfurt (Tradegate) | Germany | 14,082 | | `XSTU` | Stuttgart | Germany | 9,971 | | `XMUN` | Munich | Germany | 8,425 | | `XDUS` | Dusseldorf | Germany | 8,297 | | `XBOM` | Bombay (BSE) | India | 5,192 | | `XTKS` | Tokyo | Japan | 3,989 | | `XNAS` | Nasdaq | United States | 3,741 | | `XNSE` | NSE India | India | 3,018 | | `XSHE` | Shenzhen | China | 2,934 | | `XKRX` | Korea Exchange | South Korea | 2,877 |

Argentina

`XBUE` (BCBA) → **469 CEDEARs** (certificados de deposito de acciones extranjeras) con precios en ARS.

python fetch_morningstar.py screener --universe XBUE -o ar.csv

> Cada CEDEAR tiene un `PerformanceId` distinto del ADR original. Ej: Apple Inc CEDEAR (`0P0000TFNY`) ≠ Apple Inc NASDAQ (`0P000000GY`).

Brasil

`BVMF` (B3) → **2,070 BDRs/acciones** en BRL.

Mexico

`XMEX` (BMV) → **2,233 acciones** en MXN.

---

Campos (33 en total)

**5 metadata:** `Ticker`, `Name`, `PerformanceId`, `Universe`, `MarketCountryName`

**5 categoricos:** `SectorName`, `IndustryName`, `EquityStyleBox` (1-9), `QuantitativeStarRating` (1-5)

**23 numericos:**

• **Precio/tamano (2):** `ClosePrice`, `MarketCap`
• **Valuacion (3):** `PERatio`, `PEGR