Tradingview Mcp Server

AI アシスタント向け TradingView MCP マーケットデータとテクニカル分析

_{15秒、実際の出力（2026年10月13日時点のマーケットデータ） · TradingMCP としてホストされたこのサーバー · 高画質で視聴}

TradingView MCP サーバー — Claude、ChatGPT、Cursor、Copilot、およびあらゆる MCP クライアント向けのリアルタイム市場データ、テクニカル指標、スクリーナー、バックテスト機能です。世界中の取引所の株式、暗号資産、外国為替、先物に対応しています。 バックテスト＋リアルタイムのセンチメント＋Yahoo Finance＋39種類のテクニカル分析ツールを、最も包括的な TradingView MCP ツールキットとして1つのサーバーに集約しています。

何もインストールしたくない場合は？ このサーバーのホスト版である TradingMCP を使えば、AIアプリですべての39種類のツールを利用できます。Claude、Cursor、Grokでは、コネクターとして https://mcp.tradingmcp.ai/mcp を追加してサインインするだけです。キーを貼り付ける必要はありません。ChatGPT、Copilot、その他の MCP クライアントは、専用リンクで接続します。月額9ドルから、14日間の返金保証付きです。セルフホストは引き続き無料です。

1つのプロンプトで朝のマーケット速報を取得：「今朝のマーケット速報を教えて」と尋ねるだけで、世界の指数、先物、ビットコインの動向、ホスト版のMarketsパネルをまとめて確認できます。チャートはチャット内に直接描画されます（下のデモをご覧ください）。Grok Botでは、Market Brief botを追加すると、平日の朝にマーケット速報を受け取れます。

🆕 ホスト版（TradingMCP）でチャートを描画できるようになりました。 チャートをリクエストすると、インタラクティブなローソク足チャート（1d／1h／15m、ボリンジャーバンドのオーバーレイは任意）がMCP Appsを通じて会話内に直接リアルタイムで表示され、AIがバンドの値を読み上げてくれます。

URLを1つ追加してサインイン（または pip install）するだけで、あとは尋ねるだけです。 ライブサーバーからの実際の出力をご覧ください。

まずはこちらをお試しください — Claude、ChatGPT、Cursor、その他すべてのMCPクライアントで動作します：

Show today's top crypto gainers on Binance
Run a full technical analysis of NVDA
What's the multi-timeframe read on gold?
Backtest an RSI strategy on BTC on the daily timeframe

メモ

独立したオープンソースプロジェクトです — TradingView Inc. とは提携、推奨、関連関係にありません。「TradingView」は各権利者の商標です。このプロジェクトはサードパーティの市場データを利用するものであり、TradingView の製品ではありません。

メモ

TradingView アカウントは必要ですか、またはリスクにさらされますか？いいえ。 このサーバーは TradingView セッションへのログイン、スクレイピング、自動操作を行わず、TradingView アカウントや API キーも必要ありません。市場データはサーバー側で公開エンドポイントから取得するため、お客様のアカウントが関与することはなく、ブラウザーや UI の自動操作もありません。(Chrome DevTools 経由で TradingView Desktop アプリを操作するMCPサーバーとは異なります。) 利用するデータソースの利用規約を遵守していることを確認する責任は、お客様にあります。

デスクトップ自動操作型の TradingView MCP との比較（TradingView Desktop をリモート操作するもの）

現在、「TradingView MCP」は大きく異なる2種類のプロジェクトを指します。どちらも便利ですが、用途が異なります：

	このプロジェクト — データ・分析 API	デスクトップ自動操作型 MCP
必要なもの	何もありません — 公開市場データ	TradingView Desktop。通常は有料の TradingView プランも必要です
動作する場所	Claude.ai、Claude Code、ChatGPT、Cursor、Copilot — すべてのMCPクライアント	主に Claude Code。ご自身のマシン上
マシンの電源がオフの場合	ホスト版は24時間365日応答を続けます	停止します
スクリーナーとバックテスト	組み込み済み（39個のツール、複数取引所に対応）	TradingView UI が提供する機能によります
チャート	会話内で操作できるチャート（MCP Apps、ホスト版）	TradingView 独自のチャート
TradingView アカウント	不要。アカウントにアクセスすることもありません	ログイン済みセッションを操作します

