fireant-stock

在 FireAnt.vn 上自动检查越南股票价格和指数。在检查越南股票（HOSE、HNX、UPCOM）和市场指数（VNINDEX、HNX30、VN30）的当前股票价格、市场指数、交易量或财务信息时使用。接受 DPM、VCB、FPT 等股票代码或 VNINDEX 等指数。返回格式化的价格/指数数据、市场统计数据和关键财务指标。

# 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}`

---

## 中文说明

# FireAnt 股票价格查询器

## 概述

自动从 FireAnt.vn 获取越南股票的实时股票信息。处理从搜索到数据提取和格式化的完整工作流程。

## 快速开始

查询单只股票：
```bash
scripts/check_stock.py DPM
```

查询多只股票：
```bash
scripts/check_stock.py VCB FPT BID
```

## 核心工作流程

1. **搜索** - 使用 Google 搜索查找该代码的 FireAnt 股票页面
2. **导航** - 通过浏览器自动化打开 FireAnt 股票页面
3. **提取** - 解析当前价格、交易量、市值和关键统计数据
4. **格式化** - 以可读格式返回结构化数据

## 支持的数据

### 股票：
- **当前价格** - 实时价格及涨跌百分比
- **交易数据** - 交易量、成交额、开盘价/最高价/最低价
- **市场指标** - 市值、贝塔系数、市盈率、参考价
- **技术分析** - 移动平均线（MA10、MA50）
- **公司信息** - 公司全称、上市交易所

### 指数（VNINDEX、HNX30、VN30 等）：
- **当前指数** - 实时指数值及涨跌百分比
- **交易数据** - 总交易量、撮合交易量、成交额
- **外资交易** - NĐTNN（外国投资者）的买入/卖出活动及净头寸
- **技术分析** - 移动平均线（MA10、MA50）
- **市场概览** - 参考价、开盘价、最高/最低区间

## 使用模式

**单只股票查询：**
"Check giá cổ phiếu DPM"
"What's the current price of VCB?"

**多只股票：**
"Compare VCB, BID, and CTG prices"
"Show me bank stocks: VCB BID CTG"

**市场指数：**
"Check VNINDEX"
"How is the market doing today?"（→ VNINDEX）
"Show me VN30 index"

**混合（股票 + 指数）：**
"Check ACB, L18, AAA và VNINDEX"
"Give me tech stocks and market index: FPT VNM VNINDEX"

**市场研究：**
"Find information about DPM stock on FireAnt"
"Get latest trading data for FPT"

## 脚本

### scripts/check_stock.py

主脚本，为一个或多个代码（股票或指数）自动执行完整的股票查询工作流程。

**用法：** `python3 scripts/check_stock.py <SYMBOL1> [SYMBOL2] ...`

**示例：**
```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
```

**返回：** 格式化的股票/指数数据，包括价格/指数值、交易量和关键指标。

**注意：** FireAnt 的 URL 格式对股票和指数都相同：`https://fireant.vn/ma-chung-khoan/{SYMBOL}`