alphasmo-tools

AlphaSMO — AI 向け究極のスマートマネー API

AlphaSMO 向けの CLI + MCP サーバー — SEC EDGAR の 13F 機関保有情報、Form 4 のインサイダー取引、「スマートマネーの収束」シグナル（ヘッジファンド と 企業インサイダーが同時に買い付けている銘柄）を、ターミナル、スクリプト、または MCP 対応の AI エージェント（Claude、ChatGPT、Cursor など）から照会できます。

登録不要、API キー不要、セットアップ不要 — 今すぐお試しください。

npx alphasmo stocks flows --limit 10

出力例：

┌────────┬──────────────────────────────┬────────────────────┬──────────────┬──────────────┐
│ ticker │ issuer                       │ net flow (USD)     │ avg weight % │ institutions │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ BRK-A  │ BERKSHIRE HATHAWAY INC-CL A  │ 247,455,256,379    │ 1.42         │ 1418         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AZN    │ AstraZeneca PLC              │ 148,465,847,587.12 │ 0.47         │ 1309         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ XOM    │ EXXON MOBIL CORP             │ 138,784,059,363.77 │ 0.78         │ 4716         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CVX    │ CHEVRON CORP                 │ 77,783,933,645.44  │ 0.6          │ 4261         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ JNJ    │ JOHNSON & JOHNSON            │ 64,498,075,844.9   │ 0.76         │ 4603         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ SNDK   │ SANDISK CORP                 │ 58,662,972,096.01  │ 0.65         │ 1172         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ MU     │ MICRON TECHNOLOGY INC        │ 55,374,569,969.23  │ 0.7          │ 2993         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AMAT   │ APPLIED MATERIALS INC        │ 48,790,109,328.41  │ 0.52         │ 2931         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ EEM    │ ISHARES MSCI EMERGING MARKET │ 48,211,222,155.7   │ 0.59         │ 1637         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CAT    │ CATERPILLAR INC              │ 46,035,710,179.58  │ 0.5          │ 3724         │
└────────┴──────────────────────────────┴────────────────────┴──────────────┴──────────────┘

AlphaSMO を選ぶ理由

• 📊 13F 機関保有情報 — すべてのヘッジファンドと資産運用会社の四半期ごとの SEC 提出書類：運用資産残高、保有銘柄、行動特性を示す「パーソナリティスコア」（集中度、売買回転率、セクターへの確信度）。13F 提出書類とは？ と機関投資家の保有銘柄の変化を読み解く方法 のガイドをご覧ください。
• 🕵️ インサイダー取引（Form 4 および 144） — 役員、取締役、10％以上の所有者による買い付けと売却に、銘柄ごとの信頼度スコアを付与します。Form 4 提出書類とは？ とForm 144 提出書類とは？ で詳しく説明しています。
• 🚀 スマートマネーの収束 — 中核となるシグナルです。13F の機関投資家 と 企業インサイダーの両方が現在買い付けている銘柄を示します。
• 🤖 AI エージェント向けに構築 — MCP サーバーをすぐに利用できるため、Claude、ChatGPT、Cursor、または任意の MCP クライアントが会話の途中で実際の金融データを取得できます。
• 🆓 無料の匿名利用枠 — 試すのに登録は不要です。無料の API キーを取得すれば、いつでもレート制限を引き上げられます。

ユースケース

"What is smart money buying right now?"        → alphasmo convergence
"What does Berkshire Hathaway hold?"            → alphasmo institutions holdings berkshire-hathaway-inc
"Are insiders buying or selling NVDA?"          → alphasmo insider summary NVDA
"Which stocks are institutions dumping?"        → alphasmo stocks flows --direction sell

MCP サーバーを Claude Desktop、Claude Code、Cursor、または任意の MCP クライアントに接続し（下記を参照）、これらを平易な英語で質問できます — コードは不要です。

CLI

npx alphasmo institutions search "Berkshire"
npx alphasmo stocks get AAPL
npx alphasmo convergence -l 5

インストール手順は不要です — npx が取得して実行します。または、グローバルにインストールしてください。

npm install -g alphasmo
alphasmo --help

コマンド