ご自身の TradingView Desktop を AI に操作させ、Pine Script の編集、チャートへの描画、リプレイの利用を行いたい場合は、tradesdontlie/tradingview-mcpをご覧ください。インストール不要で TradingView アカウントも関与せず、あらゆるAIクライアントでヘッドレスの市場データ、スクリーナー、バックテストを利用したい場合は、このプロジェクトが最適です。

重要

投資助言ではありません。 このソフトウェアが生成する内容は、投資、金融、法律、税務、会計に関する助言ではありません。tradingview-mcp は情報提供と学習を目的とした分析ツールです。インジケーター、スコア、シグナル、「トレード設定」、エントリー、損切り、目標価格などの出力は、サードパーティの市場データに基づいて算出されるものであり、資産の購入、売却、保有を推奨するものではありません。取引の執行や資金管理は行わず、いかなる結果も保証しません。取引や投資には大きな損失のリスクがあり、資本の一部または全部を失う可能性があります。金融上の判断を行う前に、必ずご自身で調査し、資格を有する専門家に相談してください。ご自身の判断および適用される法令の遵守については、お客様が単独で責任を負います。市場データには遅延、不正確さ、不完全さが含まれる場合があり、保証なしで提供されます。 [!TIP] セットアップ不要がよいですか？ ホスト版をご利用ください。 TradingMCP は、Claude、ChatGPT、Cursor、Grok、Copilot で39個すべてのツールを提供します。uv、pandas、Python を扱う必要はなく、Claude、Cursor、Grok ではキーを貼り付ける代わりにサインインするだけです。月額9ドル（Pro）または29ドル（Pro+ — より高い上限）で、14日間の返金保証付きです。 セルフホストは永久に無料です。ホスト版は、運用作業を省きたい方向けです。(セルフホスト版とホスト版の詳しい比較は、以下のクイックスタートをご覧ください。)

⭐ このツールがワークフローの改善に役立った場合は、ぜひリポジトリにスターを付け、スポンサーをご検討ください。プロジェクトの継続と成長につながります！

---

🎥 フレームワークのデモ

https://github-production-user-asset-6210df.s3.amazonaws.com/67838093/478689497-4a605d98-43e8-49a6-8d3a-559315f6c01d.mp4

---

🆕 新機能

安定性と戦略の拡充（2026年5月）

