越南股市数据服务

解决什么问题

在做越南股市的数据分析或量化回测时，工程师常面临数据源分散的问题。个股的财务三表、公司治理信息、基金持仓往往散落在不同官网，而实时行情与技术指标接口更是难以统一调度。本技能旨在将越南股市的多维度数据整合到一个非官方 MCP 服务中，让大模型能够直接通过工具调用获取结构化数据，无需人工去多个站点爬取和清洗。

核心能力与工作流

该技能本质是一个数据路由层，核心能力覆盖以下数据域：

• 行情与指标：支持分钟级到月级的 K 线数据（get_quote_history_price），并可携带自定义参数的技术指标（如 rsi(window=21)）。
• 基本面数据：提供利润表、资产负债表、现金流量表（get_income_statements 等），以及公司高管、股东、子公司等治理数据。
• 基金与宏观：支持查询基金净值、行业及资产配置，以及黄金价格（SJC/BTMC）和全币种汇率。

关键执行步骤：

1. 密钥鉴权：技能启动时会检查 XBY_APIKEY 配置。若为空，会主动向用户询问密钥，并调用 scripts.config.set_api_key 进行持久化保存。
2. 意图路由：大模型解析用户需求（如“查询 FPT 公司的年度利润表”），提取 symbol 和 period 参数。
3. 数据调用：通过 scripts.tools 下的对应函数获取数据，默认返回对 AI 优化的 toon 格式或 DataFrame。

适用边界与注意点

• 官方非背书：这是非官方数据服务，适用于研发调试与个人分析，不建议直接用于对数据精度有极高要求的生产环境。
• 密钥强制：缺少 XBY_APIKEY 时，技能会阻断请求并拒绝编造数据，使用者需确保密钥配置正确。
• 输出格式：toon 格式专为大模型上下文优化，若需进一步进行 Pandas 分析，建议在参数中指定 output_format='dataframe'。