tradingagents-analysis

TradingAgents 複数エージェントによる A 株投資リサーチ分析

TradingAgents API を使用して、15 名の専門 AI アナリストが A 株を対象に、5 段階の詳細な共同分析を行い、構造化された投資提案を出力します。

🎯 すぐに使う

そのまま話しかけてください：

• 「贵州茅台を分析して」
• 「宁德时代は買う価値がありますか」
• 「600519 のテクニカル面を分析して」
• 「比亚迪の最近の資金フローはどうですか」

15 名の AI アナリストを呼び出し、市場、テクニカル、ファンダメンタルズ、センチメント、資金の 5 つの観点から詳細に分析し、専門的な投資提案をお伝えします。

---

🤖 システムアーキテクチャ：5 段階・15 エージェント

段階	エージェント	役割
1. 分析チーム	市場／ニュース／センチメント／ファンダメンタルズ／マクロ／スマートマネー	多角的な生データの分析
2. ゲーム理論	ゲーム理論マネージャー	主力投資家と個人投資家の期待ギャップ分析
3. 強気・弱気の討論	強気・弱気のリサーチャー＋審判	対立する見解による激しい議論
4. 取引執行	トレーダー	分析を統合し、実行可能な判断を生成
5. リスク管理	積極型／中立型／保守型アナリスト＋ポートフォリオマネージャー	多角的なリスク審査

---

TradingAgents 複数エージェントによる投資リサーチ

TradingAgents API を使用して、15 名の専門 AI アナリストが A 株を対象に、5 段階の詳細な共同リサーチを行い、構造化された取引提案を提示します。

🤖 システムアーキテクチャ：5 段階・15 エージェント

段階	エージェント	役割
1. アナリストチーム	市場／ニュース／センチメント／ファンダメンタルズ／マクロ／スマートマネー	多角的な生データ分析
2. ゲーム理論	ゲーム理論マネージャー	主力投資家と個人投資家の期待ギャップ
3. 強気・弱気の討論	強気・弱気のリサーチャー＋審判	対立する見解による議論
4. 取引執行	トレーダー	分析を統合して実行可能な判断を生成
5. リスク管理	積極型／中立型／保守型アナリスト＋ポートフォリオマネージャー	多層的なリスク審査

📋 適した用途

✅ 適しています：

• 個別銘柄の詳細分析（テクニカル面＋ファンダメンタルズ）
• 投資判断の参考
• 取引終了後の振り返り分析
• 保有銘柄のリスク評価
• 資金フローと市場センチメントの分析

❌ 適していません：

• 取引時間中のリアルタイム監視（分析に 1～5 分かかります）
• 超短期取引（分単位の判断）
• 暗号資産、米国株など A 株以外の市場

🔒 プライバシーとセキュリティ

• 送信範囲：このスキルは、会話から株式名／コード、分析日、分析視点などのパラメーターのみを抽出し、symbol／trade_date／horizons フィールドとしてバックエンド API に送信します。会話の原文は送信せず、ローカルファイルも読み取らず、その他の個人データもアップロードしません。
• トークンのセキュリティ：TRADINGAGENTS_TOKEN（形式 ta-sk-*）はバックエンドへのアクセスに使う唯一の認証情報です。最小権限のトークンを使用してください。漏えいの疑いがある場合は、直ちに app.510168.xyz で無効化して再発行してください。
• 機密情報に関する注意：分析リクエストに個人アカウント情報、実際の保有銘柄、その他の機密情報を貼り付けないでください。このスキルでは、ユーザーが自発的にこうした情報を送信することを防止できません。
• セルフホスト：データの流れを完全に管理する必要がある場合は、GitHub ドキュメントを参考にバックエンドを自分でデプロイし、TRADINGAGENTS_API_URL を自前のサーバーに設定してください。

認証情報のメタデータについて：このスキルの frontmatter では、metadata.openclaw 内で TRADINGAGENTS_TOKEN を primaryEnv として宣言し、requires.env に含めています。

🔒 プライバシーとデータ送信

• 送信される情報：抽出された株式コード、取引日、分析パラメーター（symbol、trade_date、horizons）のみがバックエンドに送信されます。会話の原文が転送されることはありません。
• トークン：TRADINGAGENTS_TOKEN（形式 ta-sk-*）は唯一の認証情報です。最小権限のトークンを使用し、漏えいした場合は直ちにローテーションしてください。
• 機密情報：分析リクエストに個人アカウント情報、実際の保有銘柄、その他の機密情報を貼り付けないでください。
• セルフホスト：データを完全に管理するには、バックエンドを自分でデプロイし、TRADINGAGENTS_API_URL を自分のサーバーに設定してください。GitHub リポジトリを参照してください。

認証情報のメタデータ：このスキルの frontmatter では、metadata.openclaw.requires.env 内で TRADINGAGENTS_TOKEN を primaryEnv として宣言しています。

⚙️ すばやく設定

方法 1：公式ホステッドサービスを使用（デプロイ不要ですぐに利用可能）

1. https://app.510168.xyz にログインします
2. Settings → API Tokens に進み、トークンを作成します
3. 環境変数を設定します：

export TRADINGAGENTS_TOKEN="ta-sk-your_key_here"

方法 2：プライベート環境にデプロイ（データを完全に自主管理）

データプライバシーを重視する場合は、バックエンドを自分でデプロイしてください。すべての分析データは自分のサーバー上でのみ処理されます：

# 1. 部署后端，参考 https://github.com/KylinMountain/TradingAgents-AShare
# 2. 将 API 地址指向自建服务
export TRADINGAGENTS_API_URL="http://your-server:8000"
export TRADINGAGENTS_TOKEN="ta-sk-your_key_here"

🚀 よく使う操作

推奨方法：一体型スクリプトを使用（送信 → ポーリング → 結果の取得を自動実行）

# 脚本路径（相对于技能目录）
bash scripts/analyze.sh <symbol[,symbol2,...]> [trade_date] [horizons]

# 单个分析
bash scripts/analyze.sh 贵州茅台
bash scripts/analyze.sh 600519.SH 2026-03-22
bash scripts/analyze.sh 600519.SH 2026-03-22 medium

# 批量分析（逗号分隔，并行提交，统一等待）
bash scripts/analyze.sh 贵州茅台,比亚迪,宁德时代
bash scripts/analyze.sh 600519.SH,002594.SZ,300750.SZ 2026-03-22

スクリプトは、タスクの送信 → 15 秒ごとの状態ポーリング → 完了後の JSON 結果出力を自動で実行します。 一括モードでは、すべてのタスクを並列で送信し、まとめてポーリングして、最後に結果を集約して出力します。タイムアウトはデフォルトで 600 秒です。

環境変数で動作を調整できます：

• POLL_INTERVAL — ポーリング間隔（秒、デフォルトは 15）
• POLL_TIMEOUT — 最大待機時間（秒、デフォルトは 600）

手動で段階ごとに操作（各ステップを個別に呼び出す場合）

すべてのリクエストで、Bearer トークンとして $TRADINGAGENTS_TOKEN を使用します。

1. 分析タスクを送信

curl -X POST "${TRADINGAGENTS_API_URL:-https://api.510168.xyz}/v1/analyze" \
  -H "Authorization: Bearer $TRADINGAGENTS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "贵州茅台"}'

2. タスクの状態を確認

curl "${TRADINGAGENTS_API_URL:-https://api.510168.xyz}/v1/jobs/{job_id}" \
  -H "Authorization: Bearer $TRADINGAGENTS_TOKEN"

3. 分析結果全体を取得（タスク完了後）

curl "${TRADINGAGENTS_API_URL:-https://api.510168.xyz}/v1/jobs/{job_id}/result" \
  -H "Authorization: Bearer $TRADINGAGENTS_TOKEN"

📊 出力例

{
  "decision": "BUY",
  "direction": "看多",
  "confidence": 78,
  "target_price": 1850.0,
  "stop_loss_price": 1680.0,
  "risk_items": [
    {"name": "估值偏高", "level": "medium", "description": "当前 PE 处于历史 75 分位"},
    {"name": "外资流出", "level": "low",    "description": "近 5 日北向资金小幅净流出"}
  ],
  "key_metrics": [
    {"name": "PE",   "value": "32.5x",  "status": "neutral"},
    {"name": "ROE",  "value": "31.2%",  "status": "good"},
    {"name": "毛利率", "value": "91.5%", "status": "good"}
  ],
  "final_trade_decision": "综合技术面突破与基本面支撑，建议逢低分批建仓..."
}

🔄 タスクの実行フロー

詳細な分析には通常、1～5 分かかります：

1. 銘柄を特定：会話から株式名またはコード（任意の日付／視点を含む）のみを抽出し、会話の原文は送信しません
2. ユーザーに通知：タスクをまもなく送信することと、所要時間が 1～5 分であることを伝えます
3. スクリプトを実行：Bash ツールを使用して bash scripts/analyze.sh <symbol> [date] [horizons] を実行し（run_in_background: true を設定）、スクリプトで送信、ポーリング、結果の取得を自動で行います
4. 結論をまとめる：スクリプトの出力完了後、JSON の結果を解析し、判断、方向性、目標価格、リスク要因をユーザーに提示します

重要：curl を使ったポーリングループを手動で作成せず、直接 scripts/analyze.sh スクリプトを使用してください。

📌 対応銘柄の範囲

• 上海・深圳の A 株：中国語名（例：「比亚迪」「宁德时代」）またはコード（002594.SZ、601012.SH）

💡 注意事项

• 轮询频率：每次轮询间隔不低于 15 秒
• 数据健壮性：若部分数据源缺失，系统将基于宏观与行业逻辑进行外溢分析
• 短线模式：输入"分析 XX 短线"时，系统自动切换为 14 天技术面分析，跳过财报数据，速度更快