stock-data-assistant
Installation
SKILL.md
Stock Data Assistant（股票数据统一助手）
整合 历史数据查询、实时行情搜索 和 微信联动 三大能力的统一 Skill。
架构总览
┌─────────────┐ ┌──────────────┐ ┌─────────────────┐
│ 微信用户 │────▶│ picoclaw │────▶│ stock-mcp (8001) │
│ (WeChat) │ │ (LLM Gateway)│ │ 历史数据查询 │
└─────────────┘ │ port:18790 │ ├─────────────────┤
│ 微信 Channel │ │ WS (8765) │
┌─────────────┐ │ │────▶│ 实时行情推送 │
│ Web 前端 │────▶│ MCP Client │ └─────────────────┘
│ (18080) │ └──────────────┘
└─────────────┘
核心能力
| 能力 | 协议 | 端口 | 说明 |
|---|---|---|---|
| 历史数据查询 | MCP (streamable-http) | 8001 | K线/财务/指数/ETF 等 |
| 实时行情推送 | WebSocket | 8765 | A股/港股/ETF 逐笔 |
| 微信交互 | picoclaw WeChat Channel | — | 自然语言 → MCP 工具调用 |
快速开始
一键启动
bash skills/stock-data-assistant/start_wechat_bridge.sh
该命令会依次完成：
- 检查/下载 picoclaw — 自动检测系统架构，从 GitHub Releases 下载
- 生成配置 — 从
.env读取 LLM 配置，生成picoclaw.yaml - 启动 picoclaw — 启动 Gateway (18790) + 微信 Channel
- 启动实时订阅 — 启动 WebSocket 推送服务 (8765)
微信登录
# 显示微信登录二维码（扫码后即绑定）
.local/bin/picoclaw auth weixin
# 或者使用完整路径
./.local/bin/picoclaw auth weixin
扫码成功后，在微信中直接发消息即可操作股票数据。
微信对话示例
📱 你: 查一下贵州茅台最近的日K线
🤖 AI: 正在为您查询贵州茅台(600519.SH)的日线数据...
📱 你: 腾讯控股现在价格多少？
🤖 AI: 腾讯控股(00700.HK) 当前价 XXX.XX 港元，涨幅 X.XX%
📱 你: 监控 00700.HK 涨跌超过2%就通知我
🤖 AI: 已设置涨跌幅告警，触发条件：±2.00%
📱 你: 列出今天涨幅最大的10只A股
🤖 AI: 正在筛选今日涨幅榜 Top 10...
手动分步操作
Step 1: 安装 picoclaw
bash skills/stock-data-assistant/setup_picoclaw.sh
# 或指定版本
bash skills/stock-data-assistant/setup_picoclaw.sh v0.2.5
Step 2: 生成 picoclaw 配置
python3 skills/stock-data-assistant/generate_picoclaw_config.py
# 自定义参数
python3 skills/stock-data-assistant/generate_picoclaw_config.py \
--mcp-token sk-your-token-here \
--output ./my-config.yaml
Step 3: 启动 picoclaw
export PATH=".local/bin:$PATH"
picoclaw run --config .local/picoclaw.yaml
Step 4: 登录微信
picoclaw auth weixin
配置说明
LLM 配置（自动从 .env 复用）
配置生成器会自动读取以下环境变量：
| 变量 | 说明 | 默认值 |
|---|---|---|
OPENAI_API_KEY |
API 密钥 | (必填) |
OPENAI_BASE_URL |
API 端点 | https://api.openai.com/v1 |
OPENAI_MODEL |
模型名称 | gpt-4 |
MCP Server 配置
| 变量 | 说明 |
|---|---|
STOCK_MCP_SERVER_URL |
MCP 服务地址（默认 http://localhost:8001/messages） |
STOCK_MCP_TOKEN |
MCP 认证令牌 |
生成的配置文件结构
见 references/picoclaw_config_example.yaml
管理命令
# 查看状态
bash skills/stock-data-assistant/start_wechat_bridge.sh --status
# 停止所有服务
bash skills/stock-data-assistant/start_wechat_bridge.sh --stop
# 仅启动（不启用实时订阅）
bash skills/stock-data-assistant/start_wechat_bridge.sh --no-rt
# 指定订阅股票
bash skills/stock-data-assistant/start_wechat_bridge.sh --symbols 00700.HK,600519.SH
MCP 工具一览（通过微信可用）
picoclaw 通过 MCP 协议连接到 stock_datasource 后，以下工具在微信中均可使用：
K 线数据
tushare_daily_get_daily_data— 日 K 线 (OHLCV)tushare_daily_get_latest_daily— 最新交易日数据akshare_hk_*— 港股日线数据
基本面
tushare_daily_basic_get_daily_basic— PE/PB/市值等指标tushare_balancesheet_*— 资产负债表tushare_income_*— 利润表tushare_cashflow_*— 现金流量表
指数与 ETF
tushare_index_*— 指数数据tushare_fund_*— ETF 数据
市场
tushare_trade_cal_get_cal— 交易日历
完整工具列表可通过 MCP
tools/list接口动态获取（约 76+ 个工具）
实时数据（WebSocket）
通过 skills/stock-rt-subscribe 提供，支持：
- 实时推送: 每 3~5 秒更新行情
- 多市场: A 股 / 港股 / ETF
- 告警策略: 涨停跌停、大幅波动、量能异动、价格突破
详细文档: ../stock-rt-subscribe/SKILL.md
目录结构
skills/stock-data-assistant/
├── SKILL.md # 本文档
├── setup_picoclaw.sh # 自动下载 picoclaw
├── generate_picoclaw_config.py # 从 .env 生成配置
├── start_wechat_bridge.sh # 一键启动脚本
└── references/
└── picoclaw_config_example.yaml # 配置示例
故障排查
| 问题 | 解决方案 |
|---|---|
| picoclaw 下载失败 | 检查网络/代理；或手动从 GitHub 下载放入 .local/bin/ |
OPENAI_API_KEY not set |
确保 .env 文件中有 OPENAI_API_KEY 字段 |
API key required (MCP) |
设置 STOCK_MCP_TOKEN 环境变量或编辑配置文件 |
| 微信二维码过期 | 重新运行 picoclaw auth weixin |
| 实时数据无推送 | 检查 subscribe_client.py 是否正常运行，端口 8765 是否可达 |
| picoclaw 无法调用 MCP 工具 | 确认 MCP 服务 (8001) 正常运行且 token 有效 |
依赖关系
- Python >= 3.9 — 用于配置生成和实时数据订阅
- picoclaw >= v0.2.5 — 由
setup_picoclaw.sh自动安装 - stock_datasource MCP 服务 — 端口 8001（需先启动）
- stock_datasource Backend — 端口 6666（需先启动）
Related skills