/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](./scripts/marketscreener_client.py)** | Cliente completo con todas las funcionalidades (transcripts, quotes, profile, financials, valuation, consensus, news, ratings, insider, calendar, search) | | **[marketscreener_cli.py](./scripts/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