/google-finance

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](https://www.google.com/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`](./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

# 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:NYS