marketscreener

name	marketscreener
description	Scraper de MarketScreener (S&P Capital IQ): earnings transcripts, cotizaciones, perfiles empresa, financials, valuation, consenso analistas, noticias, insider trading, ratings. Sin API key.
license	MIT
metadata	{"category":"finanzas, scraper, stocks, transcripts, earnings, eeuu, global, ADRs","language":"es","source":"https://www.marketscreener.com"}

MarketScreener — Datos Financieros y Earnings Transcripts Globales

Scraper de MarketScreener (plataforma de S&P Capital IQ) que accede a datos gratuitos sin registro: earnings transcripts, cotizaciones, perfiles, financials históricos, valuación, consenso de analistas, noticias, insider trading y ratings.

URL base: https://www.marketscreener.com País soportado: Global (20,000+ stocks, ADRs argentinos incluidos) Requiere registro: ❌ No, todo es scraping directo

---

⚠️ Lo que MarketScreener ofrece GRATIS (sin registro)

Funcionalidad	Disponible Gratis	Requiere Pago
Earnings Transcripts (contenido completo)	—	🔒 Premium
Earnings Transcripts (listado con fechas, quarters, URLs)	✅	—
Cotizaciones (hasta 15 min retraso)	✅	—
Perfil de empresa (descripción, sector, empleados, web)	✅	—
Datos financieros (Income Statement, Balance Sheet, Cash Flow)	✅ (años recientes)	🔒 Más años
Valuación (PE, PB, EV/EBITDA, market cap, dividend yield)	✅	—
Consenso de analistas (target price, recomendaciones, revisiones)	✅	—
Ratings (Surperformance Score: Trader, Investor, Global)	✅	—
Noticias (histórico completo)	✅	—
Calendario (earnings, dividends, splits, AGM)	✅	—
Insider Trading (transacciones de ejecutivos)	✅	🔒 Más detalle
Accionistas (top shareholders)	✅	🔒 Lista completa
Gobierno corporativo (board, management)	✅	—
Gráficos (históricos, velas, indicadores técnicos)	✅	—
Búsqueda de símbolos	✅	—
Screener avanzado	—	🔒 Premium
Datos financieros históricos >3 años	—	🔒 Premium

---

Cobertura

Tipo	Cobertura
Stocks US	✅ Todas (AAPL, MSFT, etc.)
ADRs argentinos	✅ GGAL, TGS, BMA, YPF, PAM, etc.
Stocks globales	✅ Europa, Asia, Latinoamérica
ETFs	✅
Índices	✅
Bonos	❌ No disponible
Forex / Crypto	❌ No disponible

---

Autenticación

No requiere API key ni registro. Todo el contenido es scraping directo de páginas públicas HTML.

---

Uso Rápido

from marketscreener_client import MarketScreenerClient

client = MarketScreenerClient()

# Último earnings transcript de GGAL
transcript = client.get_transcript("GGAL")
print(transcript["title"])
print(transcript["prepared_remarks"][:500])

# Cotización de AAPL
quote = client.get_quote("AAPL")
print(f"${quote['price']} ({quote['change_pct']}%)")

# Perfil de empresa
profile = client.get_profile("GGAL")
print(profile["name"], profile["industry"])

# Financials
fin = client.get_financials("AAPL", statement="income")
print(fin["2025"]["revenue"])

# Consenso de analistas
consensus = client.get_consensus("AAPL")
print(f"Target: ${consensus['target_mean']}, Recomendación: {consensus['rating']}")

---

Scripts Disponibles

Script	Descripción
marketscreener_client.py	Cliente completo con todas las funcionalidades (transcripts, quotes, profile, financials, valuation, consensus, news, ratings, insider, calendar, search)
marketscreener_cli.py	CLI rápida para consultas diarias

---

Buenas Prácticas

1. Rate limiting: usar 1 request por segundo como mínimo para evitar bloqueos
2. User-Agent: siempre usar un User-Agent de navegador real
3. Cachear: los datos de transcripts no cambian después de publicados, cachear localmente
4. HTML Parsing: usar BeautifulSoup para parsear HTML, no regex
5. IDs numéricos: cada empresa tiene un ID numérico único en MarketScreener (ej: AAPL=4849, GGAL=13491328)
6. Errores 404: si no se encuentra una página, puede que la empresa no esté cubierta