• 非同期ホットパスツール — トラフィックの多い7つのツール（yahoo_price、stock_extended_hours、top_gainers、volume_breakout_scanner、multi_timeframe_analysis、financial_news、combined_analysis）をasync defに変更しました。FastMCPでは、同期ツールはイベントループ上で直列に実行されます。非同期化によりサーバー内で実際に並列実行できるようになり、同時に呼び出されたツールが実際に重なって処理されます。さらに、combined_analysisではasyncio.gatherを使って3つのサブコールを並列実行することで、この強力なツールの壁時計時間を約3倍改善しています。yahoo_price／stock_extended_hoursではhttpx.AsyncClientを使用して真のノンブロッキングI/Oを実現し、同期ライブラリを使うツール（tradingview_ta、tradingview-screener、feedparser）はasyncio.to_threadで別スレッドにオフロードします。(PR — オープン)
• バックテスト戦略を9種類に拡充（6種類から増加） — rsi_pullback、keltner_breakout、triple_emaを追加し、トレンドの押し目買い、ATRで正規化したブレイクアウト、SMA200フィルターを適用したEMAクロスのエッジに対応しました。compare_strategiesで9種類すべてを比較できるようになりました。
• レジリエンスレイヤー — TradingViewスクリーナープロバイダーに自動再試行と60秒のTTLキャッシュを追加し、combined_analysisとmulti_timeframe_analysisで一時的に発生する"Expecting value"エラーを解消しました。(PR #32 — マージ済み)
• 金融ニュースサービスを再構築 — 非推奨になったReutersのRSSエンドポイントをYahoo Finance、MarketWatch、CNBCに置き換えました。financial_newsで長年発生していたcount: 0のバグを修正しました。(PR #33 — マージ済み)
• TAのスロットリング — 同時実行するtradingview_taの呼び出し数（デフォルトは4）を制限し、開始間隔を最低0.8秒にします。combined_analysis／multi_timeframe_analysisの並列実行が急増し、TradingViewのレート制限により空のレスポンスが返る問題を防ぎます。環境変数で調整できます。(PR #34 — マージ済み)
• ウォークフォワードバックテスト（walk_forward_backtest_strategy） — 過剰適合の判定（ROBUST／MODERATE／WEAK／OVERFITTED）を含む、学習データとテストデータの分割に対応しました。
• 時間足（1h） — backtest_strategy、compare_strategies、walk_forward_backtest_strategyで対応しました。
• 全取引ログとエクイティカーブの出力（include_trade_log=True、include_equity_curve=True）。

---

🏗️ アーキテクチャ

---

✨ tradingview-mcp を選ぶ理由

機能	tradingview-mcp	従来のセットアップ	Bloomberg Terminal
セットアップ時間	5 分	数時間（Docker、Conda など）	数週間（契約手続き）
費用	無料＆オープンソース	変動	年間 30,000 ドル以上
バックテスト	✅ 9 種類の戦略＋ウォークフォワード＋シャープレシオ	❌ 手動スクリプト作成	✅ 独自機能
ニュース＆センチメント	✅ ライセンス取得済みニュース＋銘柄ごとのセンチメント（Marketaux）	❌ 別途セットアップ	✅ Terminal
市場データ	✅ ライブ／リアルタイム	履歴データ／遅延	ライブ
API キー	不要	複数（OpenAI など）	該当なし

---

警告

セキュリティに関する注意：このリポジトリを装ったコピーについて。 このプロジェクトは Python 専用であり、公式の npm／Node.js パッケージはありません。公式の提供元は、このリポジトリ（atilaahmettaner/tradingview-mcp）、PyPI パッケージ tradingview-mcp-server、およびホスト版の TradingMCP（tradingmcp.ai、以前の pro.cryptosieve.com）のみです。

別のアカウントから公開されたこのリポジトリのコピーには、npm 経由でマルウェアをインストールする依存関係を含む package.json が追加されています（例：oracle-redis、MAL-2026-16390）。別のアカウントから「tradingview-mcp」リポジトリをクローンして npm install を実行した場合、そのマシンは侵害されたものとして扱ってください。報告してくれた @roberttidball に感謝します（#101）。

🚀 クイックスタート（5 分）

実行方法は 2 通り。どちらも同じ 39 個のツールを利用できます：

	🧑‍💻 セルフホスト（このリポジトリ）	☁️ ホスト版 — TradingMCP
料金	永久無料（MIT）	Pro：月額 9 ドル · Pro+：月額 29 ドル · 14 日間返金保証
最初の呼び出しまでの時間	約 5 分（Python＋uv）	約 60 秒（URL を 1 つ追加してサインイン）
アップデートと運用	自分で実行・更新	マネージド — 常に最新
実行環境	ご自身のマシンまたは VPS	ホスト環境からエッジ経由でストリーミング
制限	ご自身のハードウェア	月 2,500 回 · 分 60 回（Pro）→ 月 10,000 回 · 分 150 回（Pro+）
おすすめの方	試してみたい方、フォークする方、完全に制御したい方	運用作業を省きたい方

☁️ セットアップ不要： Claude、Cursor、Grok で https://mcp.tradingmcp.ai/mcp をコネクターとして追加してサインインしてください。ChatGPT、Copilot、その他のクライアントでは、専用リンクを使用します → 月額 9 ドルから TradingMCP を始める（14 日間返金保証） · セットアップガイド。以下はすべてセルフホスト向けです。

pip でインストール

pip install tradingview-mcp-server

オプション：ニュース＆センチメント（無料の Marketaux キー）

financial_news と market_sentiment（および combined_analysis のニュース／センチメント部分）は、Marketaux が提供する、銘柄ごとのセンチメント付きライセンス取得済み市場ニュースを使用します。無料の API キーを取得し（1 日 100 リクエスト。サーバーは 4 時間キャッシュし、ニュースとセンチメントで取得結果を共有するため、無料枠を十分に活用できます）、次のように設定してください：

export MARKETAUX_API_TOKEN=your_token_here   # optional

トークンが設定されていない場合、これら 2 つのツールは「未設定」であることを知らせるメッセージを返します。他のツールはすべて通常どおり動作します。

Claude Desktop の設定（claude_desktop_config.json）

注： macOS では、Claude Desktop などの GUI アプリの PATH に ~/.local/bin が含まれていない場合があります。「command not found」エラーを避けるため、uvx のフルパスを使用してください。

{
  "mcpServers": {
    "tradingview": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uvx",
      "args": ["--from", "tradingview-mcp-server", "tradingview-mcp"]
    }
  }
}

Linux では /Users/YOUR_USERNAME を /home/YOUR_USERNAME に置き換えてください。Windows では %USERPROFILE%\.local\bin\uvx.exe を使用してください。

Codex プラグインの設定

このリポジトリには、MCP のみを対象とした Codex プラグインのメタデータも含まれています。

• .codex-plugin/plugin.json
• .codex-mcp.json

このプラグインでは、同じ PyPI パッケージのエントリーポイントを使用します。

{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": ["--from", "tradingview-mcp-server", "tradingview-mcp"]
    }
  }
}

