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:
scripts/check_stock.py DPM
Check multiple stocks:
scripts/check_stock.py VCB FPT BID
Core Workflow
- Search - Uses Google search to find the FireAnt stock page for the symbol
- Navigate - Opens the FireAnt stock page via Agent Browser (Rust headless browser automation)
- Extract - Parses current price, volume, market cap, and key statistics from page snapshot
- Format - Returns structured data in readable format
Requirements
- Agent Browser - Fast Rust-based headless browser (
agent-browser CLI must be installed)
- Python 3.x with standard libraries (sys, re, subprocess, json, typing)
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:
# 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}
1---2name: fireant-stock-23description: Automated Vietnamese stock price and index checking on FireAnt.vn. Use when checking current stock prices, market indices, trading volumes, or financial information for Vietnamese stocks (HOSE, HNX, UPCOM) and market indices (VNINDEX, HNX30, VN30). Accepts stock symbols like DPM, VCB, FPT, or indices like VNINDEX. Returns formatted price/index data, market statistics, and key financial metrics.4---56# FireAnt Stock Price Checker78## Overview910Automatically retrieves real-time stock information from FireAnt.vn for Vietnamese equities. Handles the full workflow from searching to data extraction and formatting.1112## Quick Start1314Check a single stock:15```bash16scripts/check_stock.py DPM17```1819Check multiple stocks:20```bash21scripts/check_stock.py VCB FPT BID22```2324## Core Workflow25261. **Search** - Uses Google search to find the FireAnt stock page for the symbol272. **Navigate** - Opens the FireAnt stock page via Agent Browser (Rust headless browser automation)283. **Extract** - Parses current price, volume, market cap, and key statistics from page snapshot294. **Format** - Returns structured data in readable format3031## Requirements3233- **Agent Browser** - Fast Rust-based headless browser (`agent-browser` CLI must be installed)34- Python 3.x with standard libraries (sys, re, subprocess, json, typing)3536## Supported Data3738### For Stocks:39- **Current Price** - Real-time price with change percentage40- **Trading Data** - Volume, value, opening/high/low prices 41- **Market Metrics** - Market cap, beta, P/E ratio, reference price42- **Technical Analysis** - Moving averages (MA10, MA50)43- **Company Info** - Full company name, stock exchange listing4445### For Indices (VNINDEX, HNX30, VN30, etc.):46- **Current Index** - Real-time index value with change percentage47- **Trading Data** - Total volume, matched volume, value traded48- **Foreign Trading** - NĐTNN (foreign investor) buy/sell activity and net position49- **Technical Analysis** - Moving averages (MA10, MA50)50- **Market Overview** - Reference price, opening, high/low range5152## Usage Patterns5354**Single stock inquiry:**55"Check giá cổ phiếu DPM"56"What's the current price of VCB?"5758**Multiple stocks:**59"Compare VCB, BID, and CTG prices"60"Show me bank stocks: VCB BID CTG"6162**Market indices:**63"Check VNINDEX"64"How is the market doing today?" (→ VNINDEX)65"Show me VN30 index"6667**Mixed (stocks + index):**68"Check ACB, L18, AAA và VNINDEX"69"Give me tech stocks and market index: FPT VNM VNINDEX"7071**Market research:**72"Find information about DPM stock on FireAnt"73"Get latest trading data for FPT"7475## Scripts7677### scripts/check_stock.py7879Main script that automates the full stock checking workflow for one or more symbols (stocks or indices).8081**Usage:** `python3 scripts/check_stock.py <SYMBOL1> [SYMBOL2] ...`8283**Examples:**84```bash85# Check stocks86python3 scripts/check_stock.py ACB VCB FPT8788# Check index89python3 scripts/check_stock.py VNINDEX9091# Check mixed92python3 scripts/check_stock.py ACB L18 AAA VNINDEX93```9495**Returns:** Formatted stock/index data including price/index value, volume, and key metrics.9697**Note:** FireAnt URL format is the same for both stocks and indices: `https://fireant.vn/ma-chung-khoan/{SYMBOL}`
dvcrn