Mx Finance Search

--- name: mx-finance-search description: 基于东方财富数据库，支持自然语言搜索全网最新公告、研报、财经新闻、交易所动态及官方政策等，覆盖全球市场标的，可用于热点捕捉、舆情监控、研报速览、公告精读及投资决策等场景。Natural language search for financial information, covering authoritative sources including news, announcements, research reports, and policies. Supporting global market assets, it is applicable to event tracking, market sentiment monitoring, announcement analysis, and investment decision-making, helping users obtain authoritative financial information and capture timely market signals. metadata: { "openclaw": { "requires": { "env":["EM_API_KEY"] } } } --- # 金融资讯搜索 通过**自然语言查询**检索时效性金融信息，数据来自于妙想大模型，适用场景包括： - **最新新闻与政策动态** - **公司公告与事件跟踪** - **券商研报与市场解读** - **宏观事件对市场/板块影响分析** ## 密钥来源与安全说明 - 本技能仅使用一个环境变量：`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 ```bash # macOS 添加到 ~/.zshrc，Linux 添加到 ~/.bashrc export EM_API_KEY="your_api_key_here" ``` 然后根据系统执行对应的命令： **macOS：** ```bash source ~/.zshrc ``` **Linux：** ```bash source ~/.bashrc ``` ## 快速开始 ### 1. 命令行调用 ```bash python3 {baseDir}/scripts/get_data.py "寒武纪 688256 最新研报与公告" ``` **输出示例** ```text Saved: /path/to/workspace/mx_finance_search/mx_finance_search_90bf169c.txt （随后输出资讯正文内容） ``` **参数说明：** | 参数 | 说明 | 必填 | |---|---|---| | `query`（位置参数） | 自然语言查询文本 | ✅（位置参数或 stdin 二选一） | | `--no-save` | 仅输出结果，不写入本地文件 | 否 | ### 2. 代码调用 ```python 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_.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；两者都为空时打印帮助并退出。 **如何只看输出，不落盘？** ```bash python3 -m scripts.get_data "商业航天板块近期新闻" --no-save ``` ## 合规说明 - 禁止在代码或提示词中硬编码账号 ID、会话 ID 或 token。 - 环境变量按敏感信息处理，不在日志或回复中泄露。 - 检索失败时不得编造事实，应返回明确错误或不确定性说明。 - 输出应保持可追溯、可审计。