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---5
6# FireAnt Stock Price Checker
7
8## Overview
9
10Automatically retrieves real-time stock information from FireAnt.vn for Vietnamese equities. Handles the full workflow from searching to data extraction and formatting.
11
12## Quick Start
13
14Check a single stock:
15```bash
16scripts/check_stock.py DPM
17```
18
19Check multiple stocks:
20```bash
21scripts/check_stock.py VCB FPT BID
22```
23
24## Core Workflow
25
261. **Search** - Uses Google search to find the FireAnt stock page for the symbol
272. **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 snapshot
294. **Format** - Returns structured data in readable format
30
31## Requirements
32
33- **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)
35
36## Supported Data
37
38### For Stocks:
39- **Current Price** - Real-time price with change percentage
40- **Trading Data** - Volume, value, opening/high/low prices
41- **Market Metrics** - Market cap, beta, P/E ratio, reference price
42- **Technical Analysis** - Moving averages (MA10, MA50)
43- **Company Info** - Full company name, stock exchange listing
44
45### For Indices (VNINDEX, HNX30, VN30, etc.):
46- **Current Index** - Real-time index value with change percentage
47- **Trading Data** - Total volume, matched volume, value traded
48- **Foreign Trading** - NĐTNN (foreign investor) buy/sell activity and net position
49- **Technical Analysis** - Moving averages (MA10, MA50)
50- **Market Overview** - Reference price, opening, high/low range
51
52## Usage Patterns
53
54**Single stock inquiry:**
55"Check giá cổ phiếu DPM"
56"What's the current price of VCB?"
57
58**Multiple stocks:**
59"Compare VCB, BID, and CTG prices"
60"Show me bank stocks: VCB BID CTG"
61
62**Market indices:**
63"Check VNINDEX"
64"How is the market doing today?" (→ VNINDEX)
65"Show me VN30 index"
66
67**Mixed (stocks + index):**
68"Check ACB, L18, AAA và VNINDEX"
69"Give me tech stocks and market index: FPT VNM VNINDEX"
70
71**Market research:**
72"Find information about DPM stock on FireAnt"
73"Get latest trading data for FPT"
74
75## Scripts
76
77### scripts/check_stock.py
78
79Main script that automates the full stock checking workflow for one or more symbols (stocks or indices).
80
81**Usage:** `python3 scripts/check_stock.py <SYMBOL1> [SYMBOL2] ...`
82
83**Examples:**
84```bash
85# Check stocks
86python3 scripts/check_stock.py ACB VCB FPT
87
88# Check index
89python3 scripts/check_stock.py VNINDEX
90
91# Check mixed
92python3 scripts/check_stock.py ACB L18 AAA VNINDEX
93```
94
95**Returns:** Formatted stock/index data including price/index value, volume, and key metrics.
96
97**Note:** FireAnt URL format is the same for both stocks and indices: `https://fireant.vn/ma-chung-khoan/{SYMBOL}`
johnalbertini14-glitch