claude-finance-kit
Vietnamese stock market analysis toolkit for AI coding assistants.
Fundamentals • Technicals • Macro • News • Screening • Fund Analysis
Overview
claude-finance-kit is a Python library + AI plugin that gives your coding assistant deep access to Vietnamese stock market data and analysis tools. It works as a Claude Code plugin (via Marketplace), and also supports Cursor and GitHub Copilot through a CLI installer.
Ask natural language questions — the plugin auto-routes to the right analysis workflow:
"Analyze FPT stock"
"Market overview today"
"Compare VNM vs MSN"
"Latest news sentiment for HPG"
Example: Stock Analysis in Action
Claude Code analyzing HPG stock — orchestrating fundamental and technical agents in parallel. Download plugin →
Features
- Stock Analysis — valuation, financial health, technical indicators, screening, sentiment, sector analysis
- Market Research — market valuation (P/E, P/B), sector comparison, fund analysis, commodities
- Technical Analysis — 30+ indicators: SMA, EMA, RSI, MACD, Bollinger Bands, ATR, OBV, and more
- Macro Research — GDP, CPI, interest rates, exchange rates, FDI, trade balance
- News & Sentiment — crawl and classify news from Vietnamese financial sites (CafeF, VnExpress, etc.)
- Fund Analysis — 58+ mutual funds: NAV, holdings, industry allocation, performance
- Batch Collection — scheduled OHLCV, financial, and intraday data collection tasks
- Multi-Source — automatic fallback across 12 data providers
Installation
1. Install the Python library
pip install claude-finance-kit
2. Install the AI plugin
Claude Code (via Marketplace)
Add the marketplace:
/plugin marketplace add hongbietcode/claude-finance-kit
Browse and install:
Run /plugin to open the plugin manager. Go to the Discover tab to find claude-finance-kit.
Select it and choose an installation scope:
- User scope — available across all projects
- Project scope — available for all collaborators on this repository
- Local scope — available only for you in this repository
Or install directly:
/plugin install claude-finance-kit@hongbietcode-claude-finance-kit
Run /reload-plugins to activate.
Other AI Assistants (Cursor, Copilot)
npx claude-finance-kit-cli init --ai cursor # Cursor
npx claude-finance-kit-cli init --ai copilot # GitHub Copilot
npx claude-finance-kit-cli init --ai claude # Claude Code (CLI alternative)
Quick Start
Once installed, just ask naturally — the plugin auto-invokes the right skill:
"Analyze FPT stock" → finance-kit (stock deep dive)
"Market overview today" → finance-kit (market briefing)
"Compare VNM vs MSN" → finance-kit (comparative)
"Latest news sentiment for HPG" → finance-kit (news sentiment)
/finance-kit "tôi mua HPG ở giá 26.6k, có nên bán không" → finance-kit (full analysis)
Python Library Usage
from claude_finance_kit import Stock, Market, Macro, Commodity, Fund
# Stock data
stock = Stock("FPT")
stock.quote.history(start="2025-01-01", end="2025-12-31")
stock.finance.income_statement(period="quarter", lang="en")
stock.company.overview()
# Market valuation
market = Market("VNINDEX")
market.pe(duration="5Y")
market.top_gainer(limit=10)
# Macro indicators
macro = Macro()
macro.gdp()
macro.cpi()
macro.interest_rate()
# Commodities
commodity = Commodity()
commodity.gold()
commodity.oil()
# Fund analysis
fund = Fund()
fund.listing("STOCK")
Technical Analysis
from claude_finance_kit import Stock, Indicator
hongbietcode