Market Advisor

Market Advisor — CIO Edition

> ⛔ CRITICAL: LẤY GIÁ TỪ SCRIPT/API — KHÔNG BAO GIỜ WEBSEARCH GIÁ > > Hành động ĐẦU TIÊN: chạy python scripts/analyze_all.py [TICKER1] [TICKER2] ... > Script dùng VPS API (realtime) + yfinance (fallback) để lấy giá CHÍNH XÁC từ sàn + phân tích kỹ thuật + cơ bản + dự báo. > Nếu script fail: dùng WebFetch gọi https://bgapidatafeed.vps.com.vn/getliststockdata/[TICKER] > > KHÔNG BAO GIỜ WebSearch giá. WebSearch chỉ cho: tin tức, sentiment, analyst, bear case.

🧠 BƯỚC 0 — ĐỌC JOURNAL TRƯỚC KHI PHÂN TÍCH (Learning Loop)

Skill này có bộ nhớ dài hạn lưu tại ~/.claude/skills-data/market-analyst/. Mỗi lần phân tích đều được ghi journal và Claude phải đọc track record cũ trước khi đưa ra recommendation mới.

Quy trình BẮT BUỘC:

1. Trước phân tích — chạy: python scripts/journal_manager.py context [TICKER] --price [GIA_HIEN_TAI]

• Trả về: track record cũ, calibration score, lessons learned, lịch sử thesis
• Nếu bull_hit_rate /dev/null

python scripts/analyze_all.py DIG SSI VIX

Script sử dụng VPS API (realtime, không cần package) + yfinance (fallback) để lấy:
- ✅ Giá REALTIME chính xác từ sàn (VPS API: `bgapidatafeed.vps.com.vn`)
- ✅ OHLC, volume, khối ngoại mua/bán, order book, room ngoại
- ✅ Phân tích kỹ thuật: RSI, MACD, Bollinger, Ichimoku, VWAP, Elliott Wave, S/R
- ✅ Phân tích cơ bản: P/E, ROE, margins, Piotroski F-Score (từ yfinance)
- ✅ Dự báo 3 kịch bản Bull/Base/Bear
- ✅ `IMPORTANT_INSTRUCTIONS` — liệt kê những gì CẦN và KHÔNG CẦN WebSearch

**Lưu ý giá VPS API:** Trả theo đơn vị nghìn (18.1 = 18,100 VND). Script tự convert.

**Ưu tiên 2 — Nếu script fail (ví dụ trong Claude.ai sandbox):** Dùng **WebFetch** gọi VPS API trực tiếp:

WebFetch URL: https://bgapidatafeed.vps.com.vn/getliststockdata/[TICKER] Prompt: "Trả về JSON: lastPrice, r, c, f, highPrice, lowPrice, openPrice, lot, fBVol, fSVolume, fRoom, avePrice"

Gọi TỪNG MÃ MỘT. Nếu fail, THỬ LẠI 1 lần.

**Ưu tiên 3 — Fallback cuối cùng:** WebSearch giá từ `finance.vietstock.vn` hoặc `cafef.vn`.

**SAU KHI CÓ GIÁ:** KHÔNG WebSearch giá nữa. Đọc `IMPORTANT_INSTRUCTIONS` trong output script.

### Crypto — CoinGecko API qua WebFetch

WebFetch: https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,solana&vscurrencies=usd&include24hrchange=true&includemarket_cap=true WebFetch: https://api.alternative.me/fng/?limit=7&format=json (Fear & Greed)

### VN Historical — VPS Historical API

WebFetch: https://histdatafeed.vps.com.vn/tradingview/history?symbol=[TICKER]&resolution=D&from=[UNIXSTART]&to=[UNIXEND]

**SAU KHI CÓ GIÁ TỪ API:** Không WebSearch giá nữa. WebSearch CHỈ cho tin tức, analyst, bear case, insider, macro.

