金融资讯搜索
通过自然语言查询检索时效性金融信息，数据来自于妙想大模型，适用场景包括：
- 最新新闻与政策动态
- 公司公告与事件跟踪
- 券商研报与市场解读
- 宏观事件对市场/板块影响分析
密钥来源与安全说明
- 本技能仅使用一个环境变量：
EM_API_KEY。 EM_API_KEY由东方财富妙想服务（https://ai.eastmoney.com/mxClaw）签发，用于其接口鉴权。- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
功能范围
基础检索能力
- 检索个股、板块、主题的最新资讯
- 聚合公告、研报、新闻等公开信息
- 返回可读正文内容（优先提取
llmSearchResponse） - 支持将结果保存为本地
.txt文件，便于追溯与复盘
输入建议
- 查询建议包含至少一个明确目标：公司、板块、事件、政策或时间范围
- 对语义不清的问句，应先做一次简洁澄清再执行检索
- 汇总时保持关键数值、专有名词和原始语义不被篡改
查询示例
| 类型 | query 示例 |
|---|---|
| 个股资讯 | 格力电器最新研报与公告、寒武纪 688256 最新动态 |
| 板块/主题 | 商业航天板块近期新闻、新能源政策解读 |
| 宏观/风险 | 美联储加息对A股影响、汇率风险相关公司案例 |
| 综合解读 | 今日大盘异动原因、北向资金流向解读 |
前提条件
1. 注册东方财富妙想账号
访问 https://ai.eastmoney.com/mxClaw 注册账号并获取API_KEY。
2. 配置 Token
# macOS 添加到 ~/.zshrc，Linux 添加到 ~/.bashrc
export EM_API_KEY="your_api_key_here"
然后根据系统执行对应的命令：
macOS：
source ~/.zshrc
Linux：
source ~/.bashrc
快速开始
1. 命令行调用
python3 {baseDir}/scripts/get_data.py "寒武纪 688256 最新研报与公告"
输出示例
Saved: /path/to/workspace/mx_finance_search/mx_finance_search_90bf169c.txt
（随后输出资讯正文内容）
参数说明：
| 参数 | 说明 | 必填 |
|---|---|---|
query（位置参数） | 自然语言查询文本 | ✅（位置参数或 stdin 二选一） |
--no-save | 仅输出结果，不写入本地文件 | 否 |
2. 代码调用
import asyncio
from pathlib import Path
from scripts.get_data import query_financial_news
async def main():
result = await query_financial_news(
query="新能源板块近期政策与龙头公司动态",
output_dir=Path("workspace/mx_finance_search"),
save_to_file=True,
)
if "error" in result:
print(result["error"])
else:
print(result["content"])
if result.get("output_path"):
print("已保存至:", result["output_path"])
asyncio.run(main())
输出文件说明
| 文件 | 说明 |
|---|---|
mx_finance_search_<ID>.txt | 资讯正文文本（从返回中提取） |
返回字段说明
content：提取后的资讯正文（优先llmSearchResponse）。output_path：当save_to_file=True且有内容时，返回保存路径。raw：原始接口返回，便于调试或二次处理。error：检索失败时返回错误信息。
环境变量
| 变量 | 说明 | 默认 |
|---|---|---|
EM_API_KEY | 新闻检索接口鉴权 key（必填） | 空 |
常见问题
错误：EM_API_KEY is required.
→ 需配置EM_API_KEY，请联系官网获取并手动配置
没有传 query 时为什么直接退出？
→ 命令行会先读取位置参数 query，若为空再读取 stdin；两者都为空时打印帮助并退出。
如何只看输出，不落盘？
python3 -m scripts.get_data "商业航天板块近期新闻" --no-save
合规说明
- 禁止在代码或提示词中硬编码账号 ID、会话 ID 或 token。
- 环境变量按敏感信息处理，不在日志或回复中泄露。
- 检索失败时不得编造事实，应返回明确错误或不确定性说明。
- 输出应保持可追溯、可审计。