朝阳永续-金融数据查询
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-w1ar0msk--suntime-find-fin-data.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-w1ar0msk/suntime-find-fin-data。- 本技能为金融数据聚合工具,覆盖 A 股/港股/美股/指数/板块/ETF/可转债的行情、K 线、财务、资金流、估值、技术指标、批量选股及分析师一致预期,适用于查询各类证券数据、批量选股及获取预期指标等场景。首次使用前需访问朝阳永续-AI开放平台 (https://open.go-goal.com/) 注册并登录账户,获取API Key,并在首次调用时输入&qu…
- 请调用 朝阳永续金融数据查询 skill,查询「比亚迪最新一致预期盈利预测和实时行情」,我的 API Key 是:XXXX"
- 完成配置。
阅读全文 (展开查看完整说明)
概述
suntime-find-fin-data
聚合取数 skill:把 suntime-stock / suntime-stock-nl / suntime-etf / suntime-convertible-bond 四个结构化 MCP 统一在一个入口下。
依赖: suntime-mcp-cli CLI(安装、鉴权、--params 写法见 references/mcp-cli.md)。
前置条件
首次使用按 references/mcp-cli.md「快速开始」完成环境准备(安装 CLI → 配置 Key → 注册本 skill 涉及的 4 个 MCP → 验证,约 2 分钟);已就绪可跳过。
运行时错误处理(调用失败时自动引导)
以下两类错误改参数无法解决,需自动为用户打开浏览器引导处理(无图形界面的云端环境改为直接把链接给用户)。按调用输出中的关键词匹配,不依赖退出码:
| 调用输出包含 | 含义 | 自动执行 |
|---|---|---|
账户积分余额不足 | Key 有效但积分耗尽 | 打开 https://open.go-goal.com?channel=qw 引导充值购买积分,到账后直接重试原命令(无需改任何配置) |
AccessKey 未设置 / KEY_MISSING / Unauthorized / 401 | Key 未配置或已失效 | 打开 https://open.go-goal.com?channel=qw 首页点「获取 API KEY」申领,配置环境变量 SUNTIME_API_KEY 后重试 |
打开浏览器命令:macOS open <url>;Windows start <url>;Linux xdg-open <url>。
其余技术性错误(JSON 引号、session 过期、工具名拼错、类型拦截等)AI 可按 CLI 提示自行修正,完整对照见
references/mcp-cli.md「故障排查」。
推荐工作流:先发现,再取数
MCP 工具规模庞大,先用 scripts/analyze.py 智能发现工具,避免盲读子文档:
python3 scripts/analyze.py "贵州茅台的资金流向" # 自动识别 MCP + 拉取相关工具清单
python3 scripts/analyze.py "选ROE>20%的白酒股" --batch # 自动匹配场景并批量执行
python3 scripts/analyze.py --list-scenarios # 查看内置批量场景(含触发关键词与工具链)发现工具后,再按下方路由进入对应子文档确认入参细节。更多 analyze.py 用法(--top/--mcp/--parallel/--compact/自定义 batch 等)见 python3 scripts/analyze.py --help。
analyze.py --batch会直接执行内置场景模板中的工具调用,工具名来自预定义模板、无需手动输入,因此这条路径不需要人工校验。手动构造或从文档复制的调用命令,由 CLI 内置校验自动把关。
快速路由
| 问题类型 | 目标子文档 |
|---|---|
| 含"ETF/场内基金"或代码 5 开头.SH / 15 开头.SZ | references/etf.md |
| 含"可转债/转债/转股价/溢价率/双低/下修"或代码 11/13 开头.SH / 12 开头.SZ | references/convertible-bond.md |
| 上述两类排除后,A/H/美股/指数/板块(优先) | references/stock.md |
| stock 无工具或需串行 3+ 次 / 批量选股 | references/stock-nl.md |
各子文档工具速查表中带 ⭐ 的为 T1 核心工具(共 20 个,覆盖 80%+ 场景),优先尝试。
完整路由表(T1/T2 分层、业务速查、跨 MCP 协作矩阵)见
references/routing-map.md。
MCP 工具质量说明(重要)
suntime-stock(固定结构化参数)的调用质量和效率高于 suntime-stock-nl(自然语言参数)。
| MCP | 参数类型 | 调用质量 | 优先级 |
|---|---|---|---|
suntime-stock | 固定结构化参数(sec_id / start_date / report_year 等) | ✅ 高效、字段精确、口径可控 | 优先使用 |
suntime-stock-nl | 自然语言 query(NL 意图识别) | ⚠️ 灵活但字段口径不可控,效率略低 | 仅在下列情况使用 |
使用 suntime-stock-nl 的三个前提(满足任意一个才选 suntime-stock-nl):
suntime-stock没有对应工具(如单季度财务、大宗交易明细、增减持明细、港股/美股底层明细等)suntime-stock需要串行调用 3 次以上才能组合出同等结果(如批量选股涉及 5+ 维度)- 用户明确需要批量多股横向筛选(350+ 指标复合条件,
hs_stk_screening一句话完成)
路由判定规则(按优先级)
- ETF 走 etf:标的后缀
.SH/.SZ且名称含 "ETF",或显式提到 "ETF/场内基金",或代码段为 5 开头.SH、15 开头.SZ→ ETF 子文档 - 可转债走 bond:含"可转债/转债/转股/溢价率/双低/下修",或代码段为 11/13 开头
.SH、12 开头.SZ→ convertible-bond 子文档 - 优先 suntime-stock:ETF/可转债/资讯场景排除后,先查 stock 子文档能否满足,能满足的一律用 stock(参数固定、质量更高)
- 再考虑 suntime-stock-nl:stock 不能满足,或 stock 需多次调用才能完成时,转 stock-nl 子文档
- 跨 MCP 协作:4 个 MCP 可组合使用,如单股深度研究 = stock(数据)+ financial-docs(公告研报,独立 skill);可转债深度研究 = bond(估值条款)+ stock(正股行情)
标准调用流程(必须遵守)
每次构造工具调用前,都必须经过以下四步,不得跳过第 1-2 步。
# ── 第 0 步:标的识别(标的不明确时必做)─────────────────────────────
suntime-mcp-cli suntime-stock recognize_security --params '{"question":"<用户描述>"}' # A股/港股/美股/指数/板块
suntime-mcp-cli suntime-etf recognize_etf --params '{"question":"<用户描述>"}' # ETF
# ── 第 1 步:确认工具名(从子文档选定候选后,用 tool_list 核验拼写;加 --refresh 可强制刷新缓存)
suntime-mcp-cli <mcp_name> tool_list 2>&1 | grep "^- "
# ── 第 2 步:查参数 schema(每次调用前必做,本地缓存零网络开销)──────
suntime-mcp-cli <mcp_name> tool_list 2>&1 | grep -A 40 "^- <tool_name>$"
# 重点确认:① required 里有哪些参数 ② 每个参数的 type(integer / string)
# ③ 枚举值(kline_type / report_quarter 等) ④ sec_id 还是 sec_ids
# ── 第 3 步:调用────────────────────────────────────────────────
suntime-mcp-cli <mcp_name> <tool_name> --params '<JSON>'本 skill 文档静态维护,以
tool_list实时输出的 schema 为最终权威;tool_list本地缓存 1 小时,缓存命中时纯本地执行,零网络开销。
CLI 内置校验行为(第 3 步的保障层)
CLI 发出请求前自动校验工具名 / 必填参数 / 参数类型,报错时给出候选工具与修正命令(详见 references/mcp-cli.md「调用前校验」节)。
⚠️ CLI 校验是兜底保障,不是替代第 1-2 步的理由。先查 schema 再调用,才能在构造参数时就做对,而不是靠报错来纠正。
详细参数格式与时间约定见 references/_common.md(含 sec_id 格式、日期格式、主体识别前置规则、limit 参数、并行调用建议)。
高频注意事项
- 工具名严格匹配:禁止凭记忆猜工具名,必须通过第 1 步
tool_list核验。报「工具不存在」(退出码 3)或ROUTE_ERROR时必须看 CLI 给出的候选,禁止连续换名字盲试。 sec_idvssec_ids:必须通过第 2 步查 schema 确认单复数。单数只能传一个标的;复数的分隔符以各工具 schema 为准(suntime-stock/suntime-etf用;,suntime-convertible-bond同样用;),最多 100 个,超出需分批调用。
参数类型、日期格式、
limit负数、并行调用建议、错误码对照等完整说明,见references/_common.md。