## Bước 2: WebSearch BỔ SUNG (CHỈ cho tin tức & sentiment)

WebSearch KHÔNG dùng để lấy:
- ❌ Giá cổ phiếu (đã có từ VPS API)
- ❌ Giá crypto (đã có từ CoinGecko API)
- ❌ Fear & Greed (đã có từ alternative.me API)

WebSearch CHỈ dùng cho:
- ✅ Tin tức mới nhất
- ✅ Analyst consensus & khuyến nghị
- ✅ Bear case / rủi ro / contrarian
- ✅ Insider activity
- ✅ Bối cảnh vĩ mô

### Tại sao cần research nhiều

Thị trường VN thay đổi nhanh — tin tức hôm nay có thể lật ngược thesis hôm qua. Một advisory chất lượng cần dữ liệu từ nhiều nguồn, nhiều thời điểm, để tránh bias xác nhận.

### Số lượng search tối thiểu: 15-20 queries

Chia theo 3 tầng thời gian (đọc `references/multi_timeframe_news.md`):

**Structural (3-12 tháng) — 4-5 queries:**

"triển vọng chứng khoán VN 2026 analyst" "FTSE nâng hạng Việt Nam tiến độ" "đầu tư công 2026 giải ngân tiến độ" "chiến tranh thương mại tác động Việt Nam xuất khẩu" "lãi suất NHNN xu hướng 2026"

**Developing (1-4 tuần) — 4-5 queries:**

"VN-Index tuần qua nhận định chuyên gia" "khối ngoại mua bán ròng tháng gần nhất" "ngành dẫn dắt thị trường tuần qua" "KQKD quý gần nhất doanh nghiệp niêm yết" "margin chứng khoán mức hiện tại"

**Breaking (24-72h) — 2-3 queries:**

"chứng khoán hôm nay VN-Index" "tin tài chính Việt Nam mới nhất"

### Screening cổ phiếu — PHỦ CẢ 3 PHÂN KHÚC

Tại sao cần mid/small cap: Blue-chip đã được coverage rộng, alpha thường đến từ mid/small cap chưa được thị trường định giá đúng. Ít nhất 1/3 recommendation phải là mid hoặc small cap.

**Blue-chip (2-3 queries):**

"cổ phiếu VN30 nổi bật tuần này" "blue chip VN định giá hấp dẫn"

**Mid-cap & Small-cap (3-4 queries):**

"cổ phiếu midcap VN tăng trưởng tốt 2026" "cổ phiếu vừa và nhỏ tiềm năng HOSE HNX" "cổ phiếu P/E thấp tăng trưởng cao VN" "cổ phiếu cổ tức cao vốn hóa nhỏ VN"

**Sector/Thematic (2-3 queries):**

"ngành hưởng lợi đầu tư công 2026 VN" "cổ phiếu hưởng lợi nâng hạng FTSE VN" "sector rotation chứng khoán VN xu hướng"

### Scripts hỗ trợ

**Scripts hỗ trợ** — `analyze_all.py` tích hợp tất cả. Chạy riêng lẻ khi cần:
- `scripts/market_data_fetcher.py` — Lấy giá, volume, chỉ số kỹ thuật
- `scripts/fundamental_metrics.py` — P/E, ROE, EPS growth, FCF
- `scripts/technical_calculator.py` — RSI, MACD, Bollinger Bands
- `scripts/sentiment_analyzer.py` — Phân tích sentiment tin tức
- `scripts/news_aggregator.py` — Tổng hợp tin từ nhiều nguồn
- `scripts/stock_screener.py` — Lọc cổ phiếu theo tiêu chí (nếu có)
- `scripts/forecast_engine.py` — Chạy scenario analysis (nếu có)
- `scripts/bond_analyzer.py` — YTM, duration, convexity, credit spread, allocation
- `scripts/options_calculator.py` — Black-Scholes, Greeks, IV, CW analysis
- `scripts/sector_rotation.py` — Sector performance, RS, phase detection, rotation signals

