tradingview-reader

TradingView リーダー（読み取り専用）

ホストが以下のシェルプローブをまだ実行していない場合（たとえば Codex の場合）は、セットアップ方法を選ぶ前に、シェルツールを使って ! で囲まれたコマンドを実行してください。実際の出力を使用してください。シェルにアクセスできない場合は、その制限を報告してください。

opencli と、実行中の TradingView.app プロセスへの CDP 接続を介して、TradingView の macOS デスクトップアプリから株価、オプションチェーン、チャートの状態を読み取ります。このリポジトリの opencli-plugins/tradingview ツリーにある tradingview プラグインを利用します（opencli に組み込まれているアダプターとは別のプラグインで、opencli のモノレポのサブパス構文を使ってインストールします）。

このスキルは読み取り専用です。 分析向けに設計されており、オプションチェーンの取得、IV／グリークスの確認、チャート状態の取得に使用します。取引の発注、アイデアの投稿、ウォッチリストの変更、チャートレイアウトの変更は行いません。

ヘッドレス環境での代替手段：通常の株価、TA の読み取り結果、スクリーナー、先物、またはグリークスなしのオプションチェーンには、兄弟スキルの tradingview-mcp（同梱の MCP サーバーを使用。デスクトップアプリも CDP の再起動も不要）を優先してください。グリークス／行使価格ごとの IV スキュー、契約数付きの満期、またはアカウントに紐づくデータ（ウォッチリスト、アラート、チャート、TV ニュース）が必要な場合は、この スキルを使用してください。

重要：ブラウザベースの opencli リーダー（twitter、linkedin）とは異なり、このツールは Chrome DevTools Protocol を介して、実行中の TradingView デスクトップアプリと直接通信します。ユーザーは（a）TradingView.app をインストールし、（b）そのアプリ内でログインしている必要があります。プラグインがデバッグポートを使った再起動を処理します。

仕組み：データコマンドは CDP 経由でアプリのセッション Cookie を読み取り、Node から TradingView の HTTP API を直接呼び出すため、Browser Bridge 拡張機能や apps.yaml への登録は不要です。

---

ステップ 1：opencli とプラグインがインストールされ、使用可能であることを確認する

現在の環境の状態：

