dreamending/quant_trading_cli/report-search

研报搜索技能

技能概述

本技能是一个财经研究报告搜索引擎，通过调用同花顺问财的财经资讯搜索接口，专门搜索和分析主流投研机构发布的研究报告，帮助用户获取专业的分析逻辑、投资评级、目标价等重要投研决策信息。

技能功能

1. 研究报告搜索

• 搜索各类财经研究报告和分析文章
• 覆盖主流投研机构、证券公司、研究机构等
• 支持中文关键词搜索，专注于研究报告类型

2. 智能查询处理能力

• 自动拆解复杂查询为多个专业查询
• 示例：用户问"人工智能和芯片行业的研究报告"可以拆分为"人工智能行业研究报告"和"芯片行业研究报告"
• 根据查询复杂度决定调用接口的次数
• 生成标准化的专业查询关键词

3. 数据质量评估与扩展

• 自动评估搜索结果的专业性和相关性
• 检查研究报告是否包含分析逻辑、投资评级、目标价等关键信息
• 如有必要，可调用其他技能或工具扩展数据源
• 对搜索结果进行专业质量评估

4. 专业数据处理与返回

• 对研究搜索结果进行专业排序、过滤和摘要
• 提取关键信息：分析逻辑、投资评级、目标价、风险提示等
• 将处理后的专业数据返回给大模型
• 生成专业、深度的回答格式

接口信息

基础信息

• Base URL: https://openapi.iwencai.com
• 接口路径: /v1/comprehensive/search
• 请求方式: POST
• 认证方式: API Key (Bearer Token)

认证要求

在请求头中需要携带API Key进行认证：

Authorization: Bearer {IWENCAI_API_KEY}

其中 IWENCAI_API_KEY 是用户申请的有效API密钥，需要设置为环境变量。

请求参数

{
  "channels": ["report"],
  "app_id": "AIME_SKILL",
  "query": "搜索关键词"
}

重要参数说明：

• channels: 固定为 ["report"]，表示搜索研究报告类型
• app_id: 固定为 AIME_SKILL
• query: 用户搜索关键词，支持中文

使用场景

何时调用本技能

1. 行业研究报告搜索: 当用户需要了解特定行业的专业研究报告时
2. 公司分析报告查询: 当用户需要获取特定公司的深度分析报告时
3. 投资评级查询: 当用户需要了解投资评级和目标价信息时
4. 趋势分析报告: 当用户需要获取行业趋势和专业分析时
5. 投研决策支持: 当用户需要专业投研信息支持决策时

调用示例

1. 用户问："人工智能行业的最新研究报告有哪些？"
2. 用户问："特斯拉的投资评级和目标价是多少？"
3. 用户问："芯片行业的深度分析报告有哪些？"
4. 用户问："新能源车行业的投资前景分析报告？"
5. 用户问："医药行业的研究报告和投资建议？"

技能内部逻辑

查询处理流程

1. 接收用户查询: 获取用户的专业搜索需求
2. 查询拆解分析: 分析查询复杂度，决定是否需要拆分为多个专业子查询
3. 专业查询生成: 生成标准化的专业查询关键词，优化搜索效果
4. API调用执行: 生成并执行API调用代码，使用Bearer Token认证
5. 数据质量评估: 检查返回的研究报告是否专业、完整，能否回答用户问题
6. 专业数据处理: 对搜索结果进行专业排序、过滤、摘要和关键信息提取
7. 结果整合返回: 将处理后的专业结果返回给大模型，生成深度回答

代码生成要求

• 生成完整的API调用代码，包括Bearer Token认证、请求构造、错误处理
• 处理网络异常和接口错误，实现专业重试机制
• 支持研究报告的专业数据处理和分析
• 确保代码符合Python最佳实践，可读性和可维护性高

数据来源标注

重要: 所有研究搜索结果均来源于同花顺问财财经资讯搜索接口，在回答用户问题时必须明确标注数据来源。

示例标注格式：

• "根据同花顺问财提供的研究报告数据..."
• "数据来源：同花顺问财财经资讯搜索（研究报告）"
• "同花顺问财研究报告显示..."
• "基于同花顺问财的研究报告分析..."

技术实现

Python代码要求

• 使用Python 3.7+版本
• 优先使用Python标准库和官方包
• 常用库允许使用：requests, pandas, numpy等
• 尽量减少第三方库依赖
• 代码结构清晰，模块化设计

配置文件要求

• 必须包含 config.example.json 配置文件示例
• 必须实现 config.py 配置管理模块
• API密钥必须从环境变量 IWENCAI_API_KEY 获取，不得硬编码

目录结构要求

研报搜索/
├── README.md              # 技能说明文档（中文）
├── SKILL.md              # 技能主文档（包含YAML frontmatter）
├── references/           # 参考文档目录
│   └── api.md           # 接口文档副本
└── scripts/             # 源代码目录
    ├── __main__.py      # 命令行入口点
    ├── config.py        # 配置管理模块
    ├── config.example.json # 配置文件示例
    ├── requirements.txt # Python依赖文件
    ├── setup.py         # 安装配置
    ├── research_report_search.py # 主程序文件
    ├── api_client.py    # API客户端模块
    ├── data_processor.py # 数据处理模块
    ├── cli.py           # CLI接口模块
    ├── example_usage.py # 使用示例
    └── test_basic.py    # 基础测试

CLI接口要求

• 支持 python research_report_search.py 调用方式
• 支持 python -m scripts.research_report_search 调用方式
• 提供完整的命令行参数和帮助文档
• 支持多种输出格式：csv, json, text, markdown

注意事项

1. 数据专业性: 专注于研究报告类型，确保返回结果的深度和专业性
2. 认证合规: 必须使用Bearer Token认证方式，符合公网访问要求
3. 来源标注: 必须明确标注数据来源于同花顺问财
4. 错误处理: 实现完善的错误处理和重试机制
5. 性能优化: 考虑接口调用频率限制，实现合理的请求间隔
6. 用户体验: CLI接口要直观易用，提供清晰的专业反馈