finviz

name	finviz
description	Scraper de Finviz: datos fundamentales, técnicos, insider trading, news y screener para acciones US. Sin API oficial.
license	MIT

Finviz — Scraper de Datos Financieros

Scraper de Finviz que extrae datos fundamentales (P/E, EPS, PEG, márgenes, etc.), técnicos (RSI, MACD, SMA, ATR), insider trading, noticias y screener para acciones del mercado US.

Finviz no tiene API pública oficial. Este skill scrapea el HTML de las páginas públicas usando requests + BeautifulSoup.

---

⚠️ Aviso Legal

• Finviz no tiene API pública oficial. Este scraper accede a datos públicamente disponibles en la web.
• Respetá los términos de servicio de Finviz.
• Implementá rate limiting (mín 2 segundos entre requests).
• No uses este scraper para uso comercial sin verificar los ToS de Finviz.
• El sitio puede cambiar su estructura HTML, rompiendo el scraper.

---

Instalación de dependencias

pip install requests beautifulsoup4

---

Scripts

Script	Descripción
fetch_quote.py	Extrae perfil, fundamentales, técnicos, noticias e insider trading de un ticker.

---

Uso rápido

# Fetch completo de un ticker
python scripts/fetch_quote.py --ticker AAPL

# Solo fundamentales
python scripts/fetch_quote.py --ticker AAPL --fields fundamentals

# Output a archivo JSON
python scripts/fetch_quote.py --ticker MSFT --output msft_data.json

# Múltiples tickers
python scripts/fetch_quote.py --ticker AAPL,MSFT,GOOGL

# Headlines de noticias (default: 5)
python scripts/fetch_quote.py --ticker NVDA --news-headlines 10

---

Campos extraídos del quote page

Fundamentales

Campo	Descripción
Market Cap	Capitalización de mercado
P/E	Price-to-Earnings ratio
Forward P/E	Forward P/E
PEG	PEG ratio
P/S	Price-to-Sales
P/B	Price-to-Book
EPS (ttm)	Earnings Per Share (trailing 12 months)
EPS next Y	Estimated EPS next year
Sales	Revenue
Profit Margin	Profit margin
ROE	Return on Equity
ROA	Return on Assets
Debt/Eq	Debt-to-Equity
Dividend %	Dividend yield
Insider Own	Insider ownership
Instit Own	Institutional ownership
Short Float	Short float percentage
Target Price	Analyst target price
Rating	Analyst rating

Técnicos

Campo	Descripción
RSI (14)	Relative Strength Index
SMA 20	Simple Moving Average 20d
SMA 50	Simple Moving Average 50d
SMA 200	Simple Moving Average 200d
MACD	MACD value
ATR	Average True Range
BB	Bollinger Bands midpoint
Volatility	Volatility
Beta	Beta

---

Estructura del skill

skills/finviz/
├── SKILL.md                     # Este archivo
├── references/
│   └── QUOTE_REFERENCE.md       # Referencia de campos extraídos
└── scripts/
    └── fetch_quote.py           # Scraper principal