Investing.com — Datos via HTML Scrape

Skill para extraer datos de Investing.com parseando el HTML publico. Sin API key, sin autenticacion.

⚠️ Aviso Legal y Tecnico

• Investing.com no expone API publica. Los datos se extraen de las paginas HTML con Cloudflare bot protection.
• Dependencia obligatoria: curl_cffi (impersona Chrome 120 a nivel TLS — requests puro devuelve el challenge de Cloudflare, no datos).
• Rate limit agresivo: respetar 1-2 segundos entre requests. Cloudflare devuelve 429/403 si se hacen muchas requests muy rapido. El script reintenta con backoff automatico.
• Datos delayed: el precio mostrado en la pagina es el del ultimo cierre disponible (15-20 min de delay para US equities, similar para otros).
• Respetar terminos de servicio de Investing.com. No hacer mas de 1-2 requests/segundo. No usar para redistribuir masivamente.
• Investing.com se reserva el derecho de bloquear rangos de IP. El skill puede dejar de funcionar en cualquier momento.

Scripts

Instalacion de dependencias

pip install curl_cffi

NO funciona con requests puro. Cloudflare detecta y bloquea.

Uso rapido

# === COTIZACIONES (auto-detect tipo) ===
python scripts/fetch_investing.py quote gold
python scripts/fetch_investing.py quote eur-usd
python scripts/fetch_investing.py quote us-spx-500
python scripts/fetch_investing.py quote bitcoin
python scripts/fetch_investing.py quote ypf-sa --type equities
python scripts/fetch_investing.py quote apple-computer-inc -q

# === BUSQUEDA EN SITEMAPS ===
python scripts/fetch_investing.py search YPF
python scripts/fetch_investing.py search gold --category commodities
python scripts/fetch_investing.py search MERVAL --category indices
python scripts/fetch_investing.py search AR --category currencies --limit 30

# === SITEMAPS COMPLETOS ===
python scripts/fetch_investing.py sitemap commodities    # 344 instrumentos
python scripts/fetch_investing.py sitemap currencies     # 2,394 cruces
python scripts/fetch_investing.py sitemap indices        # 20K+ indices
python scripts/fetch_investing.py sitemap equities       # 81K+ acciones
python scripts/fetch_investing.py sitemap etfs           # 30K+ ETFs

# === HISTORICO OHLCV ===
python scripts/fetch_investing.py historical gold
python scripts/fetch_investing.py historical eur-usd
python scripts/fetch_investing.py historical ypf-sa --pages 5  # ~115 dias
python scripts/fetch_investing.py historical apple-computer-inc

# === FUNDAMENTALS ===
python scripts/fetch_investing.py profile apple-computer-inc
python scripts/fetch_investing.py financials apple-computer-inc --ftype income
python scripts/fetch_investing.py financials apple-computer-inc --ftype balance
python scripts/fetch_investing.py financials apple-computer-inc --ftype cashflow
python scripts/fetch_investing.py ratios apple-computer-inc
python scripts/fetch_investing.py dividends apple-computer-inc
python scripts/fetch_investing.py earnings apple-computer-inc

# === GUARDAR A ARCHIVO ===
python scripts/fetch_investing.py quote gold -o gold_quote.json
python scripts/fetch_investing.py historical ypf-sa -o ypf_hist.json

# === MODO SILENCIOSO (solo JSON, sin logs) ===
python scripts/fetch_investing.py quote gold -q

Modos disponibles

Tipos de instrumentos

Auto-deteccion: si no pasas --type, el script prueba commodities → currencies → indices → etfs → crypto → equities. Las equities son las mas lentas/rate-limited, asi que se prueban al final.

Slugs utiles (Argentina / LatAm)

Currencies (FX)

MEP / CCL / Blue: Investing.com no expone estos pares derivados como tales. Para MEP/CCL/blue, usar [data912](./../data912/) que sí los cubre.

Datos devueltos

quote

{
  "last": "4,501.47",         // precio formateado (con separadores)
  "last_raw": 4501.47,         // precio como float
  "change": -0.78,             // cambio absoluto vs last_close
  "change_pct": -0.02,         // (no siempre presente)
  "last_close": 4502.25,       // (no siempre presente)
  "bid": 4500.74,              // bid (commodities, currencies)
  "ask": 4501.19,              // ask
  "open": 4502.5,              // apertura del dia
  "high": 4508.75,             // maximo del dia
  "low": 4499.97,              // minimo del dia
  "volume": 1633,              // volumen
  "avg_volume": 0,             // volumen promedio
  "prev_close": null,          // cierre anterior
  "pair_id": 1057391,          // ID interno de investing.com
  "name": "Gold Futures",      // nombre completo
  "symbol": "GC",              // ticker
  "currency": "USD",           // moneda
  "exchange": null,            // exchange
  "country": null,             // pais
  "updated_epoch": 1749091200, // timestamp ultima actualizacion
  "page_title": "Gold Futures - Investing.com",
  "slug": "gold",
  "type": "commodities",
  "url": "https://www.investing.com/commodities/gold"
}

