mx-finsearch

name	MX_FinSearch
description	支持自然语言检索全网实时金融信息，依托东方财富专业数据库，含证监会指定公告、券商研报、权威财经新闻、交易所实时动态及官方政策等高质信源，覆盖全球市场标的，可用于热点捕捉、舆情监控、研报速览、公告精读及投资决策等场景，助力高效获取权威金融资讯，掌握全市场信息先机。
metadata	{"openclaw":{"requires":{"env":["EM_API_KEY"],"bins":["python3","pip3"]}}}

金融资讯搜索

通过自然语言查询检索时效性金融信息，数据来自于妙想大模型，适用场景包括：

• 最新新闻与政策动态
• 公司公告与事件跟踪
• 券商研报与市场解读
• 宏观事件对市场/板块影响分析

密钥来源与安全说明

• 本技能仅使用一个环境变量：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

# 添加到 ~/.zshrc
export EM_API_KEY="your_api_key_here"

然后执行：

source ~/.zshrc

快速开始

1. 命令行调用

python3 -m {baseDir}/scripts/get_data.py "寒武纪 688256 最新研报与公告"

输出示例

Saved: /path/to/workspace/MX_FinSearch/financial_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/financial_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())

输出文件说明

文件	说明
financial_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。
• 环境变量按敏感信息处理，不在日志或回复中泄露。
• 检索失败时不得编造事实，应返回明确错误或不确定性说明。
• 输出应保持可追溯、可审计。