东方财富金融工具集

# 东方财富金融工具集 (eastmoney-tools)

统一入口，根据用户 query 自动路由到合适的 API。支持多 API Key 轮换。

API Key 配置

方式 1：单 Key（环境变量）

```bash export EASTMONEY_APIKEY="your-api-key" ```

方式 2：多 Key 轮换（vault）

从 vault 读取多个 key，按顺序轮换：

```bash cat ~/.openclaw/workspace/vault/credentials/eastmoney.json ```

vault 文件格式： ```json { "name": "Eastmoney API Keys", "keys": [ "mkt_xxx1", "mkt_xxx2", "mkt_xxx3" ] } ```

获取 Key

如果没有设置 `EASTMONEY_APIKEY`，从 vault 读取： ```bash cat ~/.openclaw/workspace/vault/credentials/eastmoney.json ```

路由规则

根据用户意图自动判断调用哪个 API：

| 用户意图关键词 | 路由到 | API 端点 | |---------------|--------|----------| | 选股、推荐股票、条件筛选、符合xx的股票、成分股 | 选股 | `/finskillshub/api/claw/stock-screen` | | 新闻、资讯、消息、公告、研报、政策、解读 | 资讯搜索 | `/finskillshub/api/claw/news-search` | | 股价、市值、PE、市盈率、财报、盈利、利润、收入、资金流向、基本面 | 数据查询 | `/finskillshub/api/claw/query` |

API 调用

公共配置

```bash API_BASE="https://mkapi2.dfcfs.com" ```

多 Key 轮换逻辑

1. 优先使用环境变量 `EASTMONEY_APIKEY`
2. 如果环境变量未设置，从 vault 读取多个 key
3. 按顺序尝试每个 key
4. 如果返回 `status != 0`（限流或错误），自动切换下一个 key
5. 所有 key 都失败后返回错误

1. 选股 API

```bash curl -X POST "${API_BASE}/finskillshub/api/claw/stock-screen" \ -H "Content-Type: application/json" \ -H "apikey: ${API_KEY}" \ -d '{"keyword": "用户查询", "pageNo": 1, "pageSize": 20}' ```

• 适用场景：
• 条件选股："今日涨幅2%的股票"、"市盈率低于10的银行股"
• 板块成分股："半导体板块的成分股"
• 股票推荐："低估值高分红的股票推荐"

2. 资讯搜索 API

```bash curl -X POST "${API_BASE}/finskillshub/api/claw/news-search" \ -H "Content-Type: application/json" \ -H "apikey: ${API_KEY}" \ -d '{"query": "用户查询"}' ```

• 适用场景：
• 个股资讯："格力电器最新研报"
• 板块新闻："新能源政策解读"
• 宏观分析："美联储加息对A股影响"

3. 数据查询 API

```bash curl -X POST "${API_BASE}/finskillshub/api/claw/query" \ -H "Content-Type: application/json" \ -H "apikey: ${API_KEY}" \ -d '{"toolQuery": "用户查询"}' ```

• 适用场景：
• 行情数据："贵州茅台最新价"
• 财务指标："宁德时代市盈率"
• 公司信息："比亚迪主营业务"

错误处理

• 自动重试：当某个 key 被限流（返回非 status=0），自动切换到下一个 key
• 保持返回原始 JSON 格式，不做转换