### Vòng lặp research

Sau mỗi đợt search, đánh giá: "Đã đủ data để đưa ra recommendation có conviction chưa?" Nếu chưa — search thêm. Không giới hạn số query nếu cần thiết. Chất lượng research quyết định chất lượng advisory.

## Bước 3: Screening 5 bước

Tham khảo `references/market-analyst-guide.md` mục 2 (Phân tích cơ bản) và mục 6 (Ra quyết định).

**2.1 Macro filter** — Xác định chu kỳ kinh tế (Early Recovery / Mid-Cycle / Late Cycle / Recession). Chu kỳ khác nhau ưu tiên ngành khác nhau — đầu tư công mạnh thì VLXD/thép hưởng lợi, lãi suất giảm thì BĐS/ngân hàng hưởng lợi.

**2.2 Sector filter** — Chọn ngành có: (a) dòng tiền tổ chức đang vào, (b) catalyst sắp tới, (c) hưởng lợi chính sách. Phủ cả ngành lớn (ngân hàng, BĐS, tech) VÀ ngành nhỏ hơn (cảng biển, vật liệu xây dựng, năng lượng tái tạo, thủy sản, dệt may).

**2.3 Fundamental filter** — P/E hợp lý so với đúng peer group (không so P/E ngân hàng với P/E tech), ROE > 12%, growth dương, nợ kiểm soát được.

**2.4 Technical filter** — Vùng accumulation hoặc breakout, RSI chưa quá mua, volume xác nhận xu hướng.

**2.5 Contrarian check** — Đây là bước quan trọng nhất và thường bị bỏ qua. Cho MỖI mã pick:
- Search "[ticker] rủi ro" hoặc "[ticker] bear case"
- Hỏi: "Thị trường đang price-in kỳ vọng gì? Nếu kỳ vọng đó không thành hiện thực?"
- Hỏi: "Ai đang bán mã này? Tại sao?"
- Ví dụ thực tế: FPT được nhiều analyst recommend, nhưng search "FPT rủi ro AI outsourcing" phát hiện AI đang đe dọa margin mảng IT services — rủi ro này chưa được phản ánh đầy đủ.

## Bước 4: Chấm điểm Conviction (0-100)

Cho mỗi mã, tính weighted score:
- Technical Score (25%): Trend, momentum, S/R, volume
- Fundamental Score (30%): Valuation, growth, quality
- Catalyst Score (20%): Sự kiện sắp tới, sector tailwind
- Risk Score (25%): Rủi ro thấp = điểm cao

**Red flags tự động hạ conviction** (vì chúng cho thấy rủi ro chưa phản ánh trong giá):
- Chỉ tìm thấy tin tốt, không có rủi ro → -15 (research chưa đủ sâu)
- Insider bán cổ phiếu → -20 (họ biết nhiều hơn chúng ta)
- Khối ngoại bán ròng mạnh → -10 (institutional selling thường có lý do)
- P/E cao hơn 50% so với peer → -15 (overvalued trừ khi growth justify)
- Thanh khoản  10%. Nếu < 10%, risk-adjusted return không đủ bù cho rủi ro thị trường VN.

## Bước 6: Tạo React Dashboard — LIGHT THEME

### Quy tắc giao diện

Dashboard dùng nền sáng vì dashboard tài chính chuyên nghiệp (Bloomberg Terminal là ngoại lệ) đều dùng nền sáng để dễ đọc số liệu và in ấn.

- Nền: `bg-white` hoặc `bg-gray-50`
- Header: gradient nhẹ `from-blue-600 to-blue-700 text-white` hoặc `bg-white border-b`
- Cards: `bg-white shadow-sm border border-gray-200 rounded-lg`
- Text: `text-gray-900` (chính), `text-gray-600` (phụ)
- Accent: `blue-600`, `green-600`, `red-500`, `amber-500`
- **Tuyệt đối không dùng:** `bg-gray-900`, `bg-slate-800`, `bg-slate-900`, `text-white` trên nền tối