Codex プラグインをインストールまたは有効化した後、次のセッションで MCP サーバーが読み込まれるように Codex を再起動してください。Codex のバージョンによっては、codex mcp list に登録済みの MCP サーバーが表示されますが、ツールが利用できることは、新しい Codex セッションで確認してください。

またはソースから実行

git clone https://github.com/atilaahmettaner/tradingview-mcp
cd tradingview-mcp
uv run tradingview-mcp

ホスト版とTradingView公式のMCPはどう違いますか？

TradingViewは2026年9月16日に、独自のMCPサーバーをパブリックベータとして公開しました。優れた製品であり、用途によってはこちらのほうが適しています。率直な違いを以下に示します（競合製品に関する情報は、2026年10月にTradingView独自のMCPドキュメント、公開記事、料金ページで確認しました）。

1. データだけでなく、分析も。 TradingMCPは複数の時間軸にわたる分析、ウォークフォワード・バックテスト、スマートマネーと出来高のスキャンを実行し、チャット内にインタラクティブなチャートを描画します。TradingViewのMCPが返すのはデータ、スクリーナー、単一時間軸のテクニカル評価です。ツール一覧にはバックテストやチャート描画はありません（ドキュメント、2026年10月確認）。
2. 朝のマーケット概要を1つのプロンプトで。 世界市場のスナップショット、先物の概要、ビットコインの動向、Marketsパネルを1つの回答にまとめます。
3. 月額9ドルですべて含まれ、他に契約は不要です。 TradingViewのMCPは、有料のTradingViewプランのうちEssential以上にのみ含まれます。トライアルプランには含まれません（ドキュメント、料金、2026年10月確認）。TradingMCPはProが月額9ドル、Pro+が月額29ドルで、14日間の返金保証があります。このリポジトリをセルフホストすれば無料です。

TradingViewのMCPが優れている点： ファンダメンタルズとアナリスト予測、SEC提出書類と決算説明会のトランスクリプト、TradingViewのウォッチリストとアラートの編集、TradingViewから公式に提供されるデータ（ドキュメント、2026年10月確認）。これらが必要であれば、TradingViewのMCPを利用するか、両方を併用してください。

TradingMCPを試す · Claude、ChatGPT、Cursor、Grok、Copilot、または任意のMCPクライアントで動作します。

---

🛠️ トラブルシューティング

🪟 Windows：初回起動時に MCP error -32001: Request timed out が発生する

症状 — 設定を追加した直後に、Claude Desktopのログに次のメッセージが表示されます。

