投资研究报告助手

基于 baostock 金融数据库和 tavily-search 智能搜索的股票投资分析技能，提供完整的多时间框架技术分析、市场热点资讯追踪和投资报告生成功能。

Security Scan

技能总体与其描述一致，但源码中包含硬编码的 Tavily API Key 和与声明不完全一致的环境/凭证处理，建议在安装前确认并清理凭证并理解外部搜索数据的流向。

Purpose & Capability

技能声明使用 baostock 获取行情并可选集成 Tavily 搜索；代码、README 和 SKILL.md 中均实现并调用了 baostock 和 Tavily，功能与描述一致，没有发现与声明目的无关的外部服务或不相称的依赖。

Instruction Scope

运行说明和代码会在分析过程中将公司名称/代码等查询内容发送到 Tavily (外部 API)。SKILL.md 明确把 Tavily API Key 标记为“可选”，代码在未配置 Key 时会跳过搜索，这与描述基本一致。但需要注意：分析过程会把查询关键词（公司名、代码、行业关键词等）传递到第三方搜索 API（Tavily），这属于向外部服务发送用户数据的正常行为，用户应知情。

Install Mechanism

该技能为 instruction-only（没有安装脚本），提供 requirements.txt 让用户通过 pip 安装依赖：baostock、pandas、numpy、dotenv、reportlab、tavily-python 等。没有从不明 URL 下载、也没有写入非标准位置，安装风险为常见第三方包风险（供应链/依赖性），与技能用途相称。

Credentials

清单中声明“无需环境变量”，但运行时代码（analyze_stock.py、demo_tavily.py、demo_tavily.py 的 get_tavily_api_key）会读取 ~/.openclaw/.env 中的 TAVILY_API_KEY（可选）。更重要的是仓库包含 tavily_config.py，内含看起来像真实的硬编码 API Key (TAVILY_API_KEY = "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")。将凭证硬编码在源码中与最佳实践不符，若该 key 为有效且未授权，可能导致滥用或配额/计费风险；即使无恶意，该行为仍是不成比例的凭证暴露。

Persistence & Privilege

技能未请求常驻(always=false)、未修改其他技能或系统级配置、也未声明会写入特殊系统路径。行为权限与用途一致。

What to consider before installing

要点与建议： 1) 最重要：检查并删除仓库中的硬编码凭证（tavily_config.py 中的 TAVILY_API_KEY）。不要将真实 API Key 保存在源码中；如果该 key 曾经被上传到公共仓库，应当立即轮换/撤销。 2) Tavily 是第三方服务：分析时会把公司名称/代码/行业关键词发送给 Tavily API（如果配置了 Key）。如果你关心数据外泄或审计，请不要配置 TAVILY_API_KEY，或在本地禁用 Tavily 集成。SKILL.md 提到未配置时会跳过新闻搜索。 3) 依赖与安装：pip install -r requirements.txt 会安装第三方包（包括 tavily-python）。在生产/敏感环境中，建议在隔离的虚拟环境或容器中安装并审查依赖版本（可考虑锁定版本或从可信源安装）。 4) 若想安装：在安装前删除或重写 tavily_config.py 中的密钥，把你的 TAVILY_API_KEY 放到 ~/.openclaw/.env 或环境变量中（按 README 指示），并在首次使用时监控网络请求以确认只向预期的 API 发起调用。 5) 若你不需要新闻搜索：不设置 TAVILY_API_KEY 即可仅使用 baostock 的技术分析功能；或移除 tavily-python 依赖以进一步减少外部调用。 6) 其它：代码本身没有发现明显的恶意或隐蔽数据窃取逻辑，但包含网络调用（baostock、Tavily）；在信任该技能并安装前，应对包含的第三方包和嵌入凭证做基本审计。

ssehome-invest Skill - 投资研究报告技能

📋 技能描述

基于 baostock 金融数据库和 tavily-search 智能搜索的股票投资分析技能，提供完整的多时间框架技术分析、市场热点资讯追踪和投资报告生成功能。

版本: 1.0.4 更新日期: 2026-04-07 作者: OpenClaw Assistant & [e-mail] 核心特性: baostock K 线数据 + Tavily AI 新闻搜索 + 技术分析

---

🚀 快速开始

1. 安装依赖

cd skills/ssehome-invest
pip install -r requirements.txt

2. 配置 Tavily API (可选)

访问 https://app.tavily.com/ 获取免费 API Key，然后编辑配置文件：

# 编辑 ~/.openclaw/.env 文件
TAVILY_API_KEY=tvly-你的 API_Key

