@weaxs/openclaw-stock-analysis 0.2.10 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +11 -51
  2. package/dist/index.js +3693 -1971
  3. package/index.ts +74 -1636
  4. package/openclaw.plugin.json +3 -0
  5. package/package.json +3 -3
  6. package/scripts/cli-json.mjs +23 -0
  7. package/scripts/exec-process.mjs +89 -0
  8. package/scripts/setup-python.mjs +37 -4
  9. package/scripts/tool-calls.mjs +489 -0
  10. package/skills/event-driven/SKILL.md +2 -2
  11. package/skills/growth-quality/SKILL.md +1 -1
  12. package/skills/stock-analysis/SKILL.md +12 -7
  13. package/skills/stock-analysis/references/stateless-analysis.md +9 -1
  14. package/tools/_cache.py +13 -0
  15. package/tools/_subproc.py +46 -0
  16. package/tools/alert_rules.py +65 -16
  17. package/tools/backtest.py +3 -3
  18. package/tools/capabilities.py +32 -9
  19. package/tools/cli_budgets.json +2 -0
  20. package/tools/diagnostics.py +3 -4
  21. package/tools/gather.py +2 -6
  22. package/tools/import_parser.py +3 -4
  23. package/tools/lixinger.py +119 -27
  24. package/tools/market_regime.py +5 -2
  25. package/tools/market_review.py +5 -6
  26. package/tools/name_resolver.py +82 -21
  27. package/tools/report_renderer.py +3 -3
  28. package/tools/requirements.txt +6 -5
  29. package/tools/risk_screening.py +3 -2
  30. package/tools/screener.py +6 -4
  31. package/tools/search_intel.py +81 -12
  32. package/tools/sec_edgar.py +266 -0
  33. package/tools/sec_holders.py +6 -0
  34. package/tools/signal_tracker.py +11 -10
  35. package/tools/stateless_analysis.py +115 -0
  36. package/tools/stock_data.py +707 -222
  37. package/tools/tiaa_disclosures.py +267 -0
  38. package/tools/tool_schemas.json +2704 -0
  39. package/tools/trading_calendar.py +65 -30
  40. package/tools/value_data.py +366 -134
  41. package/tools/watchlist.py +43 -5
package/README.md CHANGED
@@ -1,13 +1,17 @@
1
1
  # Stock Analysis — OpenClaw Plugin
2
2
 
3
- A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。OpenClaw Gateway 加载后即可在对话中调用 71 个工具。
3
+ A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。OpenClaw Gateway 加载后即可在对话中调用 74 个工具。
4
4
 
5
5
  ## 安装
6
6
 
7
7
  ```bash
8
- openclaw plugins install clawhub:@weaxs/openclaw-stock-analysis
8
+ openclaw plugins install npm:openclaw-stock-analysis
9
+ openclaw plugins inspect stock-analysis --runtime --json # 记下 installPath
10
+ cd <installPath> && node scripts/setup-python.mjs
9
11
  ```
10
12
 
13
+ 同一份包也以 `@weaxs/openclaw-stock-analysis` 发布;ClawHub 上只有这个 scoped 名(`clawhub:@weaxs/openclaw-stock-analysis`)。
14
+
11
15
  或从源码(仓库根目录):
12
16
 