[tradingview] Server started and connected successfully
[tradingview] Message from client: initialize ...
[60 seconds later]
[tradingview] notifications/cancelled — reason: "MCP error -32001: Request timed out"

原因： Python 3.14はまだサポートされていません。uvxは初回実行時にtradingview-mcp-serverをダウンロードし、新しい仮想環境を作成して依存関係をインストールします。MCPスタックに含まれる一部のネイティブ依存関係は、現在、Python 3.14に対応したホイールを公開していません。そのため、インストール時にソースからビルドされるか、Claude Desktopによるサーバーの初期化が完了する前に失敗する可能性があります。

解決方法 — Python 3.13に固定します（ビルド済みpandasホイールがあります）：

{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": ["--python", "3.13", "--from", "tradingview-mcp-server", "tradingview-mcp"]
    }
  }
}

macOSでは、uvxのフルパスを指定してください（クイックスタートの注記を参照）。Windowsでは通常、uvxは%USERPROFILE%\.local\bin\uvx.exeにあります。

別の方法 — あらかじめ一度インストールし、その後Claude Desktopにキャッシュを再利用させます：

# Run in a terminal before launching Claude Desktop
uv tool install --python 3.13 tradingview-mcp-server

インストールが完了したら、通常の設定でClaude Desktopを起動してください。キャッシュがすでに準備されているため、サーバーはすぐに起動します。

クレジット： @wyh4444さんによる、#24での最初の報告に感謝します。

---

⚠️ エラーエンベロープ形式

構造化エラー形式を採用したツールは、通常のペイロードまたはエラーエンベロープを返します。

{"error": {"code": "ALL_BATCHES_FAILED", "message": "All 5 batches failed; first error: JSONDecodeError(...)", "batches_attempted": 5, "batches_failed": 5, "first_error": "...", "retryable": true}}

理由： 従来の [] ／ {"error": "Analysis failed: ..."} という文字列では、「今日は一致するものがない」のか「上流のレート制限に達した」のかを区別できませんでした。新しいエンベロープは code でプログラムから分岐でき、retryable により、待って再試行することで解決するかどうかを呼び出し元に伝えます（上流の障害は収束しますが、依存関係の欠落は自然には解消されません）。

完全対応（上流の停止、シンボルリストの空、依存関係の欠落、予期しない例外など、すべての失敗モードで、生の文字列やトレースバックではなくエンベロープを返します）：top_gainers、top_losers、bollinger_scan、rating_filter、volume_breakout_scanner、smart_volume_scanner。

一部対応（主なエラーパスでエンベロープを返します）：coin_analysis、volume_confirmation_analysis、consecutive_candles_scan、futures_market_overview、futures_top_movers、stock_prices、およびバックテストの入力ガード。残りのツールは複数のバッチに分けて移行中です。進捗は #76 で確認できます。

エラーの検出方法：

result = volume_breakout_scanner(exchange="KUCOIN")
if isinstance(result, dict) and "error" in result:
    code = result["error"]["code"]
    if result["error"].get("retryable"):
        # Wait + retry, raise alert, fall back to single-batch call, etc.
        ...
else:
    for row in result:
        ...

安定したコードは core/errors.py で定義されています。

---

📱 Telegram、WhatsApp などから利用する（OpenClaw）

OpenClaw を使って、このサーバーを Telegram、WhatsApp、Discord および 20 以上のメッセージングプラットフォームに接続できます。OpenClaw はセルフホスト可能な AI ゲートウェイです。Hetzner VPS（Ubuntu 24.04）でテストし、動作を確認済みです。

仕組み

OpenClaw は Telegram のメッセージを AI エージェントに転送します。エージェントは trading.py（薄い Python ラッパー）を使って tradingview-mcp の関数を呼び出し、整形した結果を返します。OpenClaw とサーバーの間に MCP プロトコルは不要です。Python の直接インポートで連携します。

Telegram → OpenClaw agent (AI model) → trading.py (bash) → tradingview-mcp → Yahoo Finance

クイックセットアップ

# 1. Install UV and tradingview-mcp
curl -LsSf https://astral.sh/uv/install.sh | sh && source ~/.bashrc
uv tool install tradingview-mcp-server

