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

1. Search - Uses Google search to find the FireAnt stock page for the symbol
2. Navigate - Opens the FireAnt stock page via Agent Browser (Rust headless browser automation)
3. Extract - Parses current price, volume, market cap, and key statistics from page snapshot
4. 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}