pattern-vista

Pattern Vista CLI

Pattern Vista にコマンドラインからアクセスできます。Kラインパターンの過去の勝率や、MA200からの乖離ランキングを取得できます。人間だけでなく、AI エージェントからも簡単に呼び出せるように設計されています。

デフォルトの出力はJSONなので、エージェントが直接解析できます。人間が読みやすい形式で表示するには、--table を追加してください。

インストール

pip install pattern-vista     # or: uvx pattern-vista whoami

認証

https://www.pattern-vista.com でキーを生成し（アカウント → API keys）、次のコマンドを実行します。

pv config set-key pv_live_xxxxxxxx
# or, for ephemeral/agent use:
export PATTERN_VISTA_API_KEY=pv_live_xxxxxxxx

キーの解決順序：--api-key フラグ → PATTERN_VISTA_API_KEY → 保存済みの設定。

コマンド

pv whoami                       # validate key, show account + tier
pv deviation --over --limit 20  # stocks furthest ABOVE their 200-day average
pv deviation --under            # stocks furthest BELOW (mean-reversion longs)
pv patterns --limit 20          # latest recommended patterns + 20-day win-rate
pv ticker AAPL                  # one symbol: current deviation + recent patterns
pv stretch --days 120           # market breadth: % of the universe above its MA200

# add --table to any command for human output:
pv deviation --under --table

例（エージェント向けの JSON）

$ pv deviation --under --limit 3
{
  "is_billed": true,
  "rows": [
    {"ticker": "XYZ", "snapshot_date": "2026-05-27", "close": 41.2, "ma200": 58.9, "deviation": -0.3005},
    ...
  ]
}

無料プランと有料プラン

無料アカウントでは、各リストの上位 2 件と、過去の勝率を含まないパターンが表示されます。有料サブスクリプションでは、リスト全件（最大 100 件）とhist_win_w20が利用できます。プランの適用はキーに基づいてサーバー側で行われます。各レスポンスのis_billedを確認してください。

エージェント／プログラムからの利用

from pattern_vista import PatternVistaClient

pv = PatternVistaClient(api_key="pv_live_xxxx")
under = pv.deviation("under", limit=20)   # dict: {"is_billed": ..., "rows": [...]}
aapl = pv.ticker("AAPL")

PatternVistaClientのコア部分に CLI への依存はありません。以下の MCP サーバーもこれを使用するため、両者で異なる結果が返ることはありません。

MCP サーバーとして利用する

エージェントが直接呼び出せるツールとして、同じデータを利用できます。uvがあればインストールは不要です。

{
  "mcpServers": {
    "pattern-vista": {
      "command": "uvx",
      "args": ["--from", "pattern-vista[mcp]", "pattern-vista-mcp"],
      "env": { "PATTERN_VISTA_API_KEY": "pv_live_xxxxxxxx" }
    }
  }
}

これを MCP クライアントの設定に追加します（Claude Desktop、Claude Code、Cursor、または stdio 経由の MCP に対応するその他のクライアント）。インストールする場合は、次のコマンドを実行してください。

pip install 'pattern-vista[mcp]'   # then use "command": "pattern-vista-mcp"

コンテナで実行することもできます。トランスポートは stdio のため、-iが必要です。stdin が接続されていないと、サーバーは読み取るものがなく、すぐに終了します。

docker build -t pattern-vista-mcp .
docker run -i --rm -e PATTERN_VISTA_API_KEY=pv_live_xxxxxxxx pattern-vista-mcp

ツール

ツール	回答する内容
market_stretch	現在、市場全体は過熱または低迷しているか、また、その状況は過去と比べてどのような位置づけか。
deviation_ranking	それぞれの 200 日移動平均を最も下回っている（または上回っている）銘柄はどれか。
recommended_patterns	昨夜のスキャンで検出されたものは何か。また、そのパターンのグループは過去に SPY を上回ったか。
ticker_report	1 つの銘柄に関するすべての情報。
account_status	このキーに紐づくアカウントはどれか。また、有料プランか。

認証情報の解決方法は CLI と同じです。PATTERN_VISTA_API_KEYが設定されていればそれを使い、そうでなければpv config set-keyで保存したキーを使います。プランの適用はサーバー側で行われます。無料キーでは 2 件の行が返され、hist_win_w20は null になるため、短いリストを市場の動きが少ないことの表れと見なす前に、レスポンスのis_billedを確認してください。

MCP Python SDK の両方の世代（mcp 1.x のFastMCPと 2.x のMCPServer）に対応しています。

データについて

• 乖離率＝(close − MA200) / MA200。S&P 500、Nasdaq 100、および主要 ETF のユニバースを対象に、毎晩更新されます。分割の影響を受けた値や妥当でない値は、ランキングの前に除外されます。
• 市場の騰落状況（pv stretch、market_stretch）は、同じユニバースのうち、それぞれの MA200 を上回って引けた銘柄の割合です。取引日ごとに 1 つの値が記録され、その履歴も確認できます。すべてのプランで無料です。https://www.pattern-vista.com/market/stretch の公開ページに掲載される値と同じです。
• 勝率（hist_win_w20）は、同じパターンの種類、方向、形状を持つ過去のシグナルのうち、その後の 20 取引日に SPY を上回ったものの割合です。https://www.pattern-vista.com/track-record に掲載されるシグナルごとの記録と同じです。確定したシグナルが 10 件未満の場合は null になります。
• 過去の実績は将来の成果を保証するものではありません。投資助言ではありません。

ライセンス

MIT