前言¶
在 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。
