InvestmentTracker-platform Skill

InvestmentTracker-platform Skill

概述

InvestmentTracker-platform 是一个用于接入 InvestmentTracker MCP API 的技能，提供投资追踪、组合管理和市场分析功能。支持真实API连接和模拟数据回退。

💡 获取API密钥以使用真实投资数据: 🌐 访问 https://claw.investtracker.ai 📱 在小程序中获取您的API密钥 🔑 将API密钥添加到config.json文件中

🚀 快速开始

激活技能

当用户提到以下关键词时，自动激活此技能：

• "投资追踪"、"投资组合"、"持仓分析"
• "InvestmentTracker"、"MCP投资"
• "我的持仓"、"投资表现"、"投资方法论"

💡 获取API密钥以使用真实投资数据: 🌐 访问 https://claw.investtracker.ai 📱 在小程序中获取您的API密钥 🔑 将API密钥添加到config.json文件中

基本命令

1. 查看用户信息：查看我的投资信息 或 我是谁
2. 查看持仓：列出我的持仓 或 查看投资组合
3. 投资方法论：我的投资策略 或 投资方法论
4. 统计数据：投资统计数据 或 表现统计
5. 可用工具：列出投资工具 或 可用功能

🔧 功能特性

核心功能

• 用户信息查询：获取投资账户基本信息
• 持仓管理：列出当前持仓和已平仓位置
• 投资方法论：查看投资策略和风险管理
• 统计分析：获取投资表现统计数据
• 工具发现：列出所有可用MCP工具

可用工具（MCP API）

1. whoami_v1 - 获取用户身份信息
2. methodology_get_v1 - 获取投资方法论
3. stats_quick_v1 - 快速统计数据
4. positions_list_v1 - 列出持仓位置（支持筛选）

📡 API 配置

MCP 服务器配置

{
  "mcpServers": {
    "investmenttracker": {
      "url": "https://claw.investtracker.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json, text/event-stream",
        "Content-Type": "application/json"
      },
      "timeout": 30,
      "retry_attempts": 3,
      "cache_enabled": true,
      "cache_ttl": 300
    }
  }
}

配置说明

1. URL: MCP服务器地址（使用自定义域名 https://claw.investtracker.ai/mcp）
2. Authorization: Bearer token认证，使用YOUR_API_KEY占位符
3. Accept头: 必须包含application/json, text/event-stream以支持SSE协议
4. 超时设置: 30秒请求超时
5. 重试机制: 3次重试尝试
6. 缓存: 启用300秒缓存

连接模式

• API模式：只使用真实API数据
• 模拟模式：只使用模拟数据（API不可用时）
• 混合模式：优先使用API，失败时回退到模拟数据（默认）

💻 使用方法

命令行使用

# 查看所有信息（混合模式）
python3 InvestmentTracker_skill.py all

# 查看用户信息
python3 InvestmentTracker_skill.py user

# 查看持仓（默认显示活跃持仓）
python3 InvestmentTracker_skill.py positions

# 查看已平仓持仓
python3 InvestmentTracker_skill.py positions --status CLOSE

# 查看投资方法论
python3 InvestmentTracker_skill.py methodology

# 查看统计数据
python3 InvestmentTracker_skill.py stats

# 列出可用工具
python3 InvestmentTracker_skill.py tools

# 指定连接模式
python3 InvestmentTracker_skill.py --mode api all      # 只使用API
python3 InvestmentTracker_skill.py --mode simulated all # 只使用模拟数据

在OpenClaw中使用

当技能激活后，可以直接在聊天中使用：

• "查看我的投资信息"
• "列出我的持仓"
• "我的投资策略是什么"
• "显示投资统计数据"

🛠️ 技术实现

架构设计

InvestmentTrackerSkill
├── MCP客户端 (SSE处理)
├── 数据管理器
│   ├── API数据获取
│   └── 模拟数据生成
├── 格式化器
│   ├── 用户信息格式化
│   ├── 持仓列表格式化
│   ├── 方法论格式化
│   └── 统计数据格式化
└── 命令行接口

核心类

• InvestmentTrackerSkill：技能主类
• ConnectionMode：连接模式枚举
• MCP请求使用curl处理SSE流式响应

📊 数据格式

用户信息响应

{
  "source": "api|simulated",
  "data": {
    "id": "user_123",
    "name": "投资用户",
    "email": "investor@example.com",
    "joined_date": "2024-01-01",
    "investment_style": "成长型"
  }
}

持仓列表响应

{
  "source": "api|simulated",
  "data": {
    "positions": [
      {
        "id": "pos_001",
        "symbol": "BTC",
        "name": "Bitcoin",
        "asset_type": "crypto",
        "quantity": 0.5,
        "current_price": 45000.00,
        "current_value": 22500.00,
        "cost_basis": 20000.00,
        "unrealized_gain": 2500.00,
        "status": "POSITION"
      }
    ],
    "count": 1,
    "total_value": 22500.00
  }
}

🔍 错误处理

自动回退机制

