morningstar

Name: morningstar
Author: gauss314

github.com/gauss314Data & databases252254 installsUpdated 20w ago

About morningstar

morningstar is a skill for retrieving global equity data through a JSON endpoint used by Morningstar’s screener. It serves users who need to search, screen, and export securities by market, country, or field; the endpoint is unofficial.

Key features

01Search stocks by name
02Screen or download data across markets
03Select available data fields
04Export results as JSON or CSV
05Inspect field and market-code references

Use cases

01Find stocks in a selected market
02Export security listings across markets
03Screen stocks by valuation or return fields
04Create CSV files for further analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gauss314/skills --skill morningstar

After installing, type/morningstarin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/

DATA_POINTS.md

UNIVERSES.md

references/

REFERENCE.md

scripts/

fetch_morningstar.py

Details

From the project README

Morningstar — Screener via API JSON

Skill para descargar la base de datos de acciones globales de Morningstar 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	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.

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, PEGRatio, DividendYield
Calidad (7): DebtEquityRatio, NetMargin, EBTMarginYear1, ROATTM, ROETTM, ROEYear1, ROICYear1
Crecimiento (2): EPSGrowth3YYear1, RevenueGrowth3Y
Retornos (9): ReturnD1, ReturnW1, ReturnM0, ReturnM1, ReturnM3, ReturnM6, ReturnM12, ReturnM36, ReturnM60, ReturnM120

Ver assets/DATA_POINTS.md para detalles.

Ejemplos de output

`search Apple --universe XNAS` (1 resultado)

{
  "_meta": {
    "query": "Apple",
    "universe_count": 1,
    "total_results": 1
  },
  "results": [
    {
      "Ticker": "AAPL",
      "PerformanceId": "0P000000GY",
      "Name": "Apple Inc",
      "ClosePrice": 311.23,
      "MarketCap": 4571145807880,
      "MarketCountryName": "United States",
      "SectorName": "Technology",
      "IndustryName": "Consumer Electronics",
      "_universe_code": "XNAS",
      "_universe_name": "Nasdaq"
    }
  ]
}

`screener --universe XBUE -o ar.csv` (469 filas)

_universe_code,Ticker,Name,PerformanceId,Universe,ClosePrice,MarketCap,SectorName,IndustryName,EquityStyleBox,...
XBUE,MMM,3M Co Cedear,0P0000D5UB,E0EXG$XBUE,23100,Industrials,Conglomerates,4,...
XBUE,A3,A3 Mercados SA Ordinary Shares,0P0000WJD7,E0EXG$XBUE,2215,Financial Services,Financial Data & Stock Exchanges,,...
XBUE,YPFD,YPF SA Class D,0P0000BS4D,E0EXG$XBUE,83850,Energy,Oil & Gas Integrated,9,...

`search YPF --universe XBUE` (4 resultados)

{
  "_meta": {"query": "YPF", "universe_count": 1, "total_results": 4},
  "results": [
    {"Ticker": "YPFD",   "PerformanceId": "0P0000BS4D", "Name": "YPF SA Class D",        "ClosePrice": 83850, "SectorName": "Energy", "IndustryName": "Oil & Gas Integrated", "_universe_code": "XBUE"},
    {"Ticker": "YPFD1",  "PerformanceId": "0P0001NX4I", "Name": "YPF SA Class D Cedear", ...},
    {"Ticker": "YPF",    "PerformanceId": "...",          "Name": "YPF SA",                ...},
    ...
  ]
}

Consideraciones tecnicas

Token universal

El mismo token klr5zyak8x funciona en 5 sub-dominios de tools.morningstar.*:

Dominio	Idioma default
`tools.morningstar.co.uk`	English (UK)
`tools.morningstar.de`	German
`tools.morningstar.fr`	French
`tools.morningstar.it`	Italian
`tools.morningstar.es`	Spanish

Todos devuelven la misma data. El script prueba los 5 hasta que uno responda 200.

