firma: CLI quản lý tài sản local-first biến Claude thành trợ lý AI cho danh mục đầu tư của tôi

Nhiều người khi đầu tư cổ phiếu nước ngoài thường quản lý danh mục bằng Google Spreadsheets.
firma là một công cụ CLI quản lý tài sản local-first giúp giải quyết sự bất tiện đó.

Tính năng chính

• firma show portfolio: xem nhanh P&L của các mã đang nắm giữ, giá vốn trung bình và giá thị trường (tự động đồng bộ giá qua Finnhub)
• firma add txn: ghi lại mua/bán/cổ tức/thuế
• firma report: xu hướng tài sản ròng theo tháng, biểu đồ dòng tiền
• firma show earnings/financials/news <ticker>: tra cứu kết quả kinh doanh/tài chính/tin tức dựa trên Finnhub
• Hỗ trợ --json cho mọi lệnh đọc, để AI có thể sử dụng theo cách scriptable

Tích hợp MCP

Chỉ với một lần chạy firma mcp install, công cụ sẽ được đăng ký làm máy chủ MCP trong Claude Desktop. Sau đó có thể có những cuộc hội thoại như sau:

"Hôm nay TSLA giảm mạnh, tỷ trọng của nó trong danh mục của tôi đang là bao nhiêu?"
→ Claude truy vấn trực tiếp DB để trả lời ngay số lượng đang nắm giữ, tỷ trọng hiện tại và lãi/lỗ so với giá vốn trung bình

"Vì sao chi tiêu tháng này lại cao thế?"
→ Phân tích dữ liệu dòng tiền theo tháng và so sánh với tháng trước

Claude không chỉ đơn thuần trò chuyện mà còn trực tiếp xử lý cả việc ghi nhận giao dịch và nhập số dư.

Local-first

Mọi dữ liệu chỉ được lưu trong ~/.firma/firma.db (SQLite). Không có gì được gửi lên máy chủ bên ngoài. Việc tra giá được gọi trực tiếp bằng khóa API Finnhub của chính bạn.

Cài đặt

$ npm install -g firma-app  
$ firma config set finnhub-key YOUR_KEY  
$ firma mcp install  # Khởi động lại Claude Desktop là xong  

[bboydart91]

Tôi đăng vào rạng sáng rồi đi ngủ, đến khi thức dậy thì đã có đóng góp đầu tiên rồi. Cảm ơn mọi người.

Sau khi ra mắt, tôi có thể thấy các con số trong danh mục, nhưng lại không thể nhìn ra chúng đang liên kết với thị trường hiện tại như thế nào.
Thiếu những thông tin như trong giai đoạn lãi suất tăng thì tỷ trọng cổ phiếu công nghệ có ổn không, hay đồng USD mạnh lên thực sự ảnh hưởng đến lợi suất đến mức nào.

Vì vậy tôi đã nhanh chóng bổ sung tính năng macro và tính năng đánh giá mức độ tập trung (rủi ro) của danh mục.

• firma show macro — ảnh chụp nhanh vĩ mô dựa trên FRED. 8 chỉ số gồm lãi suất cơ bản, lợi suất trái phiếu chính phủ, CPI, tỷ lệ thất nghiệp, v.v.
• firma show concentration — phân tích mức độ tập trung của danh mục bằng HHI. Theo mã cổ phiếu/tiền tệ/ngành/quốc gia.
• firma brief — bản tin hằng ngày dựa trên các mã đang nắm giữ. Biến động lớn, tin tức, lịch công bố kết quả kinh doanh.
• Áp dụng FX thời gian thực cho toàn bộ danh mục.

Thông qua Claude Desktop, bạn có thể hỏi ngay những câu như "Danh mục của tôi thế nào trong môi trường lãi suất hiện tại?".