コマンド	返される内容
alphasmo institutions search <query> [-l|--limit]	名前で13F機関を検索します
alphasmo institutions list [-l|--limit] [-o|--offset]	機関の全一覧をページ分割して取得します（検索クエリなし）
alphasmo institutions get <slug>	機関の詳細情報とセクター別ウェイト
alphasmo institutions holdings <slug>	1つの機関の最新13F保有銘柄
alphasmo stocks get <identifier>	株式の詳細情報 — 保有者数、資金フロー、主要保有者（identifier = ティッカーまたはCUSIP）
alphasmo stocks flows [-d|--direction buy|sell] [-l|--limit]	機関投資家の買い／売りの純フローでランク付けした株式
alphasmo insider trades <ticker>	1つのティッカーの最近の個人によるForm 4インサイダー取引
alphasmo insider summary <ticker>	1つのティッカーのインサイダー信頼度スコア（30日／90日）
alphasmo convergence [-l|--limit] [--min-confidence] [--days]	13F機関とインサイダーの両方が買い付けているティッカー — 代表的なシグナル
alphasmo mcp	標準入出力でMCPサーバーを起動します

すべてのコマンドで使用できるグローバルフラグ：--api-key <key>（環境変数 ALPHASMO_API_KEY）、--base-url <url>（環境変数 ALPHASMO_BASE_URL）、-f／--format json|compact|table|csv、--json（--format jsonの省略形）、--csv（--format csvの省略形）。

出力形式はコンテキストに応じて自動判定されます — 通常はフラグ不要です：

• ターミナルに直接入力した場合 → 読みやすいテーブル形式で、数値はカンマ区切りになります（263,095,703,570）。
• パイプやリダイレクトを使用した場合、またはスクリプト／AI エージェントから起動した場合（stdoutがTTYではない場合）→ JSON形式となり、jqへのパイプやエージェントへの入力に安全に使用できます。
• --format／--json／--csvを指定すると、いずれの場合も自動判定が常に上書きされます。

alphasmo stocks flows --csv > flows.csv
alphasmo insider trades AAPL --csv | column -s, -t

エラーはstderrに出力され、エラーの種類ごとに異なる終了コードが返されます（見つからない場合は2、認証エラーは3、レート制限は4、予期しないレスポンス形式は5、その他は1）。そのため、スクリプトでは文字列を照合せずに処理を分岐できます。

APIキーを取得する

匿名リクエストはIPアドレスごとにレート制限されます。**alphasmo.com/developer**で登録して無料キーを発行し、次のように使用します：

alphasmo convergence --api-key ask_live_...
# or
export ALPHASMO_API_KEY=ask_live_...

MCPサーバー

オプション1：claude mcp add（推奨）

Claude Codeを使用している場合、次のコマンド1つでサーバーを登録できます：

claude mcp add alphasmo -- npx -y alphasmo@latest mcp

レート制限を引き上げるには、--の前に-e ALPHASMO_API_KEY=ask_live_...を追加します。claude mcp listを実行して、接続を確認してください。

オプション2：MCPクライアント設定を手動で追加

Claude Desktop、Cursor、その他のMCPクライアントでは、設定ファイルに直接次の内容を追加します：

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": ["alphasmo", "mcp"],
      "env": { "ALPHASMO_API_KEY": "optional-your-key-here" }
    }
  }
}

どちらの方法も、キーを使う場合より低いレート制限で、初期状態から匿名で利用できます。公開されるツール：search_institutions、get_institution_profile、get_institution_holdings、get_stock_overview、get_stock_flows、get_insider_activity、get_smart_money_convergence。

エンドポイントの完全なリファレンス：alphasmo.com/developer/docs。

プログラムからの使用

import { AlphasmoClient } from "alphasmo";

const client = new AlphasmoClient(); // no apiKey needed to try it
console.log(await client.getSmartMoneyConvergence({ limit: 5 }));

npm install alphasmo

PythonクライアントとMCPサーバーも利用できます。セットアップについてはalphasmo.com/developerをご覧ください。

詳細情報

• alphasmo.com — 機関プロフィール、株式スクリーナー、インサイダー取引ランキングを備えた完全なウェブアプリ
• alphasmo.com/developer — 無料のAPIキーを取得
• alphasmo.com/developer/docs — 公開APIの完全なリファレンス

教育ガイドとSEC提出書類の詳細解説

機関投資家の保有状況とSEC提出書類の仕組みについて、理解を深めましょう。

• 13F提出書類とは？ — 機関投資家の保有状況の開示に関する初心者向けガイドです。
• Form 4提出書類とは？ — インサイダーによる買付・売却がどのように報告されるかを解説します。
• Form 144提出書類とは？ — インサイダーによる大量売却の前に提出されるSECへの事前通知について解説します。
• 13Dと13Gの実質的所有権 — 5％超の保有に関する提出書類と、アクティビスト投資家の意図を明らかにします。
• 機関投資家の保有状況の変化を読み解く方法 — 株式分割やオプションの仕組みに惑わされず、13Fポートフォリオの変化を読み解きます。

ライセンス

MIT