What does the Investing AI skill do?

Investing.com via HTML scrape: cotizaciones, historico OHLCV, fundamentals (income/balance/cashflow/ratios), dividendos, earnings, perfil de empresa. 81K+ equities, 344 commodities, 10K indices, 2.4K currencies, 10K ETFs, 4.1K cryptos. Cobertura global.

Why use Investing on TypingMind?

Because you install it once and use it with any model. Investing is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Investing in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/gauss314/skills/tree/main/skills/investing. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Investing?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Investing?

As many as you like. As long as a model supports skills, you can use Investing with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Investing AI skill free?

Yes. It is published on GitHub by gauss314 under the MIT license. You only pay your own AI provider for the tokens you use.

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Investing by gauss314 — AI Skill for Any LLM

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

Script	Descripcion
fetch_investing.py	Script principal: todos los modos disponibles

Instalacion de dependencias

bash
pip install curl_cffi

NO funciona con requests puro. Cloudflare detecta y bloquea.

Uso rapido

bash
# === 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

Modo	Data	Endpoint
`quote`	Cotizacion (precio, cambio, OHLC, volume, pair_id)	`www.investing.com/{type}/{slug}`
`search`	Busqueda fuzzy sobre sitemaps publicos	Sitemap XMLs
`sitemap`	Descarga sitemap completo (URLs de instrumentos)	Sitemap XMLs
`historical`	Historico OHLCV desde la tabla HTML	`/{type}/{slug}-historical-data`
`profile`	Descripcion, sector, industria, pais, sede, empleados	`/{type}/{slug}-company-profile`
`financials`	Income / Balance / Cash Flow (TTM + ultimos 5 anios)	`/{type}/{slug}-income-statement` etc.
`ratios`	Margenes, retornos, valuation ratios	`/{type}/{slug}-ratios`
`dividends`	Historial completo de dividendos	`/{type}/{slug}-dividends`
`earnings`	Earnings history (EPS real vs estimado)	`/{type}/{slug}-earnings`

Tipos de instrumentos

Tipo	`--type`	Slug example	Cobertura
Equity (stock/ADR)	`equities`	`apple-computer-inc`, `ypf-sa`, `ggal`	81,518
Commodity	`commodities`	`gold`, `crude-oil`, `brent-oil`	344
Indice	`indices`	`us-spx-500`, `ibovespa`, `dax`	20,000+
Currency pair (forex)	`currencies`	`eur-usd`, `usd-ars`, `brl-usd`	2,394
ETF	`etfs`	`spdr-s-p-500`, `vanguard-ftse-all-world`	30,000+
Crypto	`crypto`	`bitcoin`, `ethereum`	4,135+ coins, 20K+ pairs
Tasa / Bono	`rates-bonds`	(no en sitemap directo)	20,000+
Fondo	`funds`	(no en sitemap directo)	100K+
Certificado	`certificates`	(no en sitemap directo)	6,222

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)

