Simplywallst

SimplyWallSt — Stock Research & Snowflake Scores

Extrae datos financieros de SimplyWallSt usando su API REST interna (simplywall.st/api/...). Sin Cloudflare, sin API key, sin registro.

120,000+ stocks globales con snowflake scores (value, income, health, past, future, management), análisis de valuación, dividendos históricos y proyectados, score de salud financiera, insider transactions, y más.

⚠️ Aviso Legal

• SimplyWallSt no tiene API pública oficial. Esta skill usa endpoints internos del frontend web.
• Respetá los términos de servicio del sitio.
• Implementá rate limiting (mín 300ms entre requests).

Instalación

bashCopy code
pip install requests

Scripts

Uso rápido

bashCopy code
# PRIMERO: Descargar snapshot de tickers (1 vez sola, ~5 min)
python scripts/fetch_sws.py --download-snapshot

# Luego: las búsquedas por ticker usan el snapshot → instantáneas
python scripts/fetch_sws.py --ticker GGAL

# Buscar por nombre
python scripts/fetch_sws.py --search "Galicia"

# Full data con todos los includes (info, score, analysis, extended, raw_data, insider)
python scripts/fetch_sws.py --ticker GGAL --full

# Listar empresas (grid)
python scripts/fetch_sws.py --grid --size 10

# Listar solo tickers disponibles (Argentina)
python scripts/fetch_sws.py --list-tickers --country AR --output tickers_ar.csv

# Snowflake scores de múltiples tickers
python scripts/fetch_sws.py --ticker GGAL,BMA,SUPV --score

# Output a archivo
python scripts/fetch_sws.py --ticker GGAL --full --output ggal_data.json

Endpoints descubiertos

Includes disponibles para Company Detail

Cobertura

Flags del script

Ejemplos por tipo de data

Snowflake Scores

bashCopy code
python scripts/fetch_sws.py --ticker GGAL --score
# → value=0, income=0, health=4, past=1, future=5, management=0
# → "High growth potential with adequate balance sheet."

Info Corporativa

bashCopy code
python scripts/fetch_sws.py --ticker GGAL --info
# → name, industry (Banks), country (AR), employees (10032), year_founded (1905)

Análisis + Dividendos

bashCopy code
python scripts/fetch_sws.py --ticker GGAL --analysis --extended
# → P/E, P/B, ROE, ROA, EPS, Debt/Equity, market cap
# → dividend history, payout ratios, future yield

Todos los datos

bashCopy code
python scripts/fetch_sws.py --ticker GGAL --full

Trabajar con el grid/filter

El grid/filter devuelve companies listas para consumir con info + scores + grid metrics en un solo request. Ideal para screener:

bashCopy code
# Todas las empresas (default: market cap desc)
python scripts/fetch_sws.py --grid --limit 50

# Top 10 Argentina
python scripts/fetch_sws.py --grid --size 10

Nota: El grid/filter no permite filtros por país o ticker directamente. Usar --list-tickers + --country para filtrar client-side.

Snapshot de tickers (recomendado)

El snapshot es un archivo CSV local con todos los listings disponibles que permite resolver tickers al instante sin iterar el grid.

Descargar el snapshot (1 vez, ~10 min)

bashCopy code
# Descarga completa (~10 min, genera assets/YY-MM-DD-ticker-snapshot.csv)
python scripts/fetch_sws.py --download-snapshot

Cómo funciona el snapshot completo

El API tiene un límite de 10,000 registros por query. Para obtener todos, el script usa particionado por exchange:

1. Fase 1: Obtiene top 10K con la query default → extrae los exchanges disponibles
2. Fase 2: Para cada exchange, fetchea todas las empresas (cada exchange tiene < 10K registros)
3. Dedup: Combina todo y elimina duplicados por unique_symbol (exchange + ticker)

Resultados del snapshot 26-06-04

¿Por qué 78K y no 54K? El API reporta total_records=54,530 para la query default (que filtra por scores mínimos). Pero al particionar por exchange con reglas más simples (exchange_symbol=X + primary_flag=true), se obtienen muchos más — ETFs, fondos, companies sin scores, y ADRs. Las 54K son solo las que cumplen los filtros default.

Verificación de calidad de datos

Sin snapshot

Sin snapshot, --ticker GGAL tarda ~30s iterando el grid. Con snapshot, es instantáneo.

Formato del snapshot

Snapshot específico

bashCopy code
python scripts/fetch_sws.py --snapshot assets/26-06-04-ticker-snapshot.csv --ticker GGAL

Mapa Exchange → País

El mapping completo de los 106 exchanges está en references/REFERENCE.md.

Estructura del skill

Copy code
skills/simplywallst/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa de endpoints y data
├── scripts/
│   └── fetch_sws.py                      # Script principal
└── assets/
    └── YY-MM-DD-ticker-snapshot.csv      # Snapshot de tickers (generado)

📖 Documentación detallada: Consultá references/REFERENCE.md para la documentación exhaustiva con ejemplos de respuesta, campos, y consideraciones técnicas.