Nota: no todos los campos aparecen en todos los instrumentos. Equities suelen tener last, lastraw, change, bid, ask, open, high, low, volume, prevclose, pairid, name, symbol, currency, exchange. Commodities suelen incluir ademas updatedepoch.

historical

{
  "slug": "gold",
  "type": "commodities",
  "count": 23,
  "rows": [
    {
      "date": "Jun 04, 2026",
      "price": "4,497.70",
      "open": "4,481.76",
      "high": "4,543.12",
      "low": "4,470.55",
      "vol": "3.16K",
      "change_pct": "+0.69%"
    },
    ...
  ]
}

23 dias por default (1 pagina). Usar --pages 5 para ~115 dias, etc.

financials

Devuelve estructura con periodos (TTM, 2024, 2023, 2022, 2021, 2020) y filas con label + valores:

{
  "slug": "apple-computer-inc",
  "type": "equities",
  "ftype": "income",
  "periods": ["TTM", "2024", "2023", "2022", "2021", "2020"],
  "count": 23,
  "rows": [
    {"label": "Total Revenue", "values": ["394,328", "385,100", "383,285", "394,328", "365,817", "274,515"]},
    {"label": "Gross Profit", "values": ["170,000", ...]},
    ...
  ]
}

--ftype income | balance | cashflow

ratios

Misma estructura que financials pero con ratios (margenes, retornos, valuation, etc).

dividends

Array de filas con celdas (fecha, dividend, yield, etc):

{
  "slug": "apple-computer-inc",
  "type": "equities",
  "count": 18,
  "rows": [
    ["Ex-Dividend Date", "May 09, 2025", "Quarterly", "0.26", "..."],
    ...
  ]
}

earnings

Array de filas (date, EPS actual, EPS estimado, surprise, etc):

{
  "slug": "apple-computer-inc",
  "type": "equities",
  "count": 20,
  "rows": [
    ["Aug 01, 2024", "Q3 2024", "1.40", "1.35", "+3.70%", "..."],
    ...
  ]
}

Consideraciones tecnicas

¿Por que curl_cffi y no requests?

Investing.com usa Cloudflare con proteccion anti-bot a nivel TLS. El User-Agent no importa — Cloudflare hace TLS fingerprinting y rechaza clientes que no sean navegadores reales.

• requests (Python puro, TLS fingerprint de Python urllib3): bloqueado, devuelve challenge HTML.
• curl_cffi.requests.Session(impersonate="chrome120"): pasa el challenge porque impersona el fingerprint TLS de Chrome 120.

curl_cffi es un wrapper sobre curl-impersonate (fork de libcurl con fingerprints pre-cargados). Es una libreria con wheels precompilados para Windows/Mac/Linux — instalar y usar sin compilar nada.

Rate limit y Cloudflare

Cloudflare impone rate limits agresivos:

• /equities/ es el path mas rate-limited (mas requests, mas proteccion)
• /commodities/, /currencies/, /indices/ son mas permisivos
• Si haces 10+ requests en pocos segundos → 429 o 403 con "Just a moment..."
• Backoff recomendado: 2-3 segundos entre requests
• Si recibis 429, esperar 1-2 minutos

El script maneja esto con retries + backoff exponencial. Si el IP esta muy marcado, la unica solucion es esperar o usar un proxy residencial.

Auto-deteccion de tipo

Cuando no se pasa --type, el script prueba los 6 paths uno por uno. Esto dispara 6 requests, lo que puede rate-limitar. Recomendacion: pasar --type siempre que se sepa.

Orden de prueba (mas rapido primero):

1. commodities (344 instrumentos)
2. currencies (2,394)
3. indices (20K+)
4. etfs (30K+)
5. crypto (4K+)
6. equities (81K+, rate-limited)

Sitemaps

Los sitemaps son la unica fuente totalmente publica y no rate-limited. Son utiles para:

• Descubrir slugs de instrumentos (no hay API de "search" publica)
• Construir catalogos locales
• Backups de listings

Cantidad de instrumentos por sitemap (verificado 2026-06-04):

• equities: 81,518 (9 archivos)
• commodities: 344 (1 archivo)
• indices: 20,000+ (2 archivos)
• currencies: 2,394 (2 archivos)
• etfs: 30,000+ (3 archivos)
• crypto coins: 4,135
• crypto pairs: 20,000+ (2 archivos)
• rates/bonds: 20,000+ (2 archivos)
• funds: 100K+ (11 archivos)
• certificates: 6,222

Limitaciones

1. Rate limit agresivo: en uso intensivo, CF puede bloquear el IP. Es problema del sitio, no del script.
2. Cloudflare puede romper el skill en cualquier momento cambiando el challenge.
3. Historico paginado: 23 dias por default, hay que pasar --pages para mas.

Estructura del skill

skills/investing/
├── SKILL.md                          # Este archivo (guia rapida)
├── references/
│   └── REFERENCE.md                  # Documentacion completa + endpoints
└── scripts/
    └── fetch_investing.py            # Script principal

Documentacion detallada: Consultar [references/REFERENCE.md](./references/REFERENCE.md) para la documentacion exhaustiva de los endpoints, estructuras JSON, ejemplos y troubleshooting.