前言¶
在 DSH 插件生態中，針對特定區域市場的數據接入往往需要開發者自行解決。xby-vnstock 是一個面向越南市場的聯網工具插件，旨在解決 DSH 在越南股市數據獲取上的空白。
該插件是一個非官方的 MCP 服務器，提供了訪問越南證券交易所數據的接口，涵蓋實時和歷史股票價格、公司財務數據、市場統計以及基金信息。
核心功能¶
插件提供的工具主要分爲市場數據、公司詳情、財務報表、基金信息以及系統配置五類。
市場數據¶
- list_all_icb_industries：獲取所有 ICB 行業分類。
- list_all_companies_with_details：列出市場所有公司及其詳情。
- get_all_symbol_groups：獲取所有股票代碼分組。
- get_all_symbols_by_group：按分組獲取所有股票代碼。
- get_all_symbols_by_industry：按 ICB 行業獲取所有股票代碼。
- get_all_symbols：獲取所有股票代碼。
- get_all_symbols_detailed：獲取所有股票代碼的詳細信息。
- get_gold_price：獲取黃金價格。
公司詳情¶
- get_company_overview：獲取公司概覽。
- get_company_news：獲取公司新聞。
- get_company_events：獲取公司重大事件。
- get_company_shareholders：獲取公司股東信息。
- get_company_officers：獲取公司高管信息（可過濾在職或離職）。
- get_company_subsidiaries：獲取公司子公司信息。
- get_company_reports：獲取公司報告。
- get_company_dividends：獲取公司分紅信息。
- get_company_insider_deals：獲取公司內部交易數據。
- get_company_ratio_summary：獲取公司財務比率摘要。
- get_company_trading_stats：獲取公司交易統計數據。
財務報表¶
- get_income_statements：獲取利潤表（支持季度或年度）。
- get_balance_sheets：獲取資產負債表（支持季度或年度）。
- get_cash_flows：獲取現金流量表（支持季度或年度）。
- get_finance_ratios：獲取財務比率。
- get_raw_report：獲取原始報告。
基金信息¶
- list_all_funds：列出所有基金（可按類型篩選）。
- search_fund：通過關鍵詞搜索基金。
- get_fund_nav_report：獲取基金淨值報告。
- get_fund_top_holding：獲取基金前十大持倉。
- get_fund_industry_holding：獲取基金行業持倉。
- get_fund_asset_holding：獲取基金資產持倉。
系統配置¶
- set_xby_apikey：設置 API 密鑰（自動持久化，重啓有效）。
典型用法¶
使用該插件前，通常需要先設置 API 密鑰以通過身份驗證。
獲取公司概覽¶
調用 get_company_overview 工具，傳入公司代碼 symbol 和輸出格式。
獲取財務報表¶
獲取資產負債表或利潤表時，需指定 period 參數（’quarter’ 或 ‘year’）。
獲取基金信息¶
先通過 search_fund 搜索目標基金，再調用 get_fund_nav_report 獲取詳細淨值數據。
安裝與啓用¶
官方未提供具體的安裝命令。該插件由 xby-skill 維護，可以通過目錄頁或 GitHub 倉庫獲取。
- 目錄頁: https://www.skillhub.cn/plugins/xby-skill/xby-vnstock
- GitHub: https://github.com/xby-skill/xby-vnstock
適用場景與注意¶
- 適用場景: 適合需要進行越南市場分析、公司財務研究或基金投資的開發者。
- 注意事項:
- 該插件爲非官方 MCP 服務器，數據源需自行評估可靠性。
- 插件以當前 DSH 進程的權限運行，使用前建議檢查源碼與許可證（MIT）。
- 輸出格式支持
json、dataframe和toon（針對 AI 優化的格式）。
總結¶
xby-vnstock 爲 DSH 插件生態補充了越南股市的數據維度。通過提供從宏觀行業分類到微觀公司財務報表的完整工具鏈，它可以幫助開發者構建針對越南市場的智能分析應用。更多細節可參考 GitHub。