Slug	Nombre	Simbolo	Tipo
`ypf-sa`	YPF Sociedad Anonima	YPF	equities
`ypf-sociedad`	YPF Sociedad (variante)	YPF	equities
`pampa-energia`	Pampa Energia SA	PAMPm	equities
`pampa-energia-sa`	Pampa Energia ADR	PAM	equities
`central-puerto`	Central Puerto S.A.	CEPUm	equities
`central-puerto-adr`	Central Puerto ADR	CEPU	equities
`tenaris`	Tenaris SA	TENR	equities
`tenaris-sa`	Tenaris ADR	TS	equities
`bbva`	Banco Bilbao Vizcaya Argentaria	BBVA	equities
`banco-macro-sa`	Banco Macro SA	BMA	equities
`mercadolibre`	MercadoLibre	MELI	equities
`mercadolibre-inc`	MercadoLibre Inc	MELI	equities
`globant-sa`	Globant SA	GLOB	equities
`globant-cedear`	Globant CEDEAR	GLOBm	equities
`despegar-com`	Despegar	DESP	equities
`despegar-ba`	Despegar Buenos Aires	DESPm	equities
`galicia-b`	Grupo Financiero Galicia (BA)	GGALm	equities
`grupo-financiero-galicia-sa-adr`	Grupo Financiero Galicia ADR	GGAL	equities
`edenor`	Edenor	EDNm	equities
`transportadora-de-gas-del-sur-sa`	TGS SA	TGSm	equities
`siderar`	Ternium / Siderar	TXR	equities
`aluar`	Aluar	ALUA	equities
`mirgor`	Mirgor	MIRG	equities
`loma-negra`	Loma Negra	LOMA	equities
`cresud`	Cresud	CRESY	equities
`transener`	Transener	TRAN	equities
`capex`	Capex	CAPX	equities
`solvay`	Solvay	SOLB	equities
`holcim`	Holcim	HCMLY	equities
`consultatio-s.`	Consultatio	CONO	equities
`garovaglio`	Garovaglio	GCLA	equities
`laboratorios-richmond`	Laboratorios Richmond	RICH	equities
`longvie`	Longvie	LONG	equities
`rigolleau`	Rigolleau	RIGO	equities

Currencies (FX)

Slug	Par	Notas
`usd-ars`	USD/ARS (oficial)	Dolar oficial
`eur-usd`	EUR/USD	Mayor
`brl-usd`	BRL/USD (oficial)	Dolar oficial Brasil
`mxn-usd`	MXN/USD (oficial)	Peso mexicano
`ars-brl`	ARS/BRL	Peso argentino vs real
`ars-mxn`	ARS/MXN	Peso argentino vs peso mexicano
`aed-ars`	AED/ARS	Dirham → Peso

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

Datos devueltos

`quote`

json
{
  "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, last_raw, change, bid, ask, open, high, low, volume, prev_close, pair_id, name, symbol, currency, exchange. Commodities suelen incluir ademas updated_epoch.

`historical`

json
{
  "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:

json
{
  "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):

json
{
  "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):

json
{
  "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):

commodities (344 instrumentos)
currencies (2,394)
indices (20K+)
etfs (30K+)
crypto (4K+)
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

Rate limit agresivo: en uso intensivo, CF puede bloquear el IP. Es problema del sitio, no del script.
Cloudflare puede romper el skill en cualquier momento cambiando el challenge.
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 para la documentacion exhaustiva de los endpoints, estructuras JSON, ejemplos y troubleshooting.

Publisher	gauss314
Repository	`skills`
Skill name	`investing`
Stars	250
Forks	35
Bundled files	2
License	MIT
Links	Skill source Repository

Investing

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Investing.com — Datos via HTML Scrape

⚠️ Aviso Legal y Tecnico

Scripts

Instalacion de dependencias

Uso rapido

Modos disponibles

Tipos de instrumentos

Slugs utiles (Argentina / LatAm)

Currencies (FX)

Datos devueltos

`quote`

`historical`

`financials`

`ratios`

`dividends`

`earnings`

Consideraciones tecnicas

¿Por que `curl_cffi` y no `requests`?

Rate limit y Cloudflare

Auto-deteccion de tipo

Sitemaps

Limitaciones

Estructura del skill

Bundled files

Frequently asked questions

Set up your own AI workspace now

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Investing.com — Datos via HTML Scrape

⚠️ Aviso Legal y Tecnico

Scripts

Instalacion de dependencias

Uso rapido

Modos disponibles

Tipos de instrumentos

Slugs utiles (Argentina / LatAm)

Currencies (FX)

Datos devueltos

quote

historical

financials

ratios

dividends

earnings

Consideraciones tecnicas

¿Por que curl_cffi y no requests?

Rate limit y Cloudflare

Auto-deteccion de tipo

Sitemaps

Limitaciones

Estructura del skill

Bundled files

Frequently asked questions

Related AI Skills

Set up your own AI workspace now

`quote`

`historical`

`financials`

`ratios`

`dividends`

`earnings`

¿Por que `curl_cffi` y no `requests`?