Google Finance

Google Finance — Data via API Interna sin Auth

Skill para extraer datos de Google Finance via su endpoint RPC interno batchexecute descubierto por reverse engineering — sin API key, sin autenticacion.

Cubre quote, OHLC historico (intraday 1-min / 5-min / daily / 6-meses), financials masivos, earnings, analyst recommendations con opinions individuales (Goldman, etc), descripcion empresa con address+employees, peers, news (con thumbnails), indices globales (Dow/S&P/NASDAQ/VIX/DAX/FTSE/Nikkei) y sectors heatmap.

⚠️ WARNINGS CRITICOS — LEER PRIMERO

Antes de usar este skill en cualquier escenario productivo, leer obligatoriamente references/LIMITATIONS_TROUBLESHOOTING.md.

TL;DR de los 4 warnings principales

1. 🚨 API NO oficial — Google puede renombrar RPCs, cambiar layouts, agregar auth o cerrar el endpoint sin aviso.
2. 🚨 Layouts SIN keys — Los responses son arrays posicionales. Si Google reordena campos, vas a leer mal sin error visible.
3. 🚨 Rate limiting muy agresivo — > 5 req/s puede bloquear tu IP por horas. Recomendado: sleep ≥ 0.5s entre requests.
4. 🚨 Sin warranty de continuidad — Si construis algo importante, tener fallback con otro provider (Yahoo Finance, TradingView, Finnhub).

Cuando NO usar este skill

• Trading en produccion con decisiones criticas (usar feeds oficiales).
• Aplicaciones publicas que sirvan los datos a usuarios.
• Volumen > 10k requests/dia (riesgo de bloqueo permanente de IP).
• Redistribuir los datos como propios (terminos de uso de Google).

Cuando SI usar este skill

• Investigacion personal y prototipos.
• Backtest con cache local.
• Analisis comparativo cruzado con otros providers.
• Casos donde los datos UNICOS de Google son criticos (intraday 1-min gratis, detalle individual de analyst opinions).

🚀 Quick start

bashCopy code
# Quote basico
py scripts/fetch_gfinance.py quote GGAL:NASDAQ
py scripts/fetch_gfinance.py quote AAPL:NASDAQ
py scripts/fetch_gfinance.py quote GGAL:BCBA       # mercado argentino

# Intraday del dia actual
py scripts/fetch_gfinance.py intraday-5min AAPL:NASDAQ
py scripts/fetch_gfinance.py intraday-1min GGAL:NASDAQ

# Daily historico
py scripts/fetch_gfinance.py daily-6m AAPL:NASDAQ

# Indices globales (Dow, S&P, NASDAQ, VIX, DAX, FTSE, Nikkei...)
py scripts/fetch_gfinance.py indices

# Analyst recommendations + opinions individuales
py scripts/fetch_gfinance.py analysts NVDA:NASDAQ

# Todo en uno (6 requests pipelinadas)
py scripts/fetch_gfinance.py all GGAL:NASDAQ

Estructura del skill

Copy code
skills/google-finance/
├── SKILL.md                                # Este archivo
├── references/                             # 5 documentos
│   ├── REFERENCE.md                        # Overview general + batchexecute
│   ├── RPC_IDS.md                          # Catalogo de los 14+ RPC IDs
│   ├── RESPONSE_FORMAT.md                  # Parser deep dive del wrb.fr protocol
│   ├── LIMITATIONS_TROUBLESHOOTING.md      # ⚠️ Warnings, plan B, debugging
│   └── COOKBOOK.md                         # 25 recetas listas
├── assets/                                 # 3 archivos JSON
│   ├── rpc_ids.json                        # Catalogo estructurado de RPCs + args
│   ├── chunk_layouts.json                  # Layouts posicionales de los arrays
│   └── consent_cookies.json                # Cookies de bypass del consent
└── scripts/
    └── fetch_gfinance.py                   # Script principal — 19 modos CLI

19 modos CLI disponibles

Por simbolo

Globales (sin simbolo)

Catalogos locales (sin HTTP)

Combinado

Formato de simbolos

El script tambien acepta el orden invertido (NASDAQ:GGAL) — auto-detecta cual es el exchange. Pero el formato canonical de Google es TICKER:EXCHANGE.

Diferenciales unicos vs otros skills del repo

Cuando usar Google Finance > TradingView

• Necesitas OHLC intraday 1-min sin pagar.
• Necesitas detalle individual de opinions por analista con firma/target/fecha.
• Necesitas el address fisico de una empresa argentina.
• Necesitas indices globales (Dow+S&P+NASDAQ+VIX+DAX+FTSE+Nikkei) en una sola call.

Cuando usar TradingView > Google Finance

• Necesitas screener masivo con filtros tipo SQL.
• Necesitas ISIN/CUSIP/CIK del simbolo (Symbol Search v3).
• Necesitas indicadores tecnicos pre-calculados (RSI/MACD/EMAs/pivots).
• Necesitas robustez — TV es mucho mas estable que Google Finance.

Consideraciones tecnicas

Endpoint

Copy code
POST https://www.google.com/finance/beta/_/FinHubUi/data/batchexecute?rpcids={RPC_ID}

Headers requeridos

Ya configurados en el script:

pythonCopy code
HEADERS = {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
    "X-Same-Domain": "1",           # CRITICO
    "Origin": "https://www.google.com",
    "Referer": "https://www.google.com/finance/...",
}

Cookies de bypass

El script las pasa automaticamente:

pythonCopy code
COOKIES = {
    "CONSENT": "PENDING+999",
    "SOCS": "CAESHAgBEhJnd3NfMjAyNTAxMjMtMF9SQzMaAmVuIAEaBgiAvLW8Bg",
}

Si dejan de funcionar, ver LIMITATIONS_TROUBLESHOOTING.md seccion 6 para capturar cookies frescas.

Response format (wrb.fr)

Los responses usan el protocolo wrb.fr de Google (XSSI prefix + JSON serializado doble). El script tiene un parse_wrbfr() que lo maneja. Detalles en RESPONSE_FORMAT.md.

Rate limiting

⚠️ Aggressive. Recomendado:

• Sleep ≥ 0.5s entre requests.
• < 1k requests/dia para no triggear bloqueo IP.
• NO usar desde CI sin precauciones (cloud IPs en blacklist).

Output

• Por defecto: JSON al stdout.
• -o archivo.json: guarda a archivo (UTF-8, ensure_ascii=False).
• -q: modo silencioso (sin logs INFO).
• --raw: retorna response raw sin extraer del array wrb.fr.

Manejo de errores

El script captura requests.HTTPError y muestra el body para debugging. Si el endpoint deja de funcionar, te apunta a LIMITATIONS_TROUBLESHOOTING.md.

Casos comunes — recetas rapidas

25 recetas completas en COOKBOOK.md.

bashCopy code
# Quote rapido
py scripts/fetch_gfinance.py quote GGAL:NASDAQ -q

# Stock argentino BCBA
py scripts/fetch_gfinance.py quote GGAL:BCBA -q

# Indices globales del dia
py scripts/fetch_gfinance.py indices -q

# Intraday 5-min con OHLC completo
py scripts/fetch_gfinance.py intraday-5min AAPL:NASDAQ -o aapl_5min.json

# Daily ultimos 6 meses
py scripts/fetch_gfinance.py daily-6m AAPL:NASDAQ -o aapl_6m.json

# Analyst recommendations + opinions individuales
py scripts/fetch_gfinance.py analysts NVDA:NASDAQ -q

# Comparar empresa con peers
py scripts/fetch_gfinance.py peers GGAL:NASDAQ --peers-count 5 -q

# Todo-en-uno (snapshot completo)
py scripts/fetch_gfinance.py all GGAL:NASDAQ -o ggal_complete.json

Documentacion completa

Inspiracion y atribuciones

Este skill fue construido a partir de research del HTML de google.com/finance/beta/quote/GGAL:NASDAQ, identificando los chunks AF_initDataCallback con su sistema "Wiz" (mismo que usa Search, Maps, Translate). El protocolo wrb.fr es publico y bien documentado por la comunidad (no por Google).

Implementaciones similares en otros lenguajes:

• google-finance-quotes (Node.js) — usa el mismo endpoint
• mfinance (Python, distinto enfoque)
• Multiples proyectos OSS de scraping de finance.google.com

Este skill se distingue por:

1. 24 modos CLI sobre 14+ RPC IDs distintos.
2. Documentacion exhaustiva de los warnings y plan B.
3. Catalogo estructurado de RPCs + layouts posicionales en assets.
4. Parser robusto del wrb.fr con manejo de todos los edge cases.