概要
Korea Investment & Securities（韓国投資証券）の KIS Developers Open API から韓国と海外の市場データを読み取ります。株式と ETF の株価、日足と分足のチャート、板情報、投資主体別の売買動向、KOSPI と KOSDAQ の指数、米国・日本・香港・中国の株価に対応します。読み取り専用で、取引は行いません。
ガイド付きセットアップ
Korea Investment & Securities を ChatGPT に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Korea Investment & Securities を接続して、MCP URL を ChatGPT に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
ChatGPT のプラグインディレクトリにある AnythingMCP プラグインは、AnythingMCP Cloud 上で社内データベース（PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB、読み取り専用）への質問に答えます。掲載ページを開き (新しいタブで開きます)、Install plugin をクリックしてください。それ以外のコネクタは、AnythingMCP の MCP URL を使ってカスタム MCP サーバーとして ChatGPT に追加します。
こう聞いてみよう
Korea Investment & Securities のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Korea Investment & Securities をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Korea Investment & Securities + ChatGPT
Korea Investment & Securities（韓国投資証券）の KIS Developers Open API から韓国と海外の市場データを読み取ります。株式と ETF の株価、日足と分足のチャート、板情報、投資主体別の売買動向、KOSPI と KOSDAQ の指数、米国・日本・香港・中国の株価に対応します。読み取り専用で、取引は行いません。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
KIS_APP_KEY, KIS_APP_SECRET
ステップ 1 — 認証情報を取得
セットアップは数分で終わります。Korea Investment & Securities（한국투자증권）の証券口座と、その口座用の KIS Developers の Open API サービスが必要です。Open API サービスで App Key と App Secret が発行されます。
市場データ専用: コネクターが読み取るのは株価、チャート、板情報、投資主体別の売買動向、指数、銘柄の基本情報です。注文の発注、訂正、取消はできず、口座残高、保有銘柄、預り金も読み取りません。WebSocket によるストリーミング、先物・オプション、債券取引にも対応していません。
- apiportal.koreainvestment.com（KIS Developers、API 신청）で Open API サービスを申し込み、実取引（실전투자） 用の口座を選びます。
- App Key を
KIS_APP_KEYに、その隣に表示される App Secret をKIS_APP_SECRETにコピーします。App Key は 20〜64 文字の英数字、App Secret は約 180 文字の長い文字列です。スペースや改行を入れずに、全体を貼り付けてください。 - コネクターをインストールします。
korea_investment_get_stock_priceをコード005930（Samsung Electronics）で実行して、接続を確認してください。
使えるのは実取引用のキーだけです: 模擬取引（모의투자）のキーは KIS の別ホスト openapivts.koreainvestment.com:29443 でしか使えず、このコネクターはそのホストを使いません。実取引用のキーで株価を読み取っても、取引は発生しません。
トークン: コネクターは App Key と App Secret をアクセストークンに交換し（POST /oauth2/tokenP）、KIS が求めるヘッダーと一緒にすべての呼び出しで送ります。KIS のトークンの有効期間は 24 時間で、トークンの発行要求はおよそ 1 分に 1 回までです。6 時間以内にもう一度要求すると同じトークンが返り、新しいトークンが発行されるたびに KIS から KakaoTalk の通知が届くことがあります。コネクターはトークンを保持し、期限切れの少し前にだけ新しいトークンを要求します。
Cloud とセルフホストは同じ手順です: どちらも自分の App Key と App Secret を使います。セルフホストのサーバーでは、openapi.koreainvestment.com のポート 9443 への外向き接続が許可されている必要があります。
レート制限とページ送り: 実取引用のキーでは、口座ごとに 1 秒あたり約 20 回まで呼び出せます。EGW00201 は呼び出しが多すぎることを示すので、間隔を空けてください。チャートと履歴のツールは 1 回の呼び出しで約 100 行、分足チャートは最大 30 本を返します。それより古いデータは、終了日または終了時刻を前にずらして再度呼び出します。
コード: 韓国の株式、ETF、ETN は 6 桁の短縮コードを使います（005930 Samsung Electronics、000660 SK hynix、035420 NAVER、069500 KODEX 200）。ETN は先頭に Q を付けます。株価は既定では KRX のもので、指定すれば Nextrade（NXT）または両方を合わせたものも取得できます。韓国の指数は 4 桁です: 0001 KOSPI、1001 KOSDAQ、2001 KOSPI 200。海外株は取引所コードとティッカーを組み合わせます（例: NAS + AAPL、NYS + KO、TSE + 7203、HKS + 00700）。海外指数、為替レート、債券、金のコード（SPX や .DJI など）は、KIS の海外指数マスターファイルに載っています。
日付、時刻、価格: 日付は YYYYMMDD、時刻は HHMMSS で、どちらも韓国時間（KST、UTC+9）です。韓国の価格は KRW、海外の価格は現地通貨です。KIS は韓国語の略語によるフィールド名で応答します。たとえば stck_prpr（現在値）、prdy_vrss（前日終値からの変化）、prdy_ctrt（騰落率、%）、acml_vol（出来高）です。
米国株の株価は遅延することがあります: 米国株のリアルタイム株価には、KIS アプリでの別途の購読が必要です。購読がない場合、米国株の株価は遅延します。
よくあるエラー: すべての応答には rt_cd（0 は成功）と、何が問題かを示す msg_cd と msg1 が含まれます。App Key または App Secret が拒否された場合（401）は、たいていキーのコピーが不完全か、模擬取引の口座のキーです。403 は、その口座で Open API サービスが有効になっていない、App Key が再発行された、または前回から 1 分以内にトークンを要求したことを示します。1 分待ってから再試行してください。openapi.koreainvestment.com:9443 に到達できない場合は、ポート 9443 への外向き接続がブロックされています。
読み取れるデータ: 韓国の株式、ETF、ETN の現在値と、騰落、出来高、売買代金、値幅制限、52 週の高値と安値、PER、PBR、EPS、BPS、時価総額、外国人保有比率、日足・週足・月足・年足と当日の 1 分足、歩み値、10 本気配の板情報と予想約定価格、個人・外国人・機関の純買い、韓国の上場商品の基本情報、KOSPI、KOSDAQ、KOSPI 200 と業種別指数の現在値と推移、米国・日本・香港・中国・ベトナムの株式の株価、詳細な株価、推移、板情報、基本情報、そして海外指数、為替レート、国債、金先物のローソク足です。
読み取り専用: 16 個のツールはすべて市場データを読み取るだけなので、インストール時にオフになっているツールはありません。市場データは情報提供のみを目的としており、投資助言ではありません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、Add をクリックして Add custom MCP server を選びます。
- 名前を入力します（例: Name:
Korea Investment & Securities）。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| Tool | What it does |
|---|---|
korea_investment_get_stock_price | Current quote of one Korean stock, ETF or ETN: last price (stck_prpr), change and change rate against the previous close (prdy_vrss… |
korea_investment_get_daily_prices | Last 30 trading days (or 30 weeks or 30 months) of one Korean stock: per row the date (stck_bsop_date), open, high, low, close, change… |
korea_investment_get_price_chart | Daily, weekly, monthly or yearly candles (OHLCV) of one Korean stock between two dates, at most 100 candles per call: output1 is the… |
korea_investment_get_minute_chart | One-minute candles of one Korean stock for today, up to 30 per call, ending at a given time: output1 is the quote summary, output2 the… |
korea_investment_get_orderbook | Order book of one Korean stock: the ten best ask and bid prices with their remaining quantities (askp1..10, bidp1..10, askp_rsqn1..10… |
korea_investment_get_trades_by_time | Time-and-sales of one Korean stock today: executions at or before a given time with price, change, volume per print and execution strength… |
korea_investment_get_investor_flows | Net buying by investor type for one Korean stock over the recent trading days: individuals (prsn_ntby_qty), foreigners (frgn_ntby_qty) and… |
korea_investment_get_stock_info | Basic master data of a Korean listed product: Korean and English names (prdt_name, prdt_eng_name), listing market, sector classification… |
korea_investment_get_index_price | Current level of a Korean market or sector index: index value (bstp_nmix_prpr), change and change rate, open, high, low, volume and traded… |
korea_investment_get_index_daily_prices | History of a Korean market or sector index up to a given date, one row per day, week or month (about 100 rows per call): date, close… |
korea_investment_get_overseas_price | Current quote of a foreign stock (US, Japan, Hong Kong, China, Vietnam): last price (last), previous close (base), change and change rate… |
korea_investment_get_overseas_price_detail | Detailed quote of a foreign stock: open, high, low, previous close, 52-week high and low with their dates, PER, PBR, EPS, BPS, market… |
korea_investment_get_overseas_daily_prices | Daily, weekly or monthly history of a foreign stock up to a given date, about 100 rows per call: date (xymd), close (clos), change, open… |
korea_investment_get_overseas_orderbook | Order book of a foreign stock: best ask and bid prices with quantities (ten levels for US stocks, one level elsewhere) and the current… |
korea_investment_get_overseas_index_chart | Daily, weekly, monthly or yearly candles of a foreign index, exchange rate, government bond or gold future between two dates (about 100… |
korea_investment_get_overseas_stock_info | Master data of a foreign stock as KIS lists it: Korean and English names, exchange, currency, listing status, tick size, minimum order… |
プロンプトの例
- 「Samsung Electronics（005930）の今の株価と、PER、PBR、外国人保有比率を教えてください。」
- 「SK hynix の直近 3 か月の日足と、その期間の最高終値を見せてください。」
- 「ここ数営業日、NAVER を外国人や機関は買い越していますか。」
- 「今日の KOSPI と KOSDAQ の水準と、KOSPI の値上がり銘柄数と値下がり銘柄数を教えてください。」
- 「Apple とトヨタを比較してください。直近の株価、今日の騰落、52 週の高値と安値をお願いします。」
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?