この文書は、GitHub Releases から tv の配布アーカイブをダウンロードした
ユーザーと、その tv を使うエージェント AI 向けの案内です。開発者向けの
ビルド手順ではありません。
tv は TradingView 用のコマンドラインツールです。TradingView Desktop を
開かずにデータを読むコマンドと、手元の TradingView Desktop に接続して
チャートや画面状態を読むコマンドがあります。tv は TradingView のアカウント、
サブスクリプション、ペイウォール、取引所データ契約、スクリプト所有権を
回避するものではありません。
GitHub Releases から、自分の環境に合うファイルをダウンロードします。
- Windows:
tv-<tag>-x86_64-pc-windows-msvc.zip - macOS Apple Silicon:
tv-<tag>-aarch64-apple-darwin.tar.gz - macOS Intel:
tv-<tag>-x86_64-apple-darwin.tar.gz - Linux:
tv-<tag>-x86_64-unknown-linux-gnu.tar.gz - チェックサム:
SHA256SUMS
可能であれば SHA256SUMS でアーカイブを確認してから展開してください。
アーカイブには、tv 本体、README、CHANGELOG、ライセンス、この導入文書、
エージェント向けガイド、実行時用のスキルが含まれます。
展開したディレクトリから直接実行できます。
- macOS/Linux:
./tv --version - Windows PowerShell:
.\tv.exe --version
普段使いする場合は、実行ファイルを PATH が通った場所に置くと、ユーザーも
エージェント AI も tv ... として実行できます。
tv --version期待したバージョンが表示されれば、まずは tv を実行できる状態です。
出力は tv <バージョン> (<コミット> <日付>) の形式で、コミットと日付が
そのバイナリの素性を示します。コミットに -dirty が付いている場合は、
未コミットの変更を含めてビルドされたバイナリで、配布アーカイブでは
本来発生しません。完全なコミットハッシュや対象プラットフォームの
ターゲット三つ組が必要な場合は tv --version --verbose を実行してください。
配布アーカイブには、エージェント向けの AGENTS.md、CLAUDE.md、
.agents/skills/、.claude/skills/ が含まれます。ローカルファイルを読めて、
シェルコマンドを実行できるエージェントアプリに、これらのファイルを読ませて
ください。
起動方法は、使うアプリによって少し変わります。
tvをPATHが通った場所に置いた場合、エージェントはどの作業フォルダから でもtv ...と実行できます。tvをPATHに置かない場合は、エージェントのカレントフォルダを配布 アーカイブを展開したフォルダに合わせ、macOS/Linux では./tv ...、 Windows では.\tv.exe ...と実行させます。- エージェントが別のプロジェクトのフォルダで作業している場合は、
tvをPATHに置くか、展開した実行ファイルの場所をエージェントに渡してください。
最初の依頼は、たとえば次のようにします。
同梱されている
tvを使ってください。最初にtv --versionを実行して ください。TradingView Desktop を使わずに読める情報で足りる場合は、 そちらを優先してください。Desktop のチャートを読む前にはtv readinessを確認してください。実行したコマンドと、どの種類の情報を読んだのかを 報告してください。TradingView の状態を変更する操作は、事前に確認を 取ってください。
大事なのは、似た名前のコマンドでも「読んでいるもの」が違うことです。たとえば、
tv bars は TradingView Desktop を使わずに履歴の足を取得します。一方で
tv ohlcv は、いま選択されている Desktop チャートの足を読みます。どちらも
便利ですが、同じ根拠として扱うと検証結果がずれます。
最初に覚えるとよい使い分けは次のとおりです。
tv quote、tv quotes、scanner、fundamentals、tv events、tv barsは TradingView Desktop を使わずに読み取ります。tv barsは、再現可能な履歴の足を取得するための入口です。tv watch compareは、既知の複数銘柄を短時間だけ見続けるための コマンドです。TradingView Desktop を使わず、scanner 由来の価格情報を 1行ずつ JSON で出します。tv rangeは、表示中の Desktop チャートの表示範囲を読みます。--fromと--toを付けると、必要な場合だけ選択中チャートの古い履歴を 上限付きで読み込み、該当する足がある場合に表示範囲を動かし、paging と coverage の状態を返します。tv ohlcvは、選択中の Desktop チャートから足を読みます。tv quote --source quote-dataは、Desktop を使って quote-data という TradingView 内部の価格情報を明示的に読みます。tv observe chartとtv stream ...は、選択中の Desktop チャートを 一定時間だけ観測し、1行ずつ JSON を出します。
tv snapshot や tv compare が follow_up_hints[] を返すことがあります。
これは「次に確認できる候補」です。実行するコマンド、情報の種類、TradingView
Desktop が必要かどうか、そして auto_execute: false が含まれます。エージェント
には、別の確認コマンドを実行する前に、これらを報告させてください。
エージェントには、実行したコマンドと、どの種類の情報を読んだのかを報告させて
ください。履歴データ、選択中チャート、価格情報を混同しないようにするためです。
tv は市場データをランキング、スコア、売買推奨、投資助言に変換するツールでは
ありません。
最初は TradingView Desktop を使わない読み取りコマンドで確認するのが安全です。
tv quote AAPL
tv info NASDAQ:AAPL
tv bars AAPL --timeframe 1D --count 5
tv bars NASDAQ:AAPL --timeframe 1D --count 5
tv events NASDAQ:AAPL --event-type earnings
tv events NASDAQ:AAPL --event-type dividends
tv watch compare NASDAQ:AAPL NASDAQ:MSFT --duration-ms 10000 --interval 2000tv events は、scanner 由来の決算・配当の項目を、イベントとして読みやすい形に
まとめます。完全なイベントカレンダーではありません。また、ランキング、推奨、
売買判断を出すものでもありません。
古いチャート例や検証用の履歴データを取得したい場合は、表示中チャートを動かす
のではなく tv bars を使います。
tv bars NASDAQ:CRUS --timeframe 1D --from 2010-01-01 --to 2010-12-31
tv bars NASDAQ:CRUS --timeframe 1W --from 2010-01-01 --to 2010-12-31
tv bars NASDAQ:CRUS --timeframe 1M --from 2010-01-01 --to 2010-12-31
tv bars NASDAQ:AAPL --timeframe 1 --from 2026-05-20 --to 2026-05-20 --count 1000
tv bars NASDAQ:AAPL --timeframe 5 --from 2026-05-20 --to 2026-05-22 --count 1000
tv bars NASDAQ:AAPL --timeframe 60 --from 2026-05-01 --to 2026-05-22 --count 1000tv bars では、AAPL のように取引所名を付けない銘柄も検索で解決を試みます。
ただし、どの取引所を使うかを確実に指定したい場合は、NASDAQ:AAPL のように
取引所:銘柄 の形で書いてください。エージェントに依頼するときは、
requested_symbol、resolved_symbol、symbol_resolution を確認し、入力した
銘柄と実際に使われた銘柄を報告させると、取引所の取り違えを避けやすくなります。
日付範囲を指定した場合は、まず range_coverage_status と
range_alignment を確認してください。日付範囲指定で使える時間軸は、現時点
では 1 分足（1 または 1m）、5 分足、15 分足、30 分足、60 分足、日足、
週足、月足です。3 分足、45 分足、120 分足、180 分足、240 分足は、
日付範囲指定ではまだ使えません。
分足、週足、月足では、足の時刻はその期間の開始時刻や
開始日を表します。指定した開始日から終了日までの範囲に、その時刻が入っている
足だけが返ります。日付範囲を指定した場合の --count は返す足の最大本数で、
指定しなければ 500 本、最大で 5000 本です。直近本数を取る通常の使い方では、
最大 500 本のままです。さらに range_fetch_summary を見ると、追加取得を何回
行ったか、返却本数の上限で切られたか、取得元や待ち時間の都合で範囲を満たせな
かったかを確認できます。
チャート状態、スクリーンショット、Pine、Replay、Screener などを扱うには、
手元の TradingView Desktop セッションが必要です。この準備は、普通にアプリを
開くだけとは少し違います。tv が TradingView Desktop と通信できるように、
ローカル接続用の設定付きで起動されている必要があります。
一番簡単なのは、tv に TradingView Desktop の起動または既存セッションの再利用を
任せる方法です。
tv launch
tv readiness
tv tab list
tv statetv launch は、まず既に接続できる TradingView Desktop があるかを確認します。
接続できる場合は、そのまま既存のセッションを使います。接続できない場合は、tv
が必要とするローカル接続用の設定を付けて TradingView Desktop を起動しようと
します。その後、tv readiness でチャートを読める状態かを確認し、tv tab list
で接続先の一覧を見て、tv state で選択中チャートを読めることを確認します。
macOS では、通常の tv launch はシステムのアプリ起動機能を使います。これに
より、TradingView Desktop が tv コマンドの子プロセスとして扱われ続けることを
避けます。tv launch --path <TRADINGVIEW_DESKTOP_PATH> は、特定の実行ファイルを
明示して起動したい場合だけ使ってください。--kill-existing は、既に開いている
TradingView Desktop を終了して起動し直してよい場合だけ使います。
direct spawn と通常の macOS システム起動は、TradingView を起動する前に互換性の
ない継承 Electron mode を除去します。cdp_ready: false の warning response は、
アプリがまだ読み込み中の可能性を示すため、再試行する前に tv readiness を実行
してください。direct spawn 後の structured connection error は、child が終了した
か、その状態を確認できなかったことを示します。手動でアプリを起動するか、明示
した path を修正してから再試行してください。明示的な許可なしに
--kill-existing を追加しないでください。
tv launch が TradingView Desktop を見つけられない場合は、実行ファイルの
場所を指定します。
tv launch --path <TRADINGVIEW_DESKTOP_PATH>エージェント AI に任せる場合は、次のように依頼します。
tv launchを実行して、tvが使える形で TradingView Desktop を起動または 再利用してください。その後、tv readiness、tv tab list、tv stateを 実行して結果を報告してください。tv launchがアプリを見つけられない場合は、 TradingView Desktop の場所を私に確認してください。この準備中に、チャートの 銘柄、時間足、アラート、描画、アカウント状態は変更しないでください。
手動で TradingView Desktop を先に開いてから、エージェントに tv readiness を
実行させる方法もあります。ただし、それで接続できない場合は、tv launch を使って
tv が必要とするローカル接続用の設定付きで起動してください。
複数の TradingView 接続先が開いている場合は、tv tab list や
tv readiness に表示される target_cli_args を使います。
tv --target-id <ID> state実際の接続先 ID、つまり --target-id に渡す値は、手元のセッションに紐づく
情報です。接続先 ID、アカウント固有の ID、クッキー、トークン、ローカルの
パスを共有メモや公開文書に貼らないでください。
チャート、アカウント、Pine、Replay、Screener、アラート、ウォッチリスト、 描画、レイアウトを変更する前に、まず読み取りコマンドで状態を確認します。
tv state
tv ohlcv --summary --count 100
tv screenshot --region chart --output target/tv-chart.png --wait-for-renderチャートやパネルの状態を変更した直後に撮る場合は、安定したチャート状態を
待つため --wait-for-render を指定できます。待機は明示指定した場合だけ行われ、
期限切れ時は画像を作成・上書きしません。既定の 5000 ms を変更する場合だけ、
待機フラグとともに --wait-timeout-ms <500..30000> を指定してください。
短時間だけ選択中チャートを観測したい場合は、1行ずつ JSON を出す観測コマンドを 使います。
tv observe chart --duration-ms 10000 --heartbeat-ms 2000
tv stream bars --max-events 5これらのコマンドは、準備状態、サンプル、定期的な状態通知、最後のまとめを出します。 選択中の Desktop チャートを観測するものであり、TradingView Desktop を使わない 履歴の足の取得や、複数銘柄のリアルタイム配信ではありません。
TradingView Desktop を使わずに、既知の複数銘柄を短時間だけ見続けたい場合は、 次のコマンドを使います。
tv watch compare NASDAQ:AAPL NASDAQ:MSFT --duration-ms 10000 --interval 2000 --heartbeat-ms 3000このコマンドは、contract_version: "watch_compare.v1" を持つ JSON 行を
出します。_event を見て、準備状態、サンプル、定期的な状態通知、最後のまとめを
区別してください。これは scanner 由来の価格情報であり、選択中の Desktop
チャートを読んだものではありません。
README.md: プロジェクト概要と主要コマンド例。AGENTS.md/CLAUDE.md: 配布アーカイブ内でエージェントに読ませる実行時ガイド。docs/command-source-taxonomy.md: リポジトリ内の詳しいコマンド分類。docs/observation-workflows.md: リポジトリ内の実用的な読み取り手順。