### Cấu trúc dashboard

**1. Market Context — 3 tầng thời gian:**
- Structural (3-12 tháng): 2-3 câu chuyện lớn đang chi phối thị trường
- Developing (1-4 tuần): Diễn biến gần đây chưa kết thúc
- Breaking (24-72h): Tin mới nhất có tác động

**2. Stock Picks — Pha trộn blue-chip + mid/small cap:**
Mỗi pick card hiển thị:
- Conviction gauge + signal badge (MUA/THEO DÕI/THẬN TRỌNG)
- Badge phân loại: BLUE-CHIP / MID-CAP / SMALL-CAP
- 1-line thesis cụ thể, data-driven (không generic)
- Sub-scores bars: Technical | Fundamental | Catalyst | Risk
- Key findings với severity badges, BAO GỒM CẢ RỦI RO
- 3 kịch bản (Bull/Base/Bear) với xác suất + target giá
- Entry / Stop Loss / Take Profit
- Expandable detail section

**3. Risks to Watch** — Liệt kê 3-5 rủi ro cụ thể đang theo dõi

**4. Methodology** — Screening criteria, tại sao chọn mã này bỏ mã kia, data sources

**5. Disclaimer đầy đủ**

## Phong cách output

Đọc `references/expert_persona.md`. Viết như CIO brief cho investment committee:

- Kết luận trước, chi tiết sau
- Mỗi nhận định: Observation → Interpretation → Implication → Action
- Dùng số liệu cụ thể, so sánh peer cụ thể
- Ghi rõ thời điểm data: "(tính đến 7/4/2026)"
- Nếu thiếu data → nói rõ, không đoán

**SAI (surface-level):**
"FPT là công ty công nghệ hàng đầu, P/E 18, nên mua."

**ĐÚNG (expert-level):**
"FPT forward P/E ~15x, thấp hơn 28% so với peer IT VN (CMG 16.7x, ELC 12x). 8/8 analyst target TB 119k (+46%). TUY NHIÊN: (1) AI-native companies đang ép margin outsourcing, (2) 34% doanh thu từ Nhật — rủi ro JPY yếu, (3) downtrend chưa có reversal. Base case 50%: hồi phục 100k (+22%). Bear case 25%: giảm về 70k (-14%). Expected return +10.5% — chấp nhận được nhưng cần reversal confirmation."

## References

1. `references/market-analyst-guide.md` — Framework tư duy chuyên gia (ĐỌC TRƯỚC)
2. `references/deep_research.md` — Multi-source data strategy
3. `references/multi_timeframe_news.md` — Search 3 tầng thời gian
4. `references/expert_persona.md` — Expert reasoning pattern
5. `references/visual_templates.md` — Dashboard patterns
6. `references/fundamental_ratios.md` — Chỉ số tài chính
7. `references/indicator_guide.md` — Chỉ báo kỹ thuật
8. `references/macro_calendar.md` — Sự kiện vĩ mô
9. `references/risk_management.md` — Quản lý rủi ro
10. `references/vn_market_guide.md` — Đặc thù thị trường VN
11. `references/bond_analysis.md` — Trái phiếu & Fixed Income
12. `references/options_greeks.md` — Options, Greeks, Covered Warrants
13. `references/sector_rotation.md` — Vòng quay ngành theo chu kỳ
14. `references/upgrade_rules.md` — Quy tắc nâng cấp v5

---
## Nhắc lại: Script trước, WebSearch sau
Nếu bạn chưa lấy giá chính xác (script hoặc WebFetch VPS API), DỪNG LẠI và chạy `python scripts/analyze_all.py [TICKERS]` ngay bây giờ.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ThanhDatNgo2003](https://github.com/ThanhDatNgo2003)
- **Source:** [ThanhDatNgo2003/claude-market-skills](https://github.com/ThanhDatNgo2003/claude-market-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.