13
17
  ```bash
@@ -17,58 +21,14 @@ npm install
17
21
 
18
22
  ### Python 运行时
19
23
 
20
- 工具实际逻辑在 `tools/*.py`,依赖 `akshare`、`pandas`、`numpy`、`requests`。仓库根 `package.json` 的 postinstall(`scripts/setup-python.mjs`)会自动建 `.venv` 并装好依赖,无需手工操作。前提:本机有 `python3 >= 3.10`。
24
+ 工具实际逻辑在 `tools/*.py`,依赖 `akshare`、`pandas`、`numpy`、`requests`。`scripts/setup-python.mjs` 会在插件目录建 `.venv` 并装好依赖,前提:本机有 `python3 >= 3.10`。OpenClaw 安装插件时不执行 `postinstall`,所以装完和升级后要像上面那样手动运行一次;源码安装时由仓库根 `npm install` 自动执行。
21
25
 
22
26
  如果 venv 没建起来(比如 Python 缺失),plugin 会回退到系统 `python3`,请自行 `pip install -r tools/requirements.txt`。
23
27
 
24
- ## 工具列表
25
-
26
- ### 行情数据
27
- - `get_kline` — K线 OHLCV(A/HK/US/JP/KR/TW)
28
- - `get_quote` — 实时报价
29
- - `get_capital_flow` — A股资金流(个股 / 多日 / 板块)
30
- - `get_news` — 财经新闻
31
- - `get_financials` — 关键财务指标
32
-
33
- ### 分析
34
- - `get_technical_analysis` — MA/MACD/RSI/BOLL/KDJ + 综合评分
35
- - `analyze_pattern` — 12+ 种 K 线形态识别
36
- - `calculate_ma` — 独立均线计算
37
- - `get_volume_analysis` — 量价分析
38
- - `analyze_portfolio_risk` — 组合敞口、相关性、止损与确定性压力测试
39
- - `plan_portfolio_rebalance` — 目标权重、整手和现金约束下的调仓清单
40
-
41
- ### 市场全景
42
- - `get_market_indices` — 主要指数(CN/HK/US/JP/KR/TW)
43
- - `get_sector_rankings` — A股板块涨跌幅排行
44
- - `get_sector_constituents` — A股板块成分股查询(板块名模糊匹配)
45
- - `resolve_stock_sectors` — 个股所属板块查询(A股行业+概念 / 港股 GICS)
46
- - `get_market_stats` — A股大盘统计
47
- - `get_stock_info` — 股票基本信息
48
- - `get_chip_distribution` — A股筹码分布
49
- - `get_fundamental_context` — A股深度基本面
50
- - `detect_market_regime` — 市场阶段检测
51
- - `get_market_review` — 大盘日度复盘
52
-
53
- ### 筛选与回测
54
- - `screen_stocks` — 全市场多因子筛选(AlphaSift L1)
55
- - `run_backtest` — 策略回测(AlphaEvo)
56
- - `evaluate_signal` — 信号历史准确率
57
- - `screen_risk` — 7维度风险筛查
58
- - `run_watchlist_analysis` — 自选股批量分析
59
- - `detect_anomaly` — 异动信号扫描
60
-
61
- ### 工具类
62
- - `resolve_stock_name` — A股名称/拼音 → 代码
63
- - `check_trading_day` / `get_trading_days` — 交易日历
28
+ ## 工具与 Skills
64
29
 
65
- ### 情报搜索(需 API Key)
66
- - `search_stock_news` — Tavily/Brave/SerpAPI 新闻搜索
67
- - `search_comprehensive_intel` — 6 维度综合情报
68
- - `get_social_sentiment` — Reddit/X/Polymarket 情绪
69
- - `get_trending_sentiment` — 社交热门趋势
70
- - `extract_article` — 文章正文提取
30
+ 74 个工具覆盖行情与基金净值、技术分析与 K 线形态、资金流与板块、估值/股东/ETF/股息、公告与 SEC、多因子选股、策略回测、市场复盘、新闻舆情、持仓风险与调仓计算。完整列表见[主仓库 README · 工具列表](https://github.com/Weaxs/stock-analysis-plugin#工具列表),Skills 见 [Skills 一览](https://github.com/Weaxs/stock-analysis-plugin#skills-一览)。
71
31
 
72
- ## 平行 Host
32
+ ## 其他宿主
73
33
 
74
- 同一份业务逻辑也以 [Pi Agent extension](../pi/index.ts) 和 [Hermes plugin](../hermes/) 形式分发;选你用的那个生态即可。
34
+ 同一套工具也以 Pi Agent extension、Hermes plugin、DeepSeek Harness (dsh) plugin 和 MCP stdio 服务器形式分发,见[主仓库 README · 快速开始](https://github.com/Weaxs/stock-analysis-plugin#快速开始)。