deepentropy/tvscreener

これは何？

主な機能

• 01株式、ETF、暗号資産、外国為替、債券、先物、コイン、指数、経済指標のスクリーニング
• 02has()やabove_pct()などの演算子を使ったOR条件とネストしたフィルター
• 03銘柄の財務諸表、企業イベント、季節性リターン
• 04TradingViewのリアルタイム株価のストリーミング取得
• 05ニュース、提出書類、決算説明会のトランスクリプトの取得
• 06Pandas DataFrameでの結果取得と、自動更新ストリーミング

ユースケース

• Jupyter Notebookで、バリュエーション、配当、モメンタムの条件に基づいて株式をスクリーニングする
• 定期的に更新しながら、値動きの大きい暗号資産や外国為替を監視する
• 調査用に財務諸表や決算カレンダーを取得する
• MCPサーバーを通じて、AIアシスタントからスクリーナーデータを利用できるようにする

クイックスタート

1. 1

   PyPIからライブラリをインストールする

   pip install tvscreener
2. 2

   ライブラリをインポートして、基本的なStock Screenerクエリを実行する

   python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"

使う前に知っておきたいこと

• !これはTradingViewとは提携関係のない、非公式のサードパーティ製ライブラリです。
• !利用にあたってはTradingViewの利用規約が適用されます。また、TradingViewがデータを変更した場合、動作しなくなる可能性があります。

トピック

よくある質問

tvscreener とは？

TradingViewから株式、暗号資産、外国為替、債券、先物などのスクリーナーデータを取得し、Pandas DataFrameにまとめる非公式Pythonライブラリ。 tvscreenerは、TradingViewのスクリーナーデータを扱うPythonクライアントです。株式、ETF、暗号資産、外国為替、債券、先物、コイン、指数、経済指標のスクリーニングを実行し、フィールド、市場、国で絞り込んで、結果をPandas DataFrameとして取得できます。

tvscreener は無料で使えますか？ライセンスは？

tvscreener は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

tvscreener は今もメンテナンスされていますか？

活発にメンテナンス中。tvscreener の最終コミットは 2026年11月1日 です。

tvscreener は何に使えますか？

Jupyter Notebookで、バリュエーション、配当、モメンタムの条件に基づいて株式をスクリーニングする 定期的に更新しながら、値動きの大きい暗号資産や外国為替を監視する 調査用に財務諸表や決算カレンダーを取得する MCPサーバーを通じて、AIアシスタントからスクリーナーデータを利用できるようにする

tvscreener のインストール方法は？

PyPIからライブラリをインストールする: pip install tvscreener ライブラリをインポートして、基本的なStock Screenerクエリを実行する: python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"

tvscreener はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/deepentropy/tvscreener