메뉴
统一的股票数据助手 Skill，整合： (1) 数据查询 — 通过 MCP 协议查询历史 K 线、财务报表等（A 股/港股/ETF/指数）； (2) 实时搜索 — 通过 WebSocket 订阅实时行情推送（每 3~5 秒更新）； (3) 微信联动 — 通过 picoclaw + WeChat Channel 实现微信端操作数据库和订阅实时数据。 触发此 Skill 时会自动下载 picoclaw、复用项目 LLM 配置、启动微信登录。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
Subscribe to real-time stock market data via WebSocket long connection from receiver nodes (A-shares, HK stocks, ETFs). Use this skill when the user wants to monitor live stock prices, set up real-time alerts, or stream minute-level K-line data. The skill provides a WebSocket server that connects to receiver nodes and pushes real-time price updates to all connected clients.
Query historical stock market data (A-shares, HK stocks, ETFs, indices) via MCP protocol. Use this skill when the user wants to retrieve historical daily K-line data, financial statements, market indicators, stock screening results, or any other batch data from the stock database. Requires a valid MCP query token purchased from the management platform.
This skill should be used when the user needs to set up, manage, or troubleshoot MCP API Key authentication and tool usage tracking for this stock data service. Use it when configuring external MCP clients (Claude Code, Cursor) to connect to the data service.
This skill should be used when the user provides a Tushare API document URL and asks to generate a full plugin in this codebase, including extractor, schema, config, query service, and agent/MCP/http usage with testable curl examples.
SOC 직업 분류 기준
| name | stock-data-assistant |
| description | 统一的股票数据助手 Skill，整合： (1) 数据查询 — 通过 MCP 协议查询历史 K 线、财务报表等（A 股/港股/ETF/指数）； (2) 实时搜索 — 通过 WebSocket 订阅实时行情推送（每 3~5 秒更新）； (3) 微信联动 — 通过 picoclaw + WeChat Channel 实现微信端操作数据库和订阅实时数据。 触发此 Skill 时会自动下载 picoclaw、复用项目 LLM 配置、启动微信登录。 |
整合 历史数据查询、实时行情搜索 和 微信联动 三大能力的统一 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
该命令会依次完成：
.env 读取 LLM 配置，生成 picoclaw.yaml# 显示微信登录二维码（扫码后即绑定）
.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...
bash skills/stock-data-assistant/setup_picoclaw.sh
# 或指定版本
bash skills/stock-data-assistant/setup_picoclaw.sh v0.2.5
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
export PATH=".local/bin:$PATH"
picoclaw run --config .local/picoclaw.yaml
picoclaw auth weixin
配置生成器会自动读取以下环境变量：
| 变量 | 说明 | 默认值 |
|---|---|---|
OPENAI_API_KEY | API 密钥 | (必填) |
OPENAI_BASE_URL | API 端点 | https://api.openai.com/v1 |
OPENAI_MODEL | 模型名称 | gpt-4 |
| 变量 | 说明 |
|---|---|
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
picoclaw 通过 MCP 协议连接到 stock_datasource 后，以下工具在微信中均可使用：
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_* — 现金流量表tushare_index_* — 指数数据tushare_fund_* — ETF 数据tushare_trade_cal_get_cal — 交易日历完整工具列表可通过 MCP
tools/list接口动态获取（约 76+ 个工具）
通过 skills/stock-rt-subscribe 提供，支持：
详细文档: ../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 有效 |
setup_picoclaw.sh 自动安装