topic-research-report

Files (3)

• SKILL.md
• manifest.json
• get_data.py · scripts/

SKILL.md (first lines)

# 专题研究报告

通过**自然语言 query**生成专题研究报告，返回 Markdown 正文及分享信息，适用场景包括：
- **事件驱动研究（政策、国际事件、宏观变化）**
- **主题投资研究（赛道、技术趋势、概念演化）**
- **跨行业影响分析（单一行业难覆盖的问题）**
- **快速输出可分享的专题深度内容**

## 密钥来源与安全说明

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

## 功能范围

### 基础生成能力
- 输入专题 query，调用专题研究接口生成完整报告
- 返回报告标题、正文、文章ID、分享链接及附件路径等结构化字段
- 若返回 `wordBase64/pdfBase64`，自动解码保存为本地 `.docx/.pdf` 附件

### 触发规则（何时使用本技能）
- 用户明确要求“专题研究/深度分析/研究报告”
- 研究对象为主题、事件、政策、趋势、跨行业议题
- 典型问法：`东方财富专题研究`、`美联储加息对A股影响`、`AI Agent产业链专题`

### 不触发规则（何时不要使用本技能）
- 用户只问单行业基础研究（应走行业研究技能）
- 用户只问单只股票/基金买卖判断（应走诊断技能）
- 用户要求指标级计算、回测、量化建模（应走量化类能力）

### 触发示例

| 触发（专题研究） | 不触发（其他能力） |
|---|---|
| 东方财富专题研究 | 半导体行业最新景气度（行业研究） |
| 美联储加息对A股影响 | 海康威视值得买吗（个股诊断） |
| 一带一路主题投资机会 | 永赢先锋半导体风险大吗（基金诊断） |
| ChatGPT对教育行业冲击 | 丹化科技MACD是否金叉（指标计算） |

## 前提条件

### 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 --query "东方财富专题研究"
```

**输出示例**
```text
Title: 东方财富日报专题研究报告
ShareUrl: http://aife-test.eastmoney.com:9001/researchShare?shareId=xxx&scene=research
DOCX: /path/to/workspace/topic_research_report/5f14e352-cd8e-4169-9d69-7399f1eb8328_docx.docx
PDF: /path/to/workspace/topic_research_report/5f14e352-cd8e-4169-9d69-7399f1eb8328_pdf.pdf
（随后输出 Markdown 正文内容）
```

**参数说明：**

| 参数 | 说明 | 必填 |
|---|---|---|
| `--query` | 用户原始专题研究问句 | ✅（`--query` 或 stdin 二选一） |
| `--no-save` | 保留参数（兼容旧调用，当前对本技能无影响） | 否 |

### 2. 代码调用

```python
import asyncio
from pathlib import Path
from scripts.get_data import generate_topic_research_report

async def main():
    result = await generate_topic_research_report(
        query="东方财富专题研究",
        output_dir=Path("workspace/topic_research_report"),
        save_to_file=True,
    )
    if "error" in result:
        print(result["error"])
    else:
        print(result["title"])
        print(result["share_url"])
        print(result["content"])
        if result.get("output_path"):
            print("已保存至:", result["output_path"])

asyncio.run(main())
```

## 输出文件说明

| 文件 | 说明 |
|---|---|

From johncui9392/Aeolus, MIT.

More from johncui9392/Aeolus