Finviz

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 | |--------|-------------| | [fetchquote.py](./scripts/fetchquote.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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: gauss314
• Source: gauss314/skills
• License: MIT

Install and usage instructions live in the source repository linked above.