# 2. Configure OpenClaw channels
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  channels: {
    telegram: {
      botToken: "YOUR_BOT_TOKEN_HERE",
    },
  },
}
EOF

# 3. Configure gateway + agent
openclaw config set gateway.mode local
openclaw config set acp.defaultAgent main

# 4. Set your AI model (choose ONE option below)
openclaw configure --section model

# 5. Install the skill + tool wrapper
mkdir -p ~/.agents/skills/tradingview-mcp ~/.openclaw/tools
curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/tradingview-mcp/main/openclaw/SKILL.md \
  -o ~/.agents/skills/tradingview-mcp/SKILL.md
curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/tradingview-mcp/main/openclaw/trading.py \
  -o ~/.openclaw/tools/trading.py && chmod +x ~/.openclaw/tools/trading.py

# 6. Start the gateway
openclaw gateway install
systemctl --user start openclaw-gateway.service

AI モデルを選ぶ

OpenRouter は必須ではありません。API キーを持っているプロバイダーを使用できます。

プロバイダー	OpenClaw 用モデル ID	キーの取得先
OpenRouter（アグリゲーター — すべてのモデルを利用可能）	openrouter/google/gemini-3-flash-preview	openrouter.ai/keys
Anthropic（Claude への直接接続）	anthropic/claude-sonnet-4-5	console.anthropic.com
Google（Gemini への直接接続）	google/gemini-2.5-flash	aistudio.google.com
OpenAI（GPT への直接接続）	openai/gpt-4o-mini	platform.openai.com

# Examples — set your chosen model:
openclaw config set agents.defaults.model "openrouter/google/gemini-3-flash-preview"  # via OpenRouter
openclaw config set agents.defaults.model "anthropic/claude-sonnet-4-5"               # Anthropic direct
openclaw config set agents.defaults.model "google/gemini-2.5-flash"                   # Google direct

⚠️ 重要： プレフィックスはプロバイダーと一致させる必要があります。google/... には Google API キーが必要です。openrouter/... には OpenRouter キーが必要です。

⚠️ よくある間違い

症状	原因	対処法
Unrecognized keys: mcpServers	このバージョンでは mcpServers がサポートされていません	設定から削除し、bash ラッパーを使用します
No API key for provider "google"	google/model を指定していますが、OpenRouter キーしかありません	代わりに openrouter/google/model を使用します
which agent? のループ	acp.defaultAgent が設定されていません	openclaw config set acp.defaultAgent main を実行します
ゲートウェイが起動しない	gateway.mode がありません	openclaw config set gateway.mode local を実行します

ボットをテストする

起動したら、Telegram ボットに次のメッセージを送信します。

market snapshot
backtest RSI strategy for AAPL, 1 year
compare all strategies for BTC-USD

👉 OpenClaw セットアップガイドの全文 →

---

基本的なスクリーナーとは異なり、このフレームワークでは専門分野に特化した AI エージェントがリアルタイムで分析結果を議論します。

1. 🛠️ テクニカルアナリスト — ボリンジャーバンド（独自評価 ±3）、RSI、MACD
2. 🌊 センチメント＆モメンタムアナリスト — Reddit コミュニティのセンチメント ＋ 価格モメンタム
3. 🛡️ リスクマネージャー — ボラティリティ、ドローダウンリスク、平均回帰シグナル

出力：STRONG BUY ／ BUY ／ HOLD ／ SELL ／ STRONG SELL と信頼度スコア

---

🔧 39 個の MCP ツールすべて

📊 バックテストエンジン

ツール	説明
backtest_strategy	9つの戦略のうち1つを、機関投資家向けの指標（Sharpe、Calmar、期待値）を用いてバックテストします。1d と 1h の時間足に対応しており、オプションで全取引ログとエクイティカーブを出力できます。
compare_strategies	同じ銘柄に対して9つの戦略すべてを実行し、パフォーマンス順にランク付けします。
walk_forward_backtest_strategy	学習／テスト分割によるウォークフォワード検証を行い、過剰適合の判定（ROBUST / MODERATE / WEAK / OVERFITTED）を出力します。

