| name | finance-mcp |
| description | 株価・為替・暗号資産・財務データを MCP サーバ (alphavantage / twelvedata / edinetdb) 経由で取得・分析します。「株価を調べて」「銘柄の推移を」「為替レート」「企業の財務を」「決算」「ASCII グラフにして」「米国株 / 日本株を調査」などのリクエストがあった場合に使用します。 |
Finance MCP Skill
金融・市場データ系の 3 つの MCP サーバを使い分けて、株価・為替・暗号資産・経済指標・企業財務を取得・分析するスキル。
対象 MCP サーバと使い分け
| MCP | 主な守備範囲 | 認証 | ツール方式 |
|---|
alphavantage | 米国・グローバル株式の OHLCV、テクニカル指標、オプション、為替、暗号資産、コモディティ、米経済指標、企業財務 | API キー (設定済み) | メタツール方式 |
twelvedata | グローバル株式・為替・暗号資産・ETF のリアルタイム/時系列、テクニカル指標 | OAuth (authenticate → complete_authentication) | 認証後にツール提供 |
edinetdb | 日本上場企業 (~3,800 社) の財務諸表・有報・セグメント・株主・役員報酬など EDINET ベースの詳細データ | Bearer API キー | 個別ツール |
選択指針
- 米国株・グローバル株の価格/チャート/テクニカル →
alphavantage(まず第一候補)。
- alphavantage で取れない/レート制限に当たった場合の代替価格ソース →
twelvedata。
- 日本企業の財務・有報・株主構成など定性/定量の詳細 →
edinetdb。価格時系列ではなく企業ファンダメンタルズ向け。
alphavantage の使い方(メタツール方式)
直接エンドポイント名のツールは呼べない。必ず 3 段階で呼ぶ:
TOOL_LIST # 利用可能ツール名と説明の一覧(パラメータは含まない)
↓
TOOL_GET(tool_name) # 当該ツールの inputSchema(必須引数・型)を取得
↓
TOOL_CALL(tool_name, arguments) # 実行。arguments は TOOL_GET のスキーマに一致させる
TOOL_GET を飛ばして TOOL_CALL すると必須引数が分からず失敗する。
よく使うツール
- 価格時系列:
TIME_SERIES_DAILY / TIME_SERIES_INTRADAY / TIME_SERIES_WEEKLY / _MONTHLY(_ADJUSTED 版あり)
- 最新気配:
GLOBAL_QUOTE / REALTIME_BULK_QUOTES(最大 100 銘柄)
- 銘柄検索:
SYMBOL_SEARCH / SEARCH(自然言語)
- 市場状態:
MARKET_STATUS
- テクニカル:
SMA / EMA / RSI / MACD / BBANDS / ATR / VWAP ほか多数
- 企業財務:
COMPANY_OVERVIEW / INCOME_STATEMENT / BALANCE_SHEET / CASH_FLOW / EARNINGS
- 為替/暗号資産:
FX_DAILY / CURRENCY_EXCHANGE_RATE / CRYPTO_INTRADAY / DIGITAL_CURRENCY_DAILY
- 指数:
INDEX_DATA(INDEX_CATALOG で対応シンボル一覧)
- イベント:
IPO_CALENDAR / EARNINGS_CALENDAR / NEWS_SENTIMENT / TOP_GAINERS_LOSERS
呼び出し例
TIME_SERIES_DAILY(symbol="IBM", outputsize="compact", datatype="csv", return_full_data=true)
outputsize="compact" は直近 100 点。返り値が少ない場合、その銘柄の取引履歴自体が短い(新規上場など)可能性を疑う。return_full_data=true を推奨(プレビュー切り詰めを回避)。datatype="csv" はそのまま表/グラフ化しやすい。
無料枠の制約(重要)
outputsize="full"(20 年超の全履歴)は premium 限定。無料枠では compact(最大 100 点)まで。- レート制限あり(1 分/1 日あたりの呼び出し回数)。429 や
Information メッセージが返ったら間隔を空ける、または twelvedata に切り替える。
twelvedata の使い方
OAuth 認証が必要。未認証時はまず以下を実行:
authenticate # 認証 URL / フローを開始
↓ (ユーザーがブラウザで承認)
complete_authentication # 認証を確定
認証完了後にデータ取得ツールが利用可能になる。具体的なツール名・引数は認証後に提供されるスキーマで確認する(未認証の段階では一覧は不明 = 要確認)。主用途は alphavantage の代替価格ソース。
edinetdb の使い方
日本企業のファンダメンタルズ向け。Bearer API キー認証(設定済み)。サードパーティ (Cabocia Inc.) 提供で金融庁・EDINET 非公式。情報提供目的であり投資助言ではない。
典型的な起点と流れ:
search_companies / search_corporate_master — 社名・証券コードで企業を特定(以降の API に渡す ID を得る)。- 用途別に取得:
- 財務:
get_financials / get_earnings / get_segments / get_detailed_expenses
- 企業概要:
get_company / get_corporate_profile / get_company_history
- 株主・ガバナンス:
get_major_shareholders / get_shareholder_categories / get_directors / get_director_compensation / get_cross_shareholdings
- 有報本文:
get_text_blocks / search_ir_sections / get_ir_documents
- スクリーニング:
screen_companies / get_ranking / get_industry_benchmark
- 継続監視:
add_to_watchlist / get_watchlist / get_earnings_calendar
ワークフロー例: 株価推移を ASCII グラフ化
alphavantage の TIME_SERIES_DAILY(compact, csv, return_full_data=true)で終値・出来高を取得。- 終値の min/max からスケールを決め、ASCII 折れ線/バーで推移を描く。日中レンジ(高値–安値)を併記すると変動の大きさが伝わる。
- 急騰/急落・出来高の偏り・上場直後かどうかなど、要点を散文で添える。
- データソース・期間・制約(無料枠で取れた範囲)を明記し、投資助言ではない旨を添える。
注意事項
- 取得データは情報提供目的であり投資助言ではない。
- 銘柄シンボルが曖昧なときは
SYMBOL_SEARCH(alphavantage)/ search_companies(edinetdb)で先に確定する。
- 返り値が想定より極端に短い/欠けている場合、新規上場・上場廃止・無料枠制約のいずれかを切り分ける。
- レート制限・premium 制約に当たったら、別 MCP へのフォールバックを検討する。
- 大きな返り値はファイルにオフロードされることがある。
return_full_data=true で本体を確保する。