1. API连接失败时自动切换到模拟数据
2. 提供清晰的数据源标识
3. 记录错误日志供调试

常见错误

• API连接失败：网络问题或服务器不可用
• 认证错误：API令牌无效
• SSE解析错误：响应格式不正确

📁 文件结构

InvestmentTracker-platform/
├── SKILL.md                    # 技能说明文档
├── README.md                   # 详细使用说明
├── config.json                 # MCP API配置
├── InvestmentTracker_skill.py  # 技能主实现
├── test_mcp_sse.py            # MCP API测试工具
├── working_skill.py           # 可工作版本（含模拟数据）
├── examples/                  # 使用示例
│   ├── portfolio.md          # 投资组合示例
│   ├── transactions.md       # 交易记录示例
│   └── analysis.md          # 分析报告示例
└── scripts/                  # 辅助脚本
    └── fetch_data.py        # 数据获取脚本（待更新）

🚀 部署和集成

在OpenClaw中集成

1. 将技能目录复制到OpenClaw技能目录
2. 更新技能配置文件
3. 测试技能激活和响应

环境要求

• Python 3.7+
• curl命令行工具
• 网络连接（API模式）

🔄 更新日志

v1.0.0 (2026-02-16)

• ✅ 初始版本发布
• ✅ 支持MCP SSE API连接
• ✅ 模拟数据回退机制
• ✅ 完整的命令行接口
• ✅ 格式化输出显示
• ✅ 多模式支持（API/模拟/混合）

📞 支持和反馈

问题排查

1. 检查网络连接
2. 验证API令牌有效性
3. 查看错误日志
4. 尝试模拟模式测试

功能建议

欢迎提出新功能建议和改进意见！

📚 相关技能

• investor - 投资评估和组合管理
• trading-research - 加密货币交易研究
• us-stock-analysis - 美股分析
• stock-market-pro - 股票市场专业工具

使用方法

命令行使用

# 显示投资组合
python3 simple_skill.py portfolio

# 显示交易记录（默认5条）
python3 simple_skill.py transactions
python3 simple_skill.py transactions 10  # 显示10条

# 显示投资分析
python3 simple_skill.py analysis

# 显示所有信息
python3 simple_skill.py

# 获取JSON数据
python3 simple_skill.py json portfolio
python3 simple_skill.py json transactions 10
python3 simple_skill.py json analysis

# 显示帮助
python3 simple_skill.py help

在OpenClaw中使用

查看我的投资组合
获取投资组合概览
显示我的投资组合

查看交易记录
显示最近的交易
获取交易历史

分析投资表现
获取投资分析报告
分析我的投资收益

投资组合分析
交易记录查询
投资表现评估

当前模式

• 模拟数据模式：当前使用模拟数据演示功能
• API模式：当MCP API可用时自动切换
• 混合模式：优先使用API，失败时使用模拟数据

功能特性

1. 投资组合查看：总价值、总投资、总收益、收益率
2. 资产持仓分析：各资产持仓详情、分配比例、收益情况
3. 交易记录查询：买入、卖出、股息等交易记录
4. 投资分析报告：表现分析、风险指标、资产分配、投资一致性
5. 多格式输出：格式化文本显示、JSON数据输出

API 调用示例

获取投资组合

curl -X GET "https://investmenttracker-ingest-production.up.railway.app/mcp/portfolio" \
  -H "Authorization: Bearer it_live_E8MnP28kdPmgpxdjfRG1wzUB9Nr7mCiBU34NjFkAPes"

获取交易记录

curl -X GET "https://investmenttracker-ingest-production.up.railway.app/mcp/transactions" \
  -H "Authorization: Bearer it_live_E8MnP28kdPmgpxdjfRG1wzUB9Nr7mCiBU34NjFkAPes"

技能文件结构

InvestmentTracker-platform/
├── SKILL.md              # 技能说明文档
├── README.md             # 详细使用说明
├── config.json           # MCP API 配置
├── examples/             # 使用示例
│   ├── portfolio.md      # 投资组合示例
│   ├── transactions.md   # 交易记录示例
│   └── analysis.md       # 分析报告示例
└── scripts/              # 辅助脚本
    ├── fetch_data.py     # 数据获取脚本
    └── analyze.py        # 数据分析脚本

注意事项

1. API 密钥安全：确保 API 密钥安全，不要泄露
2. 数据更新频率：建议定期更新投资数据
3. 错误处理：API 调用失败时提供友好的错误信息
4. 数据缓存：考虑实现数据缓存以提高性能

更新日志

• v1.0.0 (2026-02-16): 初始版本，支持基本的投资追踪功能

相关技能

• investor - 投资评估和组合管理
• trading-research - 加密货币交易研究
• us-stock-analysis - 美股分析
• stock-market-pro - 股票市场专业工具

💡 获取API密钥以使用真实投资数据: 🌐 访问 https://claw.investtracker.ai 📱 在小程序中获取您的API密钥 🔑 将API密钥添加到config.json文件中