Bộ công cụ dữ liệu tài chính Bigdata.com (SDK + REST)
Lấy dữ liệu tài chính có cấu trúc từ Bigdata.com (RavenPack) qua SDK chính thức và endpoint /v1 REST — báo cáo tài chính, dự phóng, chuỗi sentiment — kèm kiểm soát chi phí.
Bộ công cụ này làm gì
MCP server của Bigdata.com (RavenPack) chỉ trả về đoạn văn tóm tắt hoặc tearsheet đã tổng hợp, nên thiếu dữ liệu thô có cấu trúc để xây pipeline. Skill này đóng gói bigdata_toolkit — bọc cả SDK bigdata-client chính thức và các endpoint /v1/* REST — để bạn lấy trực tiếp:
- Chuyển tên công ty / ISIN / CUSIP / SEDOL thành
rp_entity_id(chìa khóa cho mọi truy vấn) - Dự phóng của giới phân tích, earnings surprise, lịch sự kiện, xếp hạng và giá mục tiêu
- Báo cáo KQKD, cân đối kế toán, lưu chuyển tiền tệ, chỉ số TTM (EV/EBITDA, ROE, P/E), giá OHLC ngày, cổ tức, doanh thu theo khu vực/sản phẩm
- Chuỗi sentiment theo ngày của từng thực thể, đồ thị đồng đề cập (chuỗi cung ứng, đối thủ), screener lọc universe
- Các chunk tin tức/hồ sơ/transcript kèm điểm sentiment và vị trí thực thể
Kèm theo là các biện pháp đã xử lý sẵn: dùng ChunkLimit để tránh bẫy tính phí theo tài liệu, rc() retry lỗi SSL bắt tay lần đầu, CostModel chặn tác vụ vượt ngân sách và CostTracker đo mức tiêu thụ thực tế.
Phù hợp với ai
- Nhà phân tích/quant đã có tài khoản Bigdata.com trả phí (khóa
bd_v2_) - Người cần dựng bộ dữ liệu nghiên cứu đầu tư tái lập được, thay vì hỏi đáp một lần qua MCP
- Người phải chạy backfill lớn và muốn dự toán chi phí query_unit trước khi tốn quota
Ví dụ sử dụng
- "Lập bảng dự phóng doanh thu/EPS 4 quý tới của NVIDIA và surprise gần nhất" → gọi
analyst_estimates+latest_surprise. - "Xuất CSV chuỗi sentiment theo ngày trong 6 tháng cho 30 mã trong watchlist" → dùng
entity_sentiment(endpoint miễn phí, 0 chunk). - "Lọc các công ty bán dẫn Mỹ vốn hóa trên 10 tỷ USD, kèm EV/EBITDA và ngày báo cáo tới" →
company_screener+key_metrics_ttm+events_calendar.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục daymade-financial/bigdata-skill từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/bigdata-skill/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-financial/bigdata-skill ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Clone repo trong terminal:
git clone https://github.com/daymade/claude-code-skills.git - Copy thư mục skill vào Claude Code:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-financial/bigdata-skill ~/.claude/skills/ - Khai báo khóa API dạng biến môi trường (không bao giờ hardcode):
export BIGDATA_API_KEY=bd_v2_xxxxxxxx - Tạo môi trường Python và cài SDK chính thức:
cd ~/.claude/skills/bigdata-skill && uv venv .venv --python 3.12 && uv pip install --python .venv/bin/python bigdata-client - Nếu mạng cần proxy:
export HTTPS_PROXY=http://host:port; nếu proxy chặn TLS gây lỗi SSL, dùngBigdataClient(verify_ssl="ca-cua-proxy.pem"). - Chạy smoke test:
PYTHONPATH=scripts .venv/bin/python scripts/probe_example.py(bước resolve thực thể và kiểm tra quota là miễn phí). - Khởi động lại Claude Code, rồi thử yêu cầu: "Lấy dự phóng analyst của NVIDIA từ Bigdata.com" để skill tự kích hoạt.