# Stock Analysis — OpenClaw Plugin

A股 / 港股 / 美股 行情、技术分析、筛选与回测。OpenClaw Gateway 加载后即可在对话中调用 31 个工具。

## 安装

```bash
openclaw plugins install clawhub:@weaxs/openclaw-stock-analysis
```

或从源码（仓库根目录）：

```bash
npm install
# OpenClaw Gateway 自行加载 ./openclaw/openclaw.plugin.json
```

### Python 运行时

工具实际逻辑在 `tools/*.py`，依赖 `akshare`、`pandas`、`numpy`、`requests`。仓库根 `package.json` 的 postinstall（`scripts/setup-python.mjs`）会自动建 `.venv` 并装好依赖，无需手工操作。前提：本机有 `python3 >= 3.9`。

如果 venv 没建起来（比如 Python 缺失），plugin 会回退到系统 `python3`，请自行 `pip install -r tools/requirements.txt`。

## 工具列表

### 行情数据
- `get_kline` — K线 OHLCV（A/HK/US）
- `get_quote` — 实时报价
- `get_capital_flow` — A股资金流（个股 / 多日 / 板块）
- `get_news` — 财经新闻
- `get_financials` — 关键财务指标

### 分析
- `get_technical_analysis` — MA/MACD/RSI/BOLL/KDJ + 综合评分
- `analyze_pattern` — 12+ 种 K 线形态识别
- `calculate_ma` — 独立均线计算
- `get_volume_analysis` — 量价分析

### 市场全景
- `get_market_indices` — 主要指数（CN/HK/US）
- `get_sector_rankings` — A股板块涨跌幅排行
- `get_market_stats` — A股大盘统计
- `get_stock_info` — 股票基本信息
- `get_chip_distribution` — A股筹码分布
- `get_fundamental_context` — A股深度基本面
- `detect_market_regime` — 市场阶段检测
- `get_market_review` — 大盘日度复盘

### 筛选与回测
- `screen_stocks` — 全市场多因子筛选（AlphaSift L1）
- `run_backtest` — 策略回测（AlphaEvo）
- `evaluate_signal` — 信号历史准确率
- `screen_risk` — 7维度风险筛查
- `run_watchlist_analysis` — 自选股批量分析
- `detect_anomaly` — 异动信号扫描

### 工具类
- `resolve_stock_name` — A股名称/拼音 → 代码
- `check_trading_day` / `get_trading_days` — 交易日历

### 情报搜索（需 API Key）
- `search_stock_news` — Tavily/Brave/SerpAPI 新闻搜索
- `search_comprehensive_intel` — 6 维度综合情报
- `get_social_sentiment` — Reddit/X/Polymarket 情绪
- `get_trending_sentiment` — 社交热门趋势
- `extract_article` — 文章正文提取

## 平行 Host

同一份业务逻辑也以 [Pi Agent extension](../pi/index.ts) 和 [Hermes plugin](../hermes/) 形式分发；选你用的那个生态即可。