NO funciona en: tools.morningstar.com (US), .com.au, .br, .jp, etc. (geofencing, IP blocking o no existe el endpoint).

Encoding

El API devuelve nombres de sectores/industrias en el idioma del languageId (es-AR, de-DE, etc.). PROBLEMA: los caracteres acentuados vienen mal-encodados (Energ�a en vez de Energía).

Solucion del script: usar languageId=en-GB para todos los universes. Los nombres de empresas (Apple, YPF, etc.) se mantienen, solo los nombres de sectores/industrias se devuelven en inglés (que es el estándar para screener cuantitativo).

Rate limit

No hay rate limit agresivo observado. Sin embargo:

Hacer 50+ requests en pocos segundos puede triggerear throttling del CDN
El script espera 0.5-1 segundo entre universes (configurable en get())
Sin reintentos agresivos

PerformanceId

Cada listing (instrumento en un exchange especifico) tiene un PerformanceId unico. El mismo "Apple Inc" tiene:

0P000000GY en NASDAQ (XNAS)
0P0000EEDJ en XFRA (Frankfurt)
0P0000VE8R en BVMF (Brasil BDR)
0P0000TFNY en XBUE (CEDEAR Argentina)

El PerformanceId NO se transfiere entre exchanges. Es la unica clave estable para identificar un listing especifico.

Estructura del skill

skills/morningstar/
├── SKILL.md                          # Este archivo (guia rapida)
├── assets/
│   ├── UNIVERSES.md                  # Lista completa de 53 universes
│   └── DATA_POINTS.md                # Lista de 33 campos disponibles
├── references/
│   └── REFERENCE.md                  # Documentacion tecnica detallada
└── scripts/
    └── fetch_morningstar.py          # Script principal

Documentacion detallada: Consultar references/REFERENCE.md para la doc tecnica exhaustiva de endpoints, JSON schemas, ejemplos y troubleshooting.

Comments

Markdown supported

Details

Author: gauss314
Repository: gauss314/skills
Category: Data & databases
Installs: 254
GitHub stars: 252

Report

More skills

All skills

hyperframes-core

github.com/heygen-com

930.6k

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

lark-base

open.feishu.cn

823.2k

Operate on Feishu Base: create tables, fields, records, and views; handle statistics, formulas/lookups, forms, dashboards, app mode (BaseApp/AppMode pages and components), Workspace directories, workflows, role permissions, and the template center (Base template categories, lists, and search). Use when encountering Base/multidimensional tables/bitable, BaseApp/AppMode, or /base/ or /app/ links. Do not use lark-apps for BaseApp; route file import/export to lark-drive and authentication/authorization to lark-shared.

lark-sheets

open.feishu.cn

821.8k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.

remotion-best-practices

github.com/remotion-dev

701.4k

Best practices and domain knowledge for building videos programmatically with Remotion (videos in React/TypeScript, rendered to MP4). Use whenever writing or editing Remotion code — scaffolding a video project, animating with interpolate/spring over useCurrentFrame(), sequencing scenes and transitions, captions/subtitles, audio, GIFs/Lottie/3D, charts, visual effects, dynamic duration via calculateMetadata, or rendering. Consult before reaching for a Remotion API, since its components and props evolve (e.g. @remotion/media).

morningstar

About morningstar

Key features

Use cases

Install

Bundled files

Details

Morningstar — Screener via API JSON

⚠️ Aviso Legal

Scripts

Instalacion de dependencias

Uso rapido

Modos disponibles

Flags

Cobertura

Top 10 universes

Argentina

Brasil

Mexico

Campos (33 en total)

Ejemplos de output

search Apple --universe XNAS (1 resultado)

screener --universe XBUE -o ar.csv (469 filas)

search YPF --universe XBUE (4 resultados)

Consideraciones tecnicas

Token universal

Encoding

Rate limit

PerformanceId

Estructura del skill

Comments

`search Apple --universe XNAS` (1 resultado)

`screener --universe XBUE -o ar.csv` (469 filas)

`search YPF --universe XBUE` (4 resultados)