# Finviz

> Scraper de Finviz: datos fundamentales, técnicos, insider trading, news y screener para acciones US. Sin API oficial.

- **Type:** Skill
- **Install:** `agentstack add skill-gauss314-skills-finviz`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gauss314](https://agentstack.voostack.com/s/gauss314)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [gauss314](https://github.com/gauss314)
- **Source:** https://github.com/gauss314/skills/tree/main/skills/finviz

## Install

```sh
agentstack add skill-gauss314-skills-finviz
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Finviz — Scraper de Datos Financieros

Scraper de [Finviz](https://finviz.com/) 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

```bash
pip install requests beautifulsoup4
```

---

## Scripts

| Script | Descripción |
|--------|-------------|
| **[fetch_quote.py](./scripts/fetch_quote.py)** | Extrae perfil, fundamentales, técnicos, noticias e insider trading de un ticker. |

---

## Uso rápido

```bash
# 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](https://github.com/gauss314)
- **Source:** [gauss314/skills](https://github.com/gauss314/skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-gauss314-skills-finviz
- Seller: https://agentstack.voostack.com/s/gauss314
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.