!`(command -v opencli && opencli tradingview status 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

上記の状態が READY の場合は、ステップ 2 に進んでください。それ以外の場合：

NOT_INSTALLED — opencli をインストールする

npm install -g @jackwener/opencli

Node.js >= 24 が必要です。次のステップでインストールする tradingview プラグインが engines.node >= 24 を指定しているためです。

SETUP_NEEDED — TradingView プラグインをインストールし、CDP を使って起動する

TradingView アダプターは opencli に組み込まれていません。別途プラグインが必要です。

# Install the plugin
opencli plugin install github:himself65/finance-skills/tradingview

# Relaunch TradingView.app with CDP enabled (one-time per session)
opencli tradingview launch

launch の手順では、実行中の TradingView を終了し、--remote-debugging-port=9222 を指定して再度開きます。未保存の描画がある場合は、事前にチャートレイアウトを保存するようユーザーに警告してください。

よくあるセットアップの問題

症状	解決方法
opencli: command not found	npm install -g @jackwener/opencli（Node ≥ 24）
Unknown command: tradingview	opencli plugin install github:himself65/finance-skills/tradingview
Cannot reach CDP at http://127.0.0.1:9222	アプリがデバッグポート付きで起動していません。opencli tradingview launch を実行してください
No tradingview.com cookies found	アプリは開いていますが、ログアウトしています。デスクトップアプリ内でログインしてください
No TradingView tab found	TradingView でチャートまたは銘柄ページを開いてから、再試行してください
チェーンが空／契約数が 0	ログイン中のアカウントのサブスクリプションプランに、この銘柄のオプションが含まれていません

---

ステップ 2：ユーザーの要望を確認する

セットアップ／チャートの確認

ユーザーの要望	コマンド	主なフラグ
セットアップ／接続の確認	opencli tradingview status	—
CDP を使ってアプリを再起動する	opencli tradingview launch	--port 9222
チャートに何が表示されているか	opencli tradingview chart-state	--tab <id>
チャートのスクリーンショットを撮る	opencli tradingview screenshot --output ~/charts/nvda.png	--tab <id>

相場価格＋オプション

ユーザーのリクエスト	コマンド	主なフラグ
現在値を確認	opencli tradingview quote --ticker X	--exchange NASDAQ
オプションチェーン（全件）	opencli tradingview options-chain --ticker X	--exchange
オプションチェーン（満期日を指定、ATM 範囲）	opencli tradingview options-chain --ticker X --expiry YYYY-MM-DD	--type call|put、--strikes-around-spot N
満期日一覧	opencli tradingview options-expiries --ticker X	—

スクリーナー

ユーザーのリクエスト	コマンド	主なフラグ
汎用スクリーナー（株式／暗号資産／外国為替／先物／債券）	opencli tradingview screener --market america --columns ...	--filter <json>、--sort field:desc、--limit N、--label-product
RSI が 30 未満の米国株を出来高順に並べる	opencli tradingview screener --market america --columns "name,close,RSI|60,volume" --filter '[{"left":"RSI|60","operation":"less","right":30}]' --sort volume:desc	—
時価総額上位の暗号資産	opencli tradingview screener --market coin --columns "name,close,change,market_cap_calc" --sort market_cap_calc:desc --limit 50	—
シンボル検索／オートコンプリート	opencli tradingview search --query "nvidia"	--type stock|funds|crypto|...、--exchange、--country

ニュース

ユーザーのリクエスト	コマンド	主なフラグ
世界のニュース見出し	opencli tradingview news --limit 25	--category、--area、--section、--provider
特定のティッカーのニュース	opencli tradingview news --symbol NASDAQ:AAPL	--limit、--section analysis|press_release|...
ID で記事全文を取得	opencli tradingview news --id <story-id>	--lang en

ウォッチリスト＋アラート

ユーザーのリクエスト	コマンド	主なフラグ
すべてのウォッチリストを一覧表示	opencli tradingview watchlists	—
1 つのウォッチリスト内のシンボル	opencli tradingview watchlists --id <wl-id>	—
色付きフラグのリスト（赤／オレンジ／黄／緑／青／紫）	opencli tradingview watchlists --color red	—
すべてのアラートを一覧表示	opencli tradingview alerts --type list	—
有効なアラート	opencli tradingview alerts --type active	—
最近発動したアラート	opencli tradingview alerts --type triggered	—
オフライン中に発動したアラート	opencli tradingview alerts --type offline	—
アラートの全ログ	opencli tradingview alerts --type log	—

---

ステップ 3：コマンドを実行する

一般的なパターン

# Use -f json or -f yaml for structured output
opencli tradingview options-chain --ticker SNDK --expiry 2026-05-22 -f json
opencli tradingview options-chain --ticker NVDA --strikes-around-spot 8 -f csv
opencli tradingview quote --ticker SPY --exchange NYSEARCA -f json

主なルール

1. 接続状態が不明な場合は、最初に opencli tradingview status を実行してください。CDP 接続の状態と、TradingView のアクティブなタブが報告されます。
2. プログラムで処理する場合（LLM のコンテキスト、後続のスキルなど）は、-f json を使用してください。
3. 期限と --strikes-around-spot で絞り込んでください。チェーン全体では 3,000 行を超えることがあり、絞り込みなしの出力がユーザーの求める内容であることはほとんどありません。
4. 米国株式では --exchange NASDAQ をデフォルトにします。ETF（例：SPY = NYSEARCA、QQQ = NASDAQ）や米国以外の上場銘柄では、--exchange を明示してください。
5. screener では、--columns を慎重に選んでください。リクエストと出力テーブルの両方を制御します。name と、--filter または --sort で使用するフィールドを含めてください。インジケーターの時間足を指定するには、|TF を追加します。たとえば、1 時間足の RSI には RSI|60 を指定します。デフォルトの列は株式には適切ですが、暗号資産／FX／先物ではフィールドのカタログが異なるため、置き換える必要があります。
6. screener の --filter は JSON です。{left, operation, right} 句の配列を指定します。エスケープの問題を避けるため、シェルでは JSON を必ずシングルクォートで囲んでください。操作の一覧は references/commands.md を参照してください。
7. news では、早い段階でフィードを絞り込んでください。グローバルフィードは大量に流れます。--limit を増やす前に、--symbol、--category、--section、または --provider を使用してください。
8. search を使用して推測を避けてください。ユーザーが曖昧なティッカー（例：取引所の指定がない「SPY」）を提示した場合は、まず search --query SPY を実行して上場先を確認し、その後のコマンドに --exchange を指定してください。
9. watchlists と alerts では、デフォルトで概要を表示してください。「ウォッチリストには何が入っていますか？」と尋ねるユーザーが求めているのは、通常、すべての銘柄ではなくリスト名と件数です。
10. 読み取り専用です。取引、ウォッチリストの編集、アラートの作成／削除、チャートへの書き込みはできません。このプラグインは書き込み用エンドポイント（/append、/replace、/create_alert など）を意図的に公開していないため、回避策を探さないでください。

出力形式フラグ（-f）

形式	フラグ	最適な用途
テーブル	-f table（デフォルト）	人が読みやすいターミナル出力
JSON	-f json	プログラムでの処理、LLM のコンテキスト
YAML	-f yaml	構造化された読みやすい出力
Markdown	-f md	ドキュメント、レポート
CSV	-f csv	スプレッドシートへのエクスポート

出力列

• quote — symbol、close、change、change_abs、currency、time
• options-chain — expiry、dte、strike、type、bid、ask、mid、iv、delta、gamma、theta、vega、rho、theo、bid_iv、ask_iv、symbol
• options-expiries — expiry、dte、contracts_count
• screener — 動的です。symbol に加えて、--columns の各項目につき 1 列が出力されます。（デフォルト：name、close、change、volume、market_cap_basic、sector.tr。）
• search — symbol、description、type、exchange、country、currency
• news（リストモード）— id、published、provider、title、urgency、related_symbols、link
• news（ストーリーモード、--id を設定）— id、published、provider、title、body、tags、link
• watchlists — id、name、symbol_count、symbols
• alerts — id、name、symbol、type、condition、value、active、status、fired_at
• chart-state — layout_id、symbol、interval、url
• screenshot — path、bytes

---

ステップ 4：結果を提示する

1. まず構成の概要を示します — オプションチェーンの場合は、スポット価格、表示中の満期日、ATM ストライク、IV レジームを最初に伝え、その後にテーブルを示します。スクリーナーの場合は、一致件数と適用したフィルターを最初に伝えます。
2. 表示前に十分に絞り込みます — 3,000 行のチェーンや 500 行のスクリーナーをそのまま貼り付けないでください。チェーンは各満期日についてデフォルトで ATM ± 6 ストライク、スクリーナーはユーザーから追加の指定がない限り上位 20 件に制限します。
3. スキューを強調します — コールとプットの両方を示す場合、重要なIVスキューの方向を説明します。
4. チャートの状態については、レイアウト ID、シンボル、インターバル、URL を簡潔に報告し、スクリーンショットの撮影を提案します。
5. ニュース（リストモード）では、プロバイダー別にまとめ、ユーザーの想定タイムゾーンのタイムスタンプを先頭に示します（不明な場合は常に UTC の ISO 形式を使用します）。ユーザーが記事を開けるようにリンクを含めます。ストーリーモード（--id を設定）では、本文はプレーンテキストなので、そのまま提示し、必要に応じて短くします。
6. ウォッチリストでは、シンボルを列挙する前に件数を要約します（例：「3 個のウォッチリスト：Earnings（24 シンボル）、AI plays（12 シンボル）、Hedges（8 シンボル）」）。依頼されない限り、100 シンボルのウォッチリストの内容をすべて表示しないでください。
7. アラートでは、ステータス別（アクティブ、トリガー済み／発火済み）にまとめ、最近発火したものから fired_at の降順に並べます。ユーザーから明示的に求められない限り、アラート ID を表示しないでください。
8. スクリーナーの結果では、まず上位の値動きや極端な値を通常の文章で示し（例：「時価総額が最も高いのは NVDA の 4.2T ドル、RSI<30 のしきい値を下回る銘柄は 12 件です」）、その後にテーブルを示します。
9. セッションはプライベートとして扱います — ユーザーから求められない限り、CDP ターゲット ID、Cookie、レイアウト ID を決して公開しないでください。

---

ステップ 5：診断

opencli tradingview status

CDP 接続の状態とアクティブな TradingView タブを返します。CDP が停止している場合は、opencli tradingview launch を実行してデバッグポートを使用して再起動します。

---

エラーリファレンス

エラー	原因	対処方法
Unknown command: tradingview	プラグインがインストールされていません	opencli plugin install github:himself65/finance-skills/tradingview
Cannot reach CDP at http://127.0.0.1:9222	デバッグポートなしでアプリが起動しています	opencli tradingview launch
No tradingview.com cookies found	TradingView からログアウトしています	デスクトップアプリ内でログインします
No TradingView tab found	アプリは開いていますが、TradingView のページが読み込まれていません	任意のチャートまたはシンボルページを開いてから、再試行します
scanner 400 / Empty chain / totalCount=0	契約プランにこのシンボルのオプションが含まれていません	デスクトップアプリでアカウントの契約プランを確認します
Symbol not found	取引所が正しくありません	--exchange を明示的に指定するか、先に opencli tradingview search --query <name> を実行します
レート制限	リクエストが多すぎます	数秒待ってから再試行します

---

参考ファイル

• references/commands.md — すべてのコマンドとフラグ、出力例、アナリスト向けワークフロー