financial-expert

---
name: financial-expert
description: >-
license: Apache-2.0
---

# 金融数据分析

通过百炼 CLI `bl mcp` 调用金融 MCP `market-cmapi00073529`。只返回数据与中立分析，不下单、不荐股、不预测涨跌。

## 能力边界

- 适用：A 股筛选；A 股、港股、基金、债券、指数等结构化查询；基金和基金经理筛选；中国及全球主要经济体宏观/行业时序；券商研报；A 股、港股公司及公募基金公告；财经新闻；企业工商、合规与司法风险。
- 不适用：美股个股、加密货币等未被实时 schema 证实的证券或资产；交易下单；无数据依据的投资结论。全球宏观指标不受此限制。
- 工具能力可能更新。执行前以 `bl mcp tools --server market-cmapi00073529 --output json` 返回的实时 schema 为准。

## 前置检查与鉴权

```bash
bl --version
bl auth status --output json
```

未安装时按 [百炼 CLI 安装文档](https://bailian.aliyun.com/cli/install.md) 安装。API Key 可通过环境变量或 CLI 配置：

```bash
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
# 或
bl auth login --api-key "YOUR_DASHSCOPE_API_KEY"
```

鉴权边界：

- `bl mcp list` 查询账号控制面，使用 Console 登录态。只有需要发现 Server Code 时才调用；国内站登录使用 `bl auth login --console --console-site domestic`。
- `bl mcp tools` 与 `bl mcp call` 使用 API Key。已知 Server Code 时，即使 Console 会话过期，也应直接查询 tools 或调用工具。

```bash
# 可选：发现已激活的金融 MCP（Console）
bl mcp list --name 金融 --output json

# 权威：查看实时工具与入参 schema（API Key）
bl mcp tools --server market-cmapi00073529 --output json
```

## 工具路由

| 用户意图 | MCP 工具 | 说明 |
|---|---|---|
| 筛选股票 | `SmartStockSelection` | A 股候选清单 |
| 筛选基金 | `SmartFundSelection` | 基金业绩、风险、持仓、类型 |
| 筛选基金经理 | `SmartFundManagerSelection` | 规模、业绩、风格、风险控制 |
| 财务、行情、估值、证券资料 | `FinQuery` | A 股、港股、基金、债券、指数等结构化数据 |
| 全球 GDP、CPI、核心 PCE、行业产销价 | `MacroIndustryData` | 中国及全球主要经济体宏观和行业时序数据 |
| 公司或行业券商研报 | `FinancialResearchReport` | 研报原文与机构观点 |
| 公司或基金公告 | `AnnouncementData` | A 股、港股公司及公募基金公告 |
| 财经新闻与公开动态 | `NewsDataQuery` | 新闻、事件与舆情素材 |
| 企业深度信息 | `IcEnterpriseDataQuery` | 工商、经营、合规与司法风险 |

复杂问题应分别调用相关工具，再对齐实体、日期、单位和口径；不要让一个宽泛 query 替代多工具核验。涉及“前 N / Top N”时必须先确定排序指标；排序指标不明确时先追问，再通过 query 和 `topk` 固化口径。

## 调用格式

所有工具使用 `--target <server.tool>`：

```bash
bl mcp call \
  --target market-cmapi00073529.FinQuery \
  --query "查询贵州茅台（600519.SH）最近一个完整财年的营业收入、归母净利润和 ROE" \
  --output json
```

结构化参数必须先查看实时 schema：

```bash
bl mcp call \
  --target market-cmapi00073529.SmartStockSelection \
  --json '{"query":"筛选 ROE 大于 15% 且净利润增速超过 20% 的消费股"}' \
  --output json
```

## 时间与数据口径

- 用户说“最新”“最近一个完整财年”时，先运行 `TZ=Asia/Shanghai date '+%F %T %Z'` 获取实际查询时间；不要自行写死年份。
- 让工具按相对时间查询，并检查返回的报告期是否真是最新已披露期间。若只返回更早期间，明确说明，不得静默替代。
- 区分实际查询时间、行情交易时间、财报报告期和研报/公告发布时间。

## 输出规范

- 筛选与结构化数据：Markdown 表格，包含名称、代码、期间、数值、单位和来源。
- 宏观/行业时序：时序表格 + 一句话趋势，区分同比和环比。
- 研报：标题、日期、机构，每篇最多 3 条观点；机构评级只能作为来源事实转述。
- 公告：标题、日期、主体、披露事项；新闻和企业信息注明对应工具。
- 结尾注明：实际查询时间、调用的工具、`market-cmapi00073529`，以及“仅供数据参考，不构成投资建议”。
- 空结果、冲突数据或缺失指标必须如实说明；保留工具返回的单位和有效精度，不编造、不擅自换口径。

## 常见错误

| 现象 | 处理 |
|---|---|
| `Unexpected argument: market-...` | 使用 `tools --server` 或 `call --target`，不要再传位置参数 |
| `mcp list` 提示 Console token/session 缺失 | 如确需发现服务，按站点登录 Console；已知 Server Code 则跳过 list |
| `mcp tools` / `mcp call` 返回 401 或 API Key 缺失 | 检查 `DASHSCOPE_API_KEY` 或运行 `bl auth login --api-key ...` |
| 提示 MCP 未开通或不存在 | 打开错误中的市场链接，在当前账号/Workspace 激活服务后重试 |
| `isError: true` | 原样读取 `result.content[].text`，补全实体、代码、指标或时间范围后重试 |
| 无结果 | 核对全称、简称、证券代码和日期；征得用户同意后再放宽条件 |

## 端到端示例

用户问：“筛选 ROE > 15% 且近三年净利润复合增速 > 20% 的消费股，按 ROE 从高到低取前三家公司，再看它们近一个月研报。”

```bash
bl mcp call \
  --target market-cmapi00073529.SmartStockSelection \
  --query "ROE 大于 15%，近三年净利润复合增速大于 20% 的消费股，按 ROE 从高到低排序" \
  --arg topk=3 \
  --output json

# 从真实返回中取前三名，逐家公司调用；不要预设公司名单
bl mcp call \
  --target market-cmapi00073529.FinancialResearchReport \
  --query "<公司名称或代码>近一个月券商研报核心观点" \
  --output json
```

汇总候选指标和研报事实，注明来源与时间，不输出买卖建议。