# Mx Search

> 本skill基于东方财富妙想搜索能力，基于金融场景进行信源智能筛选，用于获取涉及时效性信息或特定事件信息的任务，包括新闻、公告、研报、政策、交易规则、具体事件、各种影响分析、以及需要检索外部数据的非常识信息等。避免AI在搜索金融场景信息时，参考到非权威、及过时的信息。

- Skill: `datawhalechina/mx-search` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add datawhalechina/mx-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datawhalechina/mx-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: datawhalechina (https://skillmd.com/u/datawhalechina)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/datawhalechina/mx-search

---


# mx-search 妙想资讯搜索 skill

本 Skill 基于东方财富妙想搜索能力，基于金融场景进行信源智能筛选，用于获取涉及时效性信息或特定事件信息的任务，包括新闻、公告、研报、政策、交易规则、具体事件、各种影响分析、以及需要检索外部数据的非常识信息等。避免AI在搜索金融场景信息时，参考到非权威、及过时的信息。

## 功能说明

根据**用户问句**搜索相关**金融资讯**，获取与问句相关的资讯信息（如研报、新闻、解读等），并返回可读的文本内容。

## 配置

- **API Key**: 通过环境变量 `MX_APIKEY` 设置
- **默认输出目录**: `/root/.openclaw/workspace/mx_data/output/`（自动创建）
- **输出文件名前缀**: `mx_search_`
- **输出文件**:
  - `mx_search_{query}.txt` - 提取后的纯文本结果
  - `mx_search_{query}.json` - API 原始 JSON 数据

## 使用方式（直接 Python 脚本调用）

1. 需要用户在妙想Skills页面获取apikey。
2. 将apikey存到环境变量，命名为MX_APIKEY：
   ```bash
   export MX_APIKEY=your_apikey_here
   ```
3. 直接运行 Python 脚本搜索，支持自然语言问句：

```bash
# ==================== 常用调用示例 ====================

# 1. 个股相关资讯
python ./mx_search.py "东方财富最新公告"
python ./mx_search.py "贵州茅台最新研报"
python ./mx_search.py "比亚迪机构观点汇总"

# 2. 行业/板块新闻
python ./mx_search.py "人工智能板块近期新闻"
python ./mx_search.py "新能源汽车产业政策最新解读"

# 3. 宏观经济与市场分析
python ./mx_search.py "美联储加息对A股影响分析"
python ./mx_search.py "今日大盘异动原因分析"
python ./mx_search.py "北向资金最新流向解读"

# 4. 个股事件
python ./mx_search.py "贵州茅台分红派息实施公告"
python ./mx_search.py "宁德时代定增预案解读"

# 5. 交易规则
python ./mx_search.py "科创板交易涨跌幅限制"
python ./mx_search.py "新股申购规则"

# 6. 指定输出目录（可选）
python ./mx_search.py "格力电器最新研报" /path/to/output
```

   > ⚠️ **安全注意事项**
   >
   > - **外部请求**: 本 Skill 会将您的查询文本发送至东方财富官方 API 域名 ( `mkapi2.dfcfs.com` ) 以获取金融数据。
   > - **凭据保护**: API Key 仅通过环境变量 `MX_APIKEY` 在服务端或受信任的运行环境中使用，不会在前端明文暴露。

## 输出说明

脚本执行后会：
1. 在终端格式化输出搜索结果，列出每条资讯的标题、来源、日期、内容
2. 自动创建输出目录 `/root/.openclaw/workspace/mx_data/output/`
3. 保存纯文本提取结果到 `.txt` 文件
4. 保存原始 JSON 响应供二次处理

## 异常情形与处理方式

| 异常情形 | 可能原因 | 处理方式 |
|----------|----------|----------|
| **connect: Connection refused** | 网络无法访问 mkapi2.dfcfs.com | 检查服务器网络配置，确保能访问公网 |
| **401 Unauthorized / API密钥不存在** | API Key 错误或已失效 | 前往妙想Skills页面重新获取 API Key 并更新环境变量 |
| **code=113 / 今日调用次数已达上限** | 当日调用次数超限 | 前往妙想Skills页面获取更多调用次数 |
| **未找到相关资讯** | 关键词太偏门或没有最新相关信息 | 尝试更换关键词，或扩大搜索范围 |
| **返回内容为空** | 网络中断或请求超时 | 检查网络后重试 |
| **JSON解析错误** | 网络不完整导致内容截断 | 检查网络后重试 |

## 问句示例

|类型|示例问句|
|----|----|
|个股资讯|格力电器最新研报、贵州茅台机构观点|
|板块/主题|商业航天板块近期新闻、新能源政策解读|
|宏观/风险|A股具备自然对冲优势的公司 汇率风险、美联储加息对A股影响|
|综合解读|今日大盘异动原因、北向资金流向解读|

## 返回说明

|字段路径|简短释义|
|----|----|
|`title`|信息标题，高度概括核心内容|
|`secuList`|关联证券列表，含代码、名称、类型等|
|`secuList[].secuCode`|证券代码（如 002475）|
|`secuList[].secuName`|证券名称（如立讯精密）|
|`secuList[].secuType`|证券类型（如股票 / 债券）|
|`trunk`|信息核心正文 / 结构化数据块，承载具体业务数据|