| name | google-finance |
| description | Datos de Google Finance via batchexecute (API RPC interna sin auth ni API key). Quote, OHLC intraday 1-min y 5-min, OHLC daily, financials masivos (income/balance/cashflow), earnings, analyst recommendations + opinions, descripcion empresa, peers, news, indices globales (Dow/S&P/NASDAQ/VIX/DAX), sectors heatmap. Cobertura mercados US (NASDAQ/NYSE) y argentinos (BCBA). ⚠️ API NO oficial — leer LIMITATIONS_TROUBLESHOOTING.md antes de uso productivo. |
| license | MIT |
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
py scripts/fetch_gfinance.py quote GGAL:NASDAQ
py scripts/fetch_gfinance.py quote AAPL:NASDAQ
py scripts/fetch_gfinance.py quote GGAL:BCBA
py scripts/fetch_gfinance.py intraday-5min AAPL:NASDAQ
py scripts/fetch_gfinance.py intraday-1min GGAL:NASDAQ
py scripts/fetch_gfinance.py daily-6m AAPL:NASDAQ
py scripts/fetch_gfinance.py indices
py scripts/fetch_gfinance.py analysts NVDA:NASDAQ
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:
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",
"Origin": "https://www.google.com",
"Referer": "https://www.google.com/finance/...",
}
Cookies de bypass
El script las pasa automaticamente:
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.
py scripts/fetch_gfinance.py quote GGAL:NASDAQ -q
py scripts/fetch_gfinance.py quote GGAL:BCBA -q
py scripts/fetch_gfinance.py indices -q
py scripts/fetch_gfinance.py intraday-5min AAPL:NASDAQ -o aapl_5min.json
py scripts/fetch_gfinance.py daily-6m AAPL:NASDAQ -o aapl_6m.json
py scripts/fetch_gfinance.py analysts NVDA:NASDAQ -q
py scripts/fetch_gfinance.py peers GGAL:NASDAQ --peers-count 5 -q
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 endpointmfinance (Python, distinto enfoque)- Multiples proyectos OSS de scraping de finance.google.com
Este skill se distingue por:
- 24 modos CLI sobre 14+ RPC IDs distintos.
- Documentacion exhaustiva de los warnings y plan B.
- Catalogo estructurado de RPCs + layouts posicionales en assets.
- Parser robusto del wrb.fr con manejo de todos los edge cases.
