FireAnt 股票检查器

说明文档

# FireAnt Stock Price Checker

## Overview

Automatically retrieves real-time stock information from FireAnt.vn for Vietnamese equities. Handles the full workflow from searching to data extraction and formatting.

## Quick Start

Check a single stock:
```bash
scripts/check_stock.py DPM
```

Check multiple stocks:
```bash
scripts/check_stock.py VCB FPT BID
```

## Core Workflow

1. **Search** - Uses Google search to find the FireAnt stock page for the symbol
2. **Navigate** - Opens the FireAnt stock page via browser automation  
3. **Extract** - Parses current price, volume, market cap, and key statistics
4. **Format** - Returns structured data in readable format

## Supported Data

### For Stocks:
- **Current Price** - Real-time price with change percentage
- **Trading Data** - Volume, value, opening/high/low prices  
- **Market Metrics** - Market cap, beta, P/E ratio, reference price
- **Technical Analysis** - Moving averages (MA10, MA50)
- **Company Info** - Full company name, stock exchange listing

### For Indices (VNINDEX, HNX30, VN30, etc.):
- **Current Index** - Real-time index value with change percentage
- **Trading Data** - Total volume, matched volume, value traded
- **Foreign Trading** - NĐTNN (foreign investor) buy/sell activity and net position
- **Technical Analysis** - Moving averages (MA10, MA50)
- **Market Overview** - Reference price, opening, high/low range

## Usage Patterns

**Single stock inquiry:**
"Check giá cổ phiếu DPM"
"What's the current price of VCB?"

**Multiple stocks:**
"Compare VCB, BID, and CTG prices"
"Show me bank stocks: VCB BID CTG"

**Market indices:**
"Check VNINDEX"
"How is the market doing today?" (→ VNINDEX)
"Show me VN30 index"

**Mixed (stocks + index):**
"Check ACB, L18, AAA và VNINDEX"
"Give me tech stocks and market index: FPT VNM VNINDEX"

**Market research:**
"Find information about DPM stock on FireAnt"
"Get latest trading data for FPT"

## Scripts

### scripts/check_stock.py

Main script that automates the full stock checking workflow for one or more symbols (stocks or indices).

**Usage:** `python3 scripts/check_stock.py <SYMBOL1> [SYMBOL2] ...`

**Examples:**
```bash
# Check stocks
python3 scripts/check_stock.py ACB VCB FPT

# Check index
python3 scripts/check_stock.py VNINDEX

# Check mixed
python3 scripts/check_stock.py ACB L18 AAA VNINDEX
```

**Returns:** Formatted stock/index data including price/index value, volume, and key metrics.

**Note:** FireAnt URL format is the same for both stocks and indices: `https://fireant.vn/ma-chung-khoan/{SYMBOL}`