保存后重启 OpenClaw 即可生效。

3. 运行分析

from analyze_stock import analyze_stock
analyze_stock("002328", "新朋股份")

---

📁 文件结构

skills/ssehome-invest/
├── SKILL.md              # 本技能文档
├── README.md             # 使用指南
├── analyze_stock.py      # 主分析脚本 (含 Tavily 集成)
├── demo_tavily.py        # Tavily 搜索演示
├── TAVILY_README.md      # Tavily 详细配置指南
└── requirements.txt      # Python 依赖包列表

输出目录 data/:
└── {股票代码}_investment_report.md # Markdown 报告

---

🔄 更新日志

v1.0.4 (2026-04-07)

• 🐛 修复资讯搜索时行业条件 - 根据代码获取的行业类型(原来固定了行业)

v1.0.3 (2026-04-02)

• 🐛 修复收益率计算 - 涨跌幅 clip(-10, 10) 过滤异常数据
• 🐛 修复月涨跌幅 - 使用涨跌幅累乘方式，非首尾价格
• 📰 Tavily 新闻集成 - 自动搜索公司/产品/行业动态
• 📝 完善文档 - README.md / SKILL.md / TAVILY_README.md 同步更新

v1.0.2 (2026-04-01) 🔥

• ✨ Tavily Search 集成 - 自动搜索公司相关新闻热点
• ✨ AI 情感分析 - 正负面判断和股价影响评估
• ✨ 三维度搜索 - 公司动态/产品业务/行业热点
• 📝 配置简化 - 使用 ~/.openclaw/.env 统一管理 API Key
• 🗑️ 移除配置文件 - 删除 tavily_config.py
• 🛠️ 代码优化 - 简化 baostock 调用逻辑

v1.0.1 (2026-03-31)

• ✅ 仅使用 baostock 作为数据源
• ✅ 移除 AKShare 依赖
• ✅ 强化错误处理机制

v1.0.0 (2026-03-31)

• ✅ 完整实现所有技术分析功能
• ✅ 支持 Markdown/PDF 报告导出
• ✅ 均线系统评分机制

---

💡 Tavily 搜索功能详解

自动搜索内容

每次分析时自动执行三次智能搜索：

1. 公司动态

   • 查询：{股票名} {代码} 股价 投资 最新
   • 深度：advanced
   • 返回：前 5 条

2. 产品业务

   • 查询：{股票名} 产品 技术 主营业务
   • 深度：basic
   • 返回：前 3 条

3. 行业热点

   • 查询：{行业关键词} 行业 政策 市场
   • 深度：basic
   • 返回：前 3 条

输出示例

### 六、市场热点资讯分析

**整体情绪**: 🟢 偏正面

**公司动态** (4 条):
1. 中科曙光发布新一代 AI 服务器
2. 液冷技术获重大突破
...

**股价影响评估**:
- 短期：利好支撑可能推动股价上行
- 中长期：关注订单落地情况

---

⚙️ 技术指标说明

完整的 5+1 项技术分析：

1. MACD - 趋势方向和强度判断
2. RSI(14) - 超买 (>70)/超卖 (<30) 检测
3. DMI/ADX - 动向指标和趋势强度
4. BOLL - 布林带位置分析
5. 均线系统 - 5/14/21/89/250 日 MA 排列
6. 成交量 - 放量/缩量对比

均线评分标准:

• 5/5: 强势多头（黄金交叉）
• 3-4/5: 部分多头
• 0-2/5: 弱势或空头

---

📊 投资建议生成

基于多维度的综合分析结果，自动生成：

周期	决策依据	建议类型
短期	技术指标信号 + 最新消息	买入/持有/卖出
中期	均线排列趋势 + 基本面	增持/观望/减仓
长期	行业前景 + 公司竞争力	深入研究

---

⚠️ 注意事项

数据获取

• baostock 需要稳定的网络连接
• 如遇网络问题可稍后重试
• 建议使用代理优化连接

Tavily 使用

• 免费版每天 1000 次搜索额度充足
• API Key 配置在 ~/.openclaw/.env 中
• 未配置 API Key 不影响其他功能
• 搜索结果仅供参考

免责声明

本报告基于量化分析和公开信息生成，不构成投资建议。股市有风险，入市需谨慎。

---

📞 技术支持

• baostock 文档: https://baostock.com/baostock/index.php/%E9%A6%96%E9%A1%B5
• Tavily 文档: https://docs.tavily.com/
• OpenClaw 社区: 欢迎反馈问题和分享经验

---

📜 许可证

MIT License - Open Source

最后更新：2026-04-02