テスト可能な9つの戦略：

• rsi — RSIの売られすぎ／買われすぎを利用した平均回帰
• bollinger — Bollinger Bandを利用した平均回帰
• macd — MACDのゴールデンクロス／デッドクロス
• ema_cross — EMA 20/50のゴールデンクロス／デッドクロス
• supertrend — ATRベースのSupertrendトレンドフォロー 🔥
• donchian — Donchian Channelブレイクアウト（タートルトレーダー方式）
• rsi_pullback — 確認済み上昇トレンドでの押し目買い（SMA50>SMA200 + RSI<40でエントリー） 🆕
• keltner_breakout — ATR正規化ブレイクアウト（EMA20 + 2·ATR上限バンド） 🆕
• triple_ema — SMA200トレンドフィルターで条件付けされたEMA 20/50クロス 🆕

🆕 戦略では、SMA200トレンドフィルターのウォームアップを完了するため、period='1y' または '2y' が必要です。

取得できる指標： 勝率、総リターン、Sharpe Ratio、Calmar Ratio、最大ドローダウン、プロフィットファクター、期待値、最良／最悪の取引、バイ・アンド・ホールドとの比較。現実的な手数料とスリッページのシミュレーションも含まれます。

Example prompt: "Compare all 9 strategies on MSFT for 2 years"
→ #1 triple_ema:        +15.1% | Sharpe:  0.0 | WR: 100%
→ #2 keltner_breakout:  +14.3% | Sharpe:  4.7 | WR:  40%
→ #3 bollinger:         +12.2% | Sharpe:  4.1 | WR:  64%
→ Buy & Hold:            -2.1%

---

💰 Yahoo Finance — リアルタイム価格 (v0.6.0で追加)

ツール	説明
yahoo_price	リアルタイムの価格情報：価格、変動率、52週高値／安値、マーケットの状態
market_snapshot	グローバル市場の概要：S&P500、NASDAQ、VIX、BTC、ETH、EUR/USD、SPY、GLD

対応対象： 株式（AAPL、TSLA、NVDA）、暗号資産（BTC-USD、ETH-USD、SOL-USD）、ETF（SPY、QQQ、GLD）、指数（^GSPC、^DJI、^IXIC、^VIX）、FX（EURUSD=X）、トルコ株（THYAO.IS、SASA.IS）

---

🌍 グローバル株式スクリーナー — 普通株・優先株

ツール	説明
stock_screener	任意のTradingView対応国市場（america、korea、germany、brazil、…）の普通株または優先株を、価格、通貨、変動率、配当利回りとともに一覧表示し、時価総額順にランク付けします。TradingViewの「Common stock」／「Preferred stock」銘柄検索フィルターに対応するAPI版です。
stock_prices	特定の銘柄の価格を直接検索します（カンマ区切りのEXCHANGE:SYMBOL形式。例：NASDAQ:NVDA, KRX:005930）。価格、通貨、日次変動率を返し、認識できないティッカーはnot_foundに記載します。

---

🧠 AIセンチメント＆インテリジェンス

ツール	説明
market_sentiment	金融関連コミュニティ全体のRedditセンチメント（強気／弱気スコア、人気投稿）
financial_news	Yahoo Finance、MarketWatch、CNBC、CoinDesk、CoinTelegraphからの最新RSSヘッドライン
combined_analysis	強力なツール：TradingViewのテクニカル指標 + Redditセンチメント + 最新ニュースから、複合的な判断を導きます。一時的なスクリーナーエラーへの耐性を高めるため、リトライ機能と60秒キャッシュを追加しました。

---

📈 テクニカル分析のコア機能

ツール	説明
get_technical_analysis	テクニカル分析一式：RSI、MACD、Bollinger、23の指標とBUY/SELL/HOLD判定
get_multiple_analysis	複数銘柄のテクニカル分析を一括実行します
get_bollinger_band_analysis	独自の±3 BB評価システム
get_stock_decision	3層の意思決定エンジン（ランキング + 取引設定 + 品質スコア）
screen_stocks	20以上のフィルター条件に対応する複数取引所のスクリーナー
scan_by_signal	シグナルの種類（売られすぎ、トレンド、ブレイクアウトなど）でスキャンします
get_candlestick_patterns	15種類のローソク足パターンを検出します
get_multi_timeframe_analysis	週足→日足→4H→1H→15mの整合性を分析します

---

🌍 複数の取引所に対応

取引所	ツール
Binance	暗号資産スクリーナー、全ペア
KuCoin / Bybit+	暗号資産スクリーナー
NASDAQ / NYSE	米国株（AAPL、TSLA、NVDA...）
EGX (Egypt)	egx_market_overview、egx_stock_screener、egx_trade_plan、egx_fibonacci_retracement
Turkish (BIST)	TradingView スクリーナー経由
Europe & Canada	Euronext（Paris、Amsterdam、Brussels、Lisbon）、LSE、Xetra、Frankfurt、Milan、SIX、Madrid、TSX、TSX Venture
India & Indonesia	NSE、BSE（NIFTY、BANKNIFTY、SENSEX）、IDX（Jakarta Composite）

---

💬 AI との会話例

You: "Give me a full market snapshot right now"
AI: [market_snapshot] → S&P500 -3.4%, BTC +0.1%, VIX 31 (+13%), EUR/USD 1.15

You: "What is Reddit saying about NVDA?"
AI: [market_sentiment] → Strongly Bullish (0.41) | 23 posts | 18 bullish

You: "Backtest RSI strategy on BTC-USD for 2 years"
AI: [backtest_strategy] → +31.5% return | 100% win rate | 2 trades | B&H: -5%

You: "Which of the 9 strategies worked best on MSFT in the last 2 years?"
AI: [compare_strategies] → triple_ema #1 (+15.1%, WR 100%), keltner_breakout #2 (+14.3%), macd last (-23.4%)

You: "Run walk-forward backtest on supertrend for SPY"
AI: [walk_forward_backtest_strategy] → Verdict: ROBUST (avg robustness 0.92) | OOS return +8.5%

You: "Analyze TSLA with all signals: technical + sentiment + news"
AI: [combined_analysis] → BUY (Technical STRONG BUY + Bullish Reddit + Positive news)

---

💖 プロジェクトを支援する

このフレームワークは無料のオープンソースで、余暇を利用して開発しています。調査時間を大幅に節約できたり、より良い判断に役立ったりした場合は、スポンサーをご検討ください。

ティア	月額	特典
☕ Coffee	$5	心からの感謝＋README にお名前を掲載
🚀 Supporter	$15	上記に加えて、バグ修正を優先
💎 Pro	$30	上記に加えて、機能リクエストを優先

スポンサーからの支援はすべて、ウォークフォワード・バックテスト、Twitter/X のセンチメント分析、マネージドクラウドホスティングなどの新機能に直接充てられます。

---

📋 ロードマップ

• TradingView のテクニカル分析（30 以上のインジケーター）
• 複数取引所のスクリーナー（Binance、KuCoin、MEXC、EGX、米国、欧州、カナダ、インド、インドネシアの株式）
• Reddit のセンチメント分析
• ライブ金融ニュース（Yahoo / MarketWatch / CNBC / CoinDesk / CoinTelegraph）
• Yahoo Finance のリアルタイム価格
• バックテストエンジン（9 つの戦略＋Sharpe / Calmar / Expectancy）
• ウォークフォワード・バックテスト（過剰適合の検出）
• スクリーナープロバイダーのレジリエンスレイヤー（再試行＋TTL キャッシュ）
• 1 時間（1h）のバックテスト期間
• Twitter/X の市場センチメント
• ペーパートレードのシミュレーション
• マネージドクラウドホスティング（ローカル環境のセットアップ不要）

---

📄 ライセンス

MIT License — 詳細は LICENSE をご覧ください。

---

免責事項：このツールは教育および研究のみを目的としており、金融アドバイスを提供するものではありません。投資判断を行う前に、必ずご自身で調査してください。