openclaw-data-china-stock

OpenClaw Data China Stock

此插件提供一套兼容 ClawHub/OpenClaw 的工具集，用于收集 A 股、ETF 和上市期权数据。

主要工具

• tool_fetch_market_data：跨资产统一入口（推荐）。
• tool_fetch_index_data / tool_fetch_etf_data / tool_fetch_option_data：兼容性／别名统一入口。
• tool_get_option_contracts：按标的获取期权合约。
• tool_read_market_data / tool_read_*：读取此前缓存的 Parquet 数据（启用时）。

配套 Skill 套件

• skills/china-macro-analyst/SKILL.md
• skills/technical-analyst/SKILL.md
• skills/market-scanner/SKILL.md
• skills/market-sentinel/SKILL.md
• skills/fund-flow-analyst/SKILL.md
• skills/strategy-backtester/SKILL.md（MVP 模式）
• skills/fundamental-analyst/SKILL.md

中国宏观分析工具

• 主要工具：tool_fetch_macro_data / tool_fetch_macro_snapshot
• 兼容性封装：tool_fetch_macro_*（21 个工具；为保持向后兼容而保留）
• Skill：skills/china-macro-analyst/SKILL.md（机构级 4 部分叙述模板；规则位于 macro_config.yaml）

多因子股票筛选（A 股）

• tool_screen_equity_factors：用于震荡／趋势模板的单一入口（例如 reversal_5d、fund_flow_3d、sector_momentum_5d），适用于 hs300|zz500|zz1000|a_share|custom；返回 quality_score、degraded、config_hash 和可选的 sw_mapping 统计数据。实现在 plugins/analysis/equity_factor_screening.py；已在 tool_runner.py / config/tools_manifest.yaml（及 JSON）中注册。JSON Schema：docs/schemas/tool_screen_equity_factors.schema.json。
• tool_batch_fetch：批量执行器包含 tool_screen_equity_factors（参见 plugins/merged/tool_batch_fetch.py 白名单）。
• 申万一级映射：config/sw_industry_level1_mapping.json，由 scripts/update_sw_industry_level1_mapping.py 生成（默认使用乐咕乐股 sw_index_first_info + sw_index_third_cons；可选设置 SW_MAP_USE_EM_SPOT=1 以使用东财快照）。消费侧：plugins/analysis/sw_industry_mapping.py。

助手侧夜盘数据落盘、质量门禁与熔断工具（tool_finalize_screening_nightly / tool_set_screening_emergency_pause）在 etf-options-ai-assistant 仓库中注册；规程 Skill ota_equity_factor_screening_brief 仅由该助手仓库维护，并同步到 Gateway。

资金流工具（按需选择，不要重复使用）

• tool_capital_flow：用于需要 flow_judgement / risk_flags 风格输出（例如涨停策略）的工作流，提供单只股票的汇总数据。
• tool_fetch_a_share_fund_flow：提供境内 A 股资金流的表格／排名／历史数据（query_kind 用于选择市场／行业／股票表格、大单、主力排名和行业下钻）。通过明确的尝试链使用东财／同花顺风格的 AkShare 路由；原始数据不构成投资建议。
• tool_fetch_northbound_flow：提供沪深港通北向资金流（跨境），与境内 A 股资金流工具分开使用——叙述和引用应保持区分。
• tool_fetch_a_share_technical_screener：通过 AkShare stock_rank_*_ths 提供同花顺风格的技术选股器（新高、连续上涨天数、成交量形态、均线突破等）——不同于基于 OHLC 在本地计算 MACD/RSI（如需后者，请使用 tool_stock_data_fetcher / tool_calculate_technical_indicators）。

安全与独立性

此插件专为独立运行而设计（不依赖任何其他仓库）：

• 不会注入 ~/.openclaw/.env。
• 支持插件专用的缓存／数据路径（在插件内部配置）。

为何对零售用户有帮助

• 跨资产统一入口（tool_fetch_market_data），减少“切换工具”的摩擦。
• 多数据源优先级与自动回退机制，避免单一数据源故障中断工作流。
• 默认采用只读磁盘缓存语义（data_cache.enabled=false），尽量降低本地数据污染风险。

典型用法

示例：获取 A 股指数日线历史数据：

tools:
  - name: tool_fetch_market_data
    params:
      asset_type: index
      view: historical
      asset_code: "000001"
      period: daily
      start_date: "20260201"
      end_date: "20260228"

示例：获取 ETF 5 分钟 K 线：

tools:
  - name: tool_fetch_market_data
    params:
      asset_type: etf
      view: minute
      asset_code: "510300"
      period: "5"
      start_date: "20260201"
      end_date: "20260228"

示例：获取最新 CPI 并使用宏观快照：

tools:
  - name: tool_fetch_macro_data
    params:
      dataset: cpi
      latest_only: true
  - name: tool_fetch_macro_snapshot
    params:
      scope: monthly
      include_quadrant: true

缓存策略

• 默认：data_cache.enabled=false
  • 允许读取磁盘上的 parquet 文件（如果缓存存在）。
  • 跳过磁盘上的 parquet 文件写入。
  • 在此模式下，不会删除损坏的 parquet 文件。
• data_cache.enabled=true
  • 同时启用磁盘上的 parquet 文件读取和写入。