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

🚨 API NO oficial — Google puede renombrar RPCs, cambiar layouts, agregar auth o cerrar el endpoint sin aviso.
🚨 Layouts SIN keys — Los responses son arrays posicionales. Si Google reordena campos, vas a leer mal sin error visible.
🚨 Rate limiting muy agresivo — > 5 req/s puede bloquear tu IP por horas. Recomendado: sleep ≥ 0.5s entre requests.
🚨 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

bash

# 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

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

Modo	Data	RPC ID
`quote SYM`	Precio + change + currency + market hours	`gCvqoe`
`quote-full SYM`	Quote + industry + market cap + volume	`dlNq8b`
`description SYM`	Descripcion + address + employees + ratios + URLs	`JL8oKc`
`peers SYM`	Related stocks (default 4, controlable con `--peers-count` )	`SICF5d`
`analysts SYM`	Recommendations summary + opinions individuales	`YTM9q`
`earnings SYM`	Earnings history multi-period	`XxQsbd`
`technicals SYM`	Ratings tecnicos (similar a TradingView Recommend.*)	`gXxkFd`
`financials SYM`	Income + balance + cashflow ~22 KB multi-period	`Pr8h2e`
`intraday-1min SYM`	OHLC 1-min del dia actual (~30 KB)	`c2u4wc`
`intraday-5min SYM`	OHLC 5-min con OHLC completo (~5 KB)	`c2u4wc`
`daily SYM`	OHLC diario ultimo mes (~22 dias)	`c2u4wc`
`daily-6m SYM`	OHLC diario ultimos ~6 meses	`c2u4wc`
`news SYM`	News especificas del simbolo	`kA4MVd`
`news-related SYM`	News globales (con related symbols del query)	`kA4MVd`

Globales (sin simbolo)

Modo	Data	RPC ID
`indices`	Indices globales: Dow, S&P, NASDAQ, VIX, DAX, FTSE, Nikkei, etc	`hgueg`
`sectors`	Sectors equity heatmap (Health Care, Tech, etc)	`vNewwe`

Catalogos locales (sin HTTP)

Modo	Data
`rpcs`	Catalogo de RPC IDs con args templates y descripciones
`layouts`	Layouts posicionales de los arrays anidados
`cookies`	Cookies de bypass del consent screen

Combinado

Modo	Data
`all SYM`	quote + description + analysts + financials + daily + news (6 requests)

Formato de simbolos

Donde	Formato	Ejemplos
Tickers US	`TICKER:NASDAQ` o `TICKER:NYSE`	`AAPL:NASDAQ` , `JPM:NYSE`
ADRs argentinas	`TICKER:NASDAQ` o `TICKER:NYSE`	`GGAL:NASDAQ` , `BBAR:NYSE`
Tickers BCBA (locales argentinas)	`TICKER:BCBA`	`GGAL:BCBA` , `YPFD:BCBA`
Brazil B3	`TICKER:BMFBOVESPA`	`PETR4:BMFBOVESPA`
Spain BME	`TICKER:BME`	`SAN:BME`
Germany Xetra	`TICKER:XETR`	`SAP:XETR`
Indices	`IDX:INDEXSP/DJX/NASDAQ/CBOE`	`.INX:INDEXSP` , `.DJI:INDEXDJX`

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

Feature	Google Finance	TradingView	Yahoo	Finnhub
Sin auth	✅	✅	✅	Freemium
OHLC intraday 1-min publico gratis	✅ UNICO	❌ (paid)	⚠️ limited	⚠️ paid
OHLC 5-min completo	✅	❌	⚠️	⚠️
Indices globales en 1 call (Dow+S&P+NASDAQ+VIX+DAX+FTSE+Nikkei...)	✅ UNICO	⚠️ uno por uno	⚠️	⚠️
Detalle individual de analyst opinions (nombre, firm, target, fecha)	✅ UNICO	⚠️ solo agregado	⚠️	✅
Sectors heatmap	✅	⚠️	❌	❌
Descripcion empresa con address fisico + employees	✅ UNICO	⚠️	⚠️	✅
Quote delayed	✅	✅	✅	✅
Financials	✅ (~22 KB)	✅	✅	✅
News con thumbnails	✅	✅	✅	✅

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

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

Headers requeridos

Ya configurados en el script:

python

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:

python

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.