mcpField
G
google-finance

google-finance

github.com/gauss314Data & databases252261 installsUpdated 19w ago
Repository

About google-finance

google-finance is a skill and CLI for retrieving financial data through Google Finance's undocumented internal RPC endpoint, without authentication. It offers varied market and company data, while documenting positional-response risks and aggressive rate limits for research and prototyping use.

Key features

  1. 01Quotes and intraday or historical OHLC
  2. 02Company financials, earnings, and profiles
  3. 03Analyst opinions, news, and peers
  4. 04Global indices and sector heatmap
  5. 05CLI modes and RPC reference catalog
  6. 06Warnings and troubleshooting guidance

Use cases

  1. 01Retrieve one-minute data for personal research
  2. 02Compare analyst opinions across companies
  3. 03Check global indices and sector performance
  4. 04Prototype analyses with cached data

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gauss314/skills --skill google-finance

After installing, type/google-financein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/
chunk_layouts.json
consent_cookies.json
rpc_ids.json
references/
COOKBOOK.md
LIMITATIONS_TROUBLESHOOTING.md
REFERENCE.md
RESPONSE_FORMAT.md
RPC_IDS.md
scripts/
fetch_gfinance.py

Details

From the project README

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

# 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
ModoDataRPC ID
quote SYMPrecio + change + currency + market hoursgCvqoe
quote-full SYMQuote + industry + market cap + volumedlNq8b
description SYMDescripcion + address + employees + ratios + URLsJL8oKc
peers SYMRelated stocks (default 4, controlable con --peers-count)SICF5d
analysts SYMRecommendations summary + opinions individualesYTM9q
earnings SYMEarnings history multi-periodXxQsbd
technicals SYMRatings tecnicos (similar a TradingView Recommend.*)gXxkFd
financials SYMIncome + balance + cashflow ~22 KB multi-periodPr8h2e
intraday-1min SYMOHLC 1-min del dia actual (~30 KB)c2u4wc
intraday-5min SYMOHLC 5-min con OHLC completo (~5 KB)c2u4wc
daily SYMOHLC diario ultimo mes (~22 dias)c2u4wc
daily-6m SYMOHLC diario ultimos ~6 mesesc2u4wc
news SYMNews especificas del simbolokA4MVd
news-related SYMNews globales (con related symbols del query)kA4MVd
Globales (sin simbolo)
ModoDataRPC ID
indicesIndices globales: Dow, S&P, NASDAQ, VIX, DAX, FTSE, Nikkei, etchgueg
sectorsSectors equity heatmap (Health Care, Tech, etc)vNewwe
Catalogos locales (sin HTTP)
ModoData
rpcsCatalogo de RPC IDs con args templates y descripciones
layoutsLayouts posicionales de los arrays anidados
cookiesCookies de bypass del consent screen
Combinado
ModoData
all SYMquote + description + analysts + financials + daily + news (6 requests)

Formato de simbolos

DondeFormatoEjemplos
Tickers USTICKER:NASDAQ o TICKER:NYSEAAPL:NASDAQ, JPM:NYSE
ADRs argentinasTICKER:NASDAQ o TICKER:NYSEGGAL:NASDAQ, BBAR:NYSE
Tickers BCBA (locales argentinas)TICKER:BCBAGGAL:BCBA, YPFD:BCBA
Brazil B3TICKER:BMFBOVESPAPETR4:BMFBOVESPA
Spain BMETICKER:BMESAN:BME
Germany XetraTICKER:XETRSAP:XETR
IndicesIDX: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

FeatureGoogle FinanceTradingViewYahooFinnhub
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",           # CRITICO
    "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.

# 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

DocumentoContenido
references/REFERENCE.mdOverview general + batchexecute deep dive
references/RPC_IDS.mdCatalogo detallado de los 14+ RPC IDs con args + outputs
references/RESPONSE_FORMAT.mdParser deep dive del wrb.fr (XSSI, doble JSON, edge cases)
references/LIMITATIONS_TROUBLESHOOTING.md⚠️ Warnings, debugging, plan B con providers alternativos
references/COOKBOOK.md25 recetas listas para copy-paste
assets/rpc_ids.jsonCatalogo de RPCs con args templates y descripciones
assets/chunk_layouts.jsonLayouts posicionales de cada array (que indice = que campo)
assets/consent_cookies.jsonCookies de bypass del consent screen

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.

Comments

Markdown supported