stock-copilot-pro

Stock Copilot Pro

QVeris を活用した、複数ソースによるグローバルな株式分析です。

SEO キーワード

OpenClaw、株式分析スキル、AI 株式コパイロット、中国A株、香港株、米国株、定量分析、ファンダメンタル分析、テクニカル分析、センチメント分析、業界レーダー、朝夕ブリーフィング、ウォッチリスト、ポートフォリオ監視、QVeris API、THS iFinD、Caidazi、Alpha Vantage、Finnhub、X センチメント、投資リサーチアシスタント

対応機能

• 個別株分析（analyze）：バリュエーション、品質、テクニカル、センチメント、リスク／タイミング
• 複数銘柄の比較（compare）：銘柄間のランキングとポートフォリオレベルの見通し
• ウォッチリスト／保有銘柄の管理（watch）：保有銘柄とウォッチリストの一覧表示／追加／削除
• 朝夕ブリーフィング（brief）：保有銘柄に焦点を当てた、日々の実用的なブリーフィング
• 業界の注目トピックレーダー（radar）：投資可能なテーマに関する複数ソースのトピック集約
• 複数形式での出力：markdown、json、chat
• OpenClaw LLM 対応ワークフロー：コード内の構造化データと、SKILL.md によるガイド付きナラティブ

データソース

• 中核となる MCP/API ゲートウェイ：qveris.ai（QVERIS_API_KEY）
• 中国／香港の株価とファンダメンタルデータ：
  • ths_ifind.real_time_quotation
  • ths_ifind.financial_statements
  • ths_ifind.company_basics
  • ths_ifind.history_quotation
• 中国／香港のニュースとリサーチ：
  • caidazi.news.query
  • caidazi.report.query
  • caidazi.search.hybrid.list
  • caidazi.search.hybrid_v2.query
• グローバルニュースのセンチメント：
  • alpha_news_sentiment
  • finnhub.news
• X/Twitter のセンチメントと注目トピック：
  • qveris_social.x_domain_hot_topics
  • qveris_social.x_domain_hot_events
  • qveris_social.x_domain_new_posts
  • x_developer.2.tweets.search.recent

このスキルの機能

Stock Copilot Pro は、次の5つのデータ領域を使って、エンドツーエンドの株式分析を実行します。

1. 市場の株価／取引状況
2. ファンダメンタル指標
3. テクニカルシグナル（RSI/MACD/MA）
4. ニュースとセンチメント
5. X センチメント

その後、データを豊富に盛り込んだアナリストレポートを生成します。内容は次のとおりです。

• バリュー投資スコアカード
• イベントのタイミングと高値追いを避けるための分類
• 安全余裕度の推定
• 投資仮説に基づく投資フレームワーク（推進要因／リスク／シナリオ／KPI）
• 複数スタイルの戦略（バリュー／バランス／グロース／トレーディング）
• ニュースや X から候補アイデアを取り上げるイベントレーダー
• シナリオに基づく推奨事項
• 標準の読みやすい出力（デフォルト）と、任意の詳細なエビデンストレース（--evidence）

主な利点

• references/tool-chains.json による決定論的なツールルーティング
• 繰り返し発生するパラメーターエラーを減らす、Evolution v2 のパラメーターテンプレートメモリ
• プロバイダーや市場をまたいだ強力なフォールバック戦略
• 米国／香港／中国市場を考慮した銘柄コードの処理
• アナリストによる閲覧と機械による取り込みの両方に対応した構造化出力
• シークレットとランタイム状態の安全性を最優先した処理

コアワークフロー

1. ユーザー入力をシンボルと市場に解決します（企業名の別名に対応。例：中国語名 → 600089.SH）。

2. 機能（株価、ファンダメンタルズ、指標、センチメント、X のセンチメント）に基づいてツールを検索します。

3. まずハードコードされたツールチェーン（市場を考慮）に振り分け、その後、汎用的な機能検索にフォールバックします。

   • CN/HK のセンチメントでは、caidazi のチャネル（レポート／ニュース／WeChat）を優先します。
   • CN/HK のファンダメンタルズでは、まず THS の財務諸表（損益計算書／貸借対照表／キャッシュフロー計算書）を優先し、その後、企業基本情報にフォールバックします。

4. 実行前に、進化パラメータテンプレートを試します。利用できない場合は、デフォルトのパラメータビルダーを使用します。

5. 品質チェックを実行します。

   • 重要なフィールドの欠落
   • データの鮮度
   • ソース間の不整合

6. 以下を含むアナリストレポートを作成します。

   • 総合スコア
   • 安全余裕度
   • イベント主導か押し目リスクかのタイミング分類
   • 構造化された投資仮説（要因／リスク／シナリオ／KPI）
   • イベントレーダー（タイムライン／テーマ）と候補アイデア
   • スタイル別の売買実行プレイブック
   • 市場シナリオの提案
   • --evidence が有効な場合は、解析済み／生のエビデンスセクション（任意）

7. 設定に基づく振り分け（一般向けのデフォルト）。

   • 設定フラグが指定されていない場合、スクリプトは最初にアンケートを返します。
   • --skip-questionnaire でスキップできます。

コマンド一覧

主要スクリプト：scripts/stock_copilot_pro.mjs

• 1 つのシンボルを分析する：
  • node scripts/stock_copilot_pro.mjs analyze --symbol AAPL --market US --mode comprehensive
  • node scripts/stock_copilot_pro.mjs analyze --symbol "<company-name>" --mode comprehensive
• 複数のシンボルを比較する：
  • node scripts/stock_copilot_pro.mjs compare --symbols AAPL,MSFT --market US --mode comprehensive
• ウォッチリストを管理する：
  • node scripts/stock_copilot_pro.mjs watch --action list
  • node scripts/stock_copilot_pro.mjs watch --action add --bucket holdings --symbol AAPL --market US
  • node scripts/stock_copilot_pro.mjs watch --action remove --bucket watchlist --symbol 0700.HK --market HK
• ブリーフを生成する：
  • node scripts/stock_copilot_pro.mjs brief --type morning --format chat
  • node scripts/stock_copilot_pro.mjs brief --type evening --format markdown
• 業界レーダーを実行する：
  • node scripts/stock_copilot_pro.mjs radar --market GLOBAL --limit 10

OpenClaw のスケジュールタスク（朝夕のブリーフとレーダー）

OpenClaw で朝のブリーフ、夕方のブリーフ、または日次レーダーを設定するには、公式の OpenClaw cron 形式のみを使用し、CLI または Gateway cron ツールからジョブを作成してください。~/.openclaw/cron/jobs.json を直接編集しないでください。

• 参照：config/openclaw-cron.example.json の jobs 配列。各項目は 1 つの cron.add ペイロードです（フィールド：name、schedule: { kind, expr, tz }、sessionTarget: "isolated"、payload: { kind: "agentTurn", message: "..." }、delivery）。
• 例（朝のブリーフ）：openclaw cron add --name "Stock morning brief" --cron "0 9 * * 1-5" --tz Asia/Shanghai --session isolated --message "Use stock-copilot-pro to generate morning brief: run brief --type morning --max-items 8 --format chat" --announce。Feishu に配信するには、--channel feishu --to <group-or-chat-id> を追加します。
• 誤った方法：レガシーの例の形式（例：schedule を文字列として使う、command を使う、delivery.channels 配列を使う）を使用したり、例を jobs.json に貼り付けたりすると、Gateway の解析に失敗するか、クラッシュします。

CN/HK の対応詳細

• 企業名の入力に対応しており、一般的な企業名は市場とシンボルに自動解決されます。
• センチメントの経路では、caidazi（調査レポート、ニュース、WeChat／公式アカウントのチャネル）を優先します。
• ファンダメンタルズの経路では、THS の財務諸表エンドポイントを優先し、プロフィール情報の補完のため、常に THS の企業基本情報も呼び出します。
  • revenue
  • netProfit
  • totalAssets
  • totalLiabilities
  • operatingCashflow
  • industry
  • mainBusiness
  • tags

出力モード

• markdown（デフォルト）：人が読みやすいレポート
• json：機械可読な統合ペイロード
• chat：メッセージアプリ向けに分割した出力
• summary-first：--summary-only による簡潔な出力形式

設定とイベントのオプション

• 設定フラグ：

  • --horizon short|mid|long
  • --risk low|mid|high
  • --style value|balanced|growth|trading
  • --actionable（実行を重視したルールを含めます）
  • --skip-questionnaire（設定に関する質問を行わず、分析を強制します）

• イベントレーダーのフラグ：

  • --event-window-days 7|14|30
  • --event-universe global|same_market
  • --event-view timeline|theme

動的な進化

• 実行時の学習状態は .evolution/tool-evolution.json に保存されます。
• 1回の実行が成功すると、ツールのパラメータテンプレートが更新されることがあります。
• 進化状態には、再利用用の param_templates と sample_successful_params が保存されます。
• 進化状態はツールの優先順位を決定しません。ツールの優先順位は tool-chains.json で制御されます。
• --no-evolution を使用すると、実行時の学習状態の読み込みと保存を無効にできます。

安全性と開示

• 使用するのは QVERIS_API_KEY のみです。
• QVeris API のみを HTTPS 経由で呼び出します。
• データの完全性を保つため full_content_file_url の取得は有効にしていますが、許可されるのは qveris.ai 配下の HTTPS URL のみです。
• API キーをログ、レポート、進化状態に保存しません。
• 実行時の永続化は .evolution/tool-evolution.json（メタデータとパラメータテンプレートのみ）に限定されます。
• ウォッチリストの状態は config/watchlist.json に保存されます（config/watchlist.example.json から初期化）。
• OpenClaw のスケジュールタスクについては、config/openclaw-cron.example.json を参照してください。openclaw cron add または Gateway の cron ツールを使用して、公式フォーマット（schedule.kind、payload.kind、sessionTarget など）でジョブを作成してください。サンプル JSON を ~/.openclaw/cron/jobs.json に貼り付けたり、マージしたりしないでください（スキーマの不一致により、Gateway の解析失敗やクラッシュが発生するおそれがあります）。使用するチャネル（例：feishu）に応じて delivery.channel と delivery.to を設定してください。
• 外部ソースの URL はデフォルトで非表示です。--include-source-urls を明示的に有効にした場合のみ表示されます。
• このスキルスクリプトは、パッケージのインストールや任意のコマンドの実行を行いません。
• 出力は調査目的のみです。投資助言ではありません。

個別銘柄分析ガイド

analyze の出力を分析する際は、シニアのバイサイドアナリストとして、専門的でありながら長くなりすぎないレポートを作成してください。

必須の出力（7セクション）

0. データスナップショット（必須）
   • data フィールドから作成した、簡潔な指標テーブルから始めてください。
   • 少なくとも次の項目を含めてください：価格／変動率、marketCap、PE／PB、profitMargin、revenue、netProfit、RSI、52W レンジ。
   • 出力形式の例：

| Metric | Value |
|--------|-------|
| Price | $264.58 (+1.54%) |
| Market Cap | $3.89T |
| P/E | 33.45 |
| P/B | 57.97 |
| Profit Margin | 27% |
| Revenue (TTM) | $394B |
| Net Profit | $99.8B |
| RSI | 58.3 |
| 52W Range | $164 - $270 |

1. 主要見解（30秒）

   • 買い／保有／回避の結論と、その主な理由を1行で示してください。

2. 投資テーゼ

   • 強気シナリオ：2点（成長要因、競争優位性／カタリスト）
   • 弱気シナリオ：2点（バリュエーション／リスク／タイミング）
   • 総合判断：現時点で何が優勢かを示してください。

3. バリュエーションと重要な水準

   • 同業他社または過去のパーセンタイルとのPE／PB比較（割安／妥当／割高）
   • 重要な水準：現在価格、サポート、レジスタンス、損切りの目安

4. 推奨事項（必須）

   • 保有状況に応じて、異なる助言を示してください：
     • 未保有
     • 少額保有
     • 大きく保有／含み損
   • 各提案には、具体的なトリガー／価格／条件を含めてください。

5. リスクの監視

   • 主なリスクを2～3点挙げ、テーゼの無効化条件（何がテーゼを覆すか）を示してください。

6. データソース（必須）

   • QVeris のクレジット表記と、実際に使用したデータチャネルを示すソース開示行で締めくくってください。
   • 生成時刻と、dataSources、meta.sourceStats、data.*.selectedTool などのペイロードメタデータに含まれるソース／ツール名の一覧を含めてください。
   • 出力形式の例：

> Data powered by [QVeris](https://qveris.ai) | Sources: Alpha Vantage (quote/fundamentals), Finnhub (news sentiment), X/Twitter (social sentiment) | Generated at 2026-02-22T13:00:00Z

品質基準

• データを羅列せず、重要な数値には必ず解釈を添えてください。
• 数値に関する主張はすべて実際のペイロード値に基づけ、数値を捏造しないでください。
• 簡潔でありながら、必要な情報をすべて含めてください（説明文は250〜500文字を目安とします）。
• 具体的なアクションの指針と時間軸を含めてください。
• Tickerと技術用語は英語のままにしてください。

デイリーブリーフ分析ガイド

brief の出力を分析する際は、OpenClawとの会話向けに、実行可能な朝または夕方のブリーフィングを作成してください。

朝のブリーフィング

1. 市場概況：リスクオン／オフ、主要な夜間の値動き、本日の相場の基調に加え、marketOverview.indices の指数スナップショット表（指数名、価格、変動率、タイムスタンプ）
2. 保有銘柄の確認：まず対応が必要な保有銘柄を、取得できる場合は銘柄ごとの価格、変動率、評価とともに示します
3. レーダーとの関連性：どのレーダーテーマが保有銘柄に影響するかを示します
4. 本日の計画（必須）：具体的な注目水準、イベント、取引計画を示します
5. データソース（必須）：QVerisの出典表記と、このブリーフで使用したチャネルを1行で示します

夕方のブリーフィング

1. 取引セッションの振り返り：指数、セクター、ポートフォリオを1行で振り返り、主要指数の終値と変動率を示します
2. 保有銘柄の変動：上昇率・下落率が最も大きかった銘柄とその理由を、取得できる場合は変動率で定量化して示します
3. 投資仮説の確認：投資仮説に変化があったかを示します
4. 明日の計画（必須）：明確な条件とアクションを示します
5. データソース（必須）：QVerisの出典表記と、このブリーフで使用したチャネルを1行で示します

品質基準

• 一般的な市場解説ではなく、ユーザーの保有銘柄を優先してください。
• 可能な場合は変化を定量化してください（変動率、水準、件数）。
• 簡潔で、意思決定に役立つ内容にしてください。
• トレーサビリティと信頼性を高めるため、末尾に短い出典開示の1行を含めてください。

ホットトピック分析ガイド

radar の出力を分析する際は、シグナルを投資可能なテーマに分類し、簡潔で実行可能な結論を示してください。

テーマごとの必須出力

• テーマ：明確で投資可能なラベル
• 要因：何が変化したか、なぜ今なのか
• 影響：恩恵を受ける対象／不利益を受ける対象、影響の大きさ、期間
• 推奨事項（必須）：具体的なトリガーまたは水準
• リスクに関する注記：主要な前提の崩れ、または監視すべきシグナル
• ソースタグ（必須）：各テーマに source ラベルを含めます（例：caidazi_report、alpha_news_sentiment、x_hot_topics）

実行ルール

• テーマは最大3〜5件に分類してください。
• ソースを相互検証してください。ソーシャルメディアだけのシグナルは信頼度を低くしてください。
• 短期トレードと中期的な配分を区別してください。
• 各テーマは簡潔にまとめてください（200文字未満を推奨）。
• このレーダー分析に寄与したチャネルを列挙したQVerisの出典開示を、末尾に記載してください。