股市热点发现

通过自然语言问句识别当前市场热点，返回 Markdown 热点报告，适用场景包括：

今日市场热点总览（资讯/事件/话题）
热门股票与活跃方向识别
交易日内快速捕捉情绪变化与关注焦点

密钥来源与安全说明

本技能仅使用一个环境变量：EM_API_KEY。
EM_API_KEY 由东方财富妙想服务（https://ai.eastmoney.com/mxClaw）签发，用于接口鉴权。
在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

功能范围

基础热点能力

输入自然语言问句，调用热点发现接口生成结构化结论
覆盖热门资讯、热门股票等市场级热点信息
返回可读 Markdown 报告（优先提取 data.displayData）
支持将结果保存为本地 .md 文件，便于盘后复盘

触发规则（何时使用本技能）

用户问题是市场层面的热点发现：如“今日热点”“热股有哪些”
用户未指定单只股票/基金做深度诊断，也未要求具体指标计算
用户关注“热门、热搜、大事、活跃赛道、关注方向”等泛化主题

不触发规则（何时不要使用本技能）

用户明确询问单只股票深度分析（应走 stock-diagnosis）
用户明确询问单只基金深度分析（应走 fund-diagnosis）
用户要求具体指标计算或量化建模（MACD、回测、组合优化等）

触发示例

| 触发（热点发现） | 不触发（诊断/指标） | |---|---| | 今日热点是什么？ | 海康威视怎么样？ | | 今天最热的股票有哪些？ | 丹化科技的MACD金叉了吗？ | | 最近流行哪些投资赛道？ | 帮我建一个基金组合优化模型 |

前提条件

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 --query "今日热点"

输出示例

Saved: /path/to/workspace/stock_market_hotspot_discovery/stock_market_hotspot_discovery_90bf169c.md
（随后输出 Markdown 热点内容）

参数说明：

| 参数 | 说明 | 必填 | |---|---|---| | --query | 用户原始自然语言问句 | ✅（--query 或 stdin 二选一） | | --no-save | 仅输出结果，不写入本地文件 | 否 |

2. 代码调用

import asyncio
from pathlib import Path
from scripts.get_data import discover_hotspot

async def main():
    result = await discover_hotspot(
        question="今日热点",
        output_dir=Path("workspace/stock_market_hotspot_discovery"),
        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())

输出规范

通过脚本或工具拿到诊股结果后，对用户的可见回复必须以接口返回的 Markdown 正文为主体，避免模型二次转述。仅当接口/脚本明确返回 error、或正文为空时，才用简短文字说明失败原因；禁止在失败时杜撰报告内容。

常见问题

错误：EM_API_KEY is required.
→ 需先配置 EM_API_KEY，请联系官网获取并手动配置。

为什么有时候不会保存 md 文件？
→ 当返回为不支持场景或失败结构（如 code/status 异常、data 为空）时，脚本会只输出内容而不落盘。

如何只看输出，不落盘？

python3 -m scripts.get_data --query "今日热点" --no-save

合规说明

热点信息具有时效性，结果反映接口调用时刻的市场状态。
热点信息仅供参考，不构成投资建议，输出时应附风险提示。
禁止在代码或提示词中硬编码账号 ID、会话 ID 或 token。
接口失败时不得编造结论，应返回明确错误或不确定性说明。