openclaw-data-china-stock

OpenClaw Data China Stock

このプラグインは、A株、ETF、上場オプションのデータを収集するための、ClawHub/OpenClaw 互換ツールセットを提供します。

主なツール

• 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 データを読み取ります（有効な場合）。

対応するスキル一式

• 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 個のツール。後方互換性のため維持）
• スキル：skills/china-macro-analyst/SKILL.md（機関投資家向けの4セクション構成のナラティブテンプレート。ルールは macro_config.yaml に記載）

マルチファクター株式スクリーニング（A株）

• tool_screen_equity_factors：hs300|zz500|zz1000|a_share|custom を対象とする、振れ戻し／トレンドテンプレート（例：reversal_5d、fund_flow_3d、sector_momentum_5d）の単一エントリーポイントです。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 に同期されます。

資金フロー関連ツール（用途に合ったものを1つ選び、重複して使用しないでください）

• tool_capital_flow：flow_judgement / risk_flags 形式の出力を必要とするワークフロー向けの、単一銘柄の概要（例：ストップ高戦略）。
• tool_fetch_a_share_fund_flow：中国国内A株の資金フローに関する表形式データ／ランキング／履歴を取得します（query_kind で市場／セクター／銘柄のテーブル、大口取引、主力ランキング、セクターの詳細分析を選択します）。AkShare の Eastmoney／Tonghuashun 形式のルートを、明示的な試行チェーンを使って利用します。生データは投資助言ではありません。
• tool_fetch_northbound_flow：Stock Connect の北向き資金フロー（クロスボーダー）。中国国内A株の資金フローツールとは別のため、ナラティブと出典を分けてください。
• tool_fetch_a_share_technical_screener：AkShare の stock_rank_*_ths を介して、Tonghuashun 形式のテクニカル銘柄スクリーナー（高値更新、連続上昇日数、出来高パターン、移動平均線のブレイクアウトなど）を実行します。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分足データを取得する：

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 ファイルの読み込みと書き込みの両方が有効になります。