QVeris Finance — AI 金融数据助手

基于 QVeris 工具生态的金融数据分析 Skill，聚合 TwelveData / Finnhub / Alpha Vantage / FMP 等专业数据源，通过一次对话获取结构化金融数据和分析摘要。

能力总览

数据来源

所有数据通过 QVeris 工具网关获取。QVeris 聚合 1,000+ 数据供应商（含 TwelveData、Finnhub、Alpha Vantage、FMP 等），通过智能路由引擎自动选择最优供应商。本 Skill 不绑定任何特定供应商 — 每次调用由 QVeris discover 动态选择。

使用 QVeris 工具

本 Skill 通过 QVeris API 获取数据。检查可用调用方式并使用第一个可用的：

Tier 1 — MCP 原生工具（推荐）：如果环境中有 qveris_discover / qveris_call 或 search_tools / execute_tool，直接使用。

Tier 2 — http_request 工具：调用 QVeris REST API。

CODEBLOCK0

Tier 3 — 脚本执行（本 Skill 自带脚本）：

CODEBLOCK1

模式一：个股分析 (analyze)

触发条件

用户提到股票代码或公司名 + 分析意图：

• - "分析 AAPL" / "analyze NVDA" / INLINECODE12
• INLINECODE13 / INLINECODE14

工作流（5 步）

每步先通过 QVeris discover 搜索最优工具，按 success_rate 和 avg_execution_time_ms 选择排名最高的工具，然后 call 执行。 完整的 discover query 和预期字段定义在下方。如果 discover 无结果或首选工具失败，参考 references/tool-routing.md 中的已验证 tool_id 作为 fast-path。

Step 1: 公司概况

CODEBLOCK2

提取字段：name, exchange, sector, industry, employees, CEO, description（截取前 200 字）

Step 2: 实时行情

CODEBLOCK3

提取字段：close（当前价）, change, percent_change, volume, fifty_two_week.high, fifty_two_week.low, INLINECODE31

重要：输出中必须标注行情时间戳（datetime 字段），数据可能有 15 分钟延迟。

Step 3: 估值与财务指标

CODEBLOCK4

该类工具通常一次返回完整的估值 + 盈利 + 增长 + 效率指标，无需单独调用财务报表。

提取字段（字段名因供应商而异，按语义匹配）：

• - 估值：PE (TTM), PB, PS, EV/FCF
• 盈利：EPS (TTM), EPS 增长率, 收入增长率
• 效率：ROE, ROA
• 市值：market capitalization
• 分红：dividend yield
• 风险：beta

注意：响应可能因数据量大被截断（返回 truncated_content）。从截断内容中提取上述字段即可，无需下载完整文件。

Step 4: 分析师评级

CODEBLOCK5

提取字段：取最新一条记录的 buy, hold, sell, strongBuy, strongSell, INLINECODE39

可选加强：如果上一步的工具不含 price target，再 discover "analyst price target consensus API" 补充：
提取：price_target_high, price_target_low, INLINECODE43

Step 5: 新闻与情绪

CODEBLOCK6

提取字段：每条新闻的 title, source, time_published, overall_sentiment_label, INLINECODE48

输出格式

根据用户表达方式自动选择输出风格：

口语模式（用户问"能买吗"/"怎么样"/"帮我看看"）

CODEBLOCK7

专业模式（用户问"分析基本面"/"估值分析"/"详细报告"）

CODEBLOCK8

质量要求

• - 每个数字必须来自实际工具返回，绝不编造数据
• 必须标注数据时间戳，让用户知道数据新鲜度
• PE/PB 等指标标注口径（TTM / Annual / Quarterly）
• 分析师评级标注日期（period 字段）
• 如果某个工具调用失败，在输出中标注「该维度数据暂不可用」，不要跳过或编造

模式二：市场速览 (market)

触发条件

• - "今日市场" / "市场速览" / INLINECODE53
• INLINECODE54 / INLINECODE55

工作流（4 步）

Step 1: 美股指数 + VIX + 黄金

CODEBLOCK9

提取：S&P 500、NASDAQ、Dow Jones 的价格和涨跌幅。如果工具同时返回 VIX 和 Gold Futures，一并提取。

补充：如果 market summary 工具未覆盖所有指数，再 discover "stock quote real-time API" 逐个查询 SPX / IXIC / DJI。

Step 2: 外汇汇率

CODEBLOCK10

Step 3: 大宗商品

CODEBLOCK11

注意：如果 Step 1 已返回黄金期货价格（如 GC=F），只需补充原油价格。

Step 4: 热点新闻

CODEBLOCK12

输出格式

CODEBLOCK13

错误处理

1. 1. 工具调用失败：检查参数格式，修正后重试。如果仍失败，尝试 fallback 工具
2. 数据截断：保留 truncated_content 用于分析，告知用户完整数据可通过 full_content_file_url 获取
3. 3 次失败后：诚实报告哪些工具和参数已尝试，标注缺失的数据维度

市场代码说明

当前版本主要支持 US 市场数据。HK/CN 市场数据覆盖正在扩展中。

安全与合规

• - 仅使用 QVERIS_API_KEY，不存储其他凭证
• 仅调用 qveris.ai API（HTTPS）
• 所有输出标注「不构成投资建议」免责声明
• 不执行任何包安装或任意命令
• 不在日志或输出中暴露 API 密钥