Koreanpulse

koreanpulse

韓国株の開示情報、アクティビストの届出、海外保有者の資金フローを英語で提供 — MCP 経由で AI エージェントに届けます。

AI アシスタント向けの韓国株式市場インテリジェンス。 koreanpulse は、ChatGPT / Claude / Cursor / FastMCP エージェントを韓国（KRX / KOSPI / KOSDAQ）の株式データに接続する MCP サーバーです。DART の企業開示を提出と同時に追跡し、海外投資家の保有比率の変化やアクティビスト投資家のキャンペーンを監視し、分類済みの韓国業界ニュースをすべて英語で検索できます。提供するのはデータとインテリジェンスのみで、売買の推奨は行いません。

目標：関心のある銘柄に5％ルールの届出やDARTのイベントがあった際に、英語で通知を受け取れるようにすることです。（ベータ版 — ウォッチリストのポーリングとアラート配信は計画中で、まだ利用できません。現在利用できるのはオンデマンドのクエリです。）

概要：koreanpulse は、海外保有者の5％ルールに関する開示、韓国のアクティビストによる届出、主要なDARTイベントなど、韓国の一次情報源からの開示データを翻訳、タグ付け、絞り込みして AI アシスタントに提供します。KRX 自身、ASIFMA、複数のグローバル資産運用会社は、韓国の開示情報が英語で提供される量は構造的に少ないと公に指摘しています。無料の公開日次スナップショットは /today で利用できます。有料の Cloud プラン（Solo $29/mo、Analyst $79/mo、Desk $249/mo）では、許可リストのタグ付けを行う2つのツールを利用できます。これらはホスト型サービス上でのみ動作し、2026-09-21以降、サービスが一時停止しているため利用できません。ウォッチリストのポーリングとアラート配信は計画中で、まだ利用できません。提供開始後も、早期登録者には登録時の料金が適用されます。ハッカー向けに OSS 版をセルフホストできます — 自分で実行する（OSS）を参照してください。

AI/MCP エージェントの開発者向け。 koreanpulse は、韓国株式市場の一次情報源を既存の Claude Desktop / Cursor / FastMCP エージェントに接続します。米国データ用にエージェントがすでに使用しているものと同じ MCP 形式です。接続方法は2つあります。(a) pip install koreanpulse と4行の設定（Claude Desktop / Cursor の stdio 用）、(b) Smithery マーケットプレイスへの掲載（Smithery CLI ユーザー用）。公式のホスト型リモート MCP エンドポイント（https://mcp.koreanpulse.dev/mcp）は2026-09-21以降、一時停止しています。セルフホスト型のインストールを利用してください。無料の5つのツールが動作します（ライセンスが必要な2つのツール、アクティビストおよび海外保有者のタグ付けはホスト型サービス上でのみ動作します）。7つのツールは、DART の届出、海外保有者の5％ルールに関する資金フロー、韓国のアクティビストによる届出、16セクターの業界ニュースを、型付き関数呼び出しとして提供します。トレーディングエージェントのスタックのほかの部分は変更不要です。

Claude.ai / ChatGPT（リモート MCP）— ホスト型エンドポイントは一時停止中です。 公式のホスト型エンドポイント https://mcp.koreanpulse.dev/mcp は2026-09-21以降、一時停止して応答しないため、現時点ではカスタムコネクターとして追加できません。代わりにセルフホスト型のインストールを利用してください。pip install koreanpulse を実行し、docs/SELF_HOSTING.md に記載された Claude Desktop / Cursor の設定を行います（DART API キーはご自身で用意してください。この方法では無料の5つのツールを利用できます。ライセンスが必要な2つのツールはホスト型サービス上でのみ動作します）。koreanpulse.dev の無料公開 /today スナップショットには影響ありません。読み取り専用 — 届出と開示情報のみを提供します。取引の実行は行わず、投資助言も行いません。 このサーバーが回答する内容（エージェント検索向けの機能ベクトル）。 KOSPI／KOSDAQ／KONEX／KRX のあらゆる銘柄に関する韓国 DART（전자공시）の開示情報、継続的に管理されている許可リストと照合した、5％ルールに基づく株式保有の開示情報 — 韓国のアクティビスト（KCGI／Align Partners／Truston Asset／Anda Asset／Cha Partners／VIP Asset／Life Asset／Platform Partners／Must Asset Management／Dalton Investments／Flashlight Capital Partners／Oasis Management／Palliser Capital／Whitebox Advisors／City of London Investment Management + 韓国で届出を行う場合のValueAct／Elliott）および海外の大口保有者（BlackRock／Vanguard／State Street／Fidelity／Capital Group／T. Rowe Price／Wellington／Matthews Asia／Templeton／Aberdeen／Schroders／Norges Bank／GIC／Temasek／Goldman Sachs／JPMorgan／Morgan Stanley／Citadel／Millennium／Bridgewater）—、そして電子新聞 + 韓国経済 + The Korea Herald（英語を母語とする読者向け）+ 지디넷코리아 を情報源とする、16 セクター（半導体／造船／バッテリー／バイオテクノロジー／防衛／自動車／EV 充電／AI／鉄鋼／石油化学／建設／フィンテック／ゲーム／電子商取引／通信／エネルギー）にわたる韓国の業界ニュース。いずれも、オンデマンドの英訳をサーバー側にキャッシュします。ツールカタログとクエリ例も koreanpulse_about から返され、エージェント側で機能を確認できます。

---

ステータス

プレアルファ（v0.1.13）。 MCP ツールを 7 個リリース済み — 無料 5 個 + ライセンスが必要な 2 個（アクティビストと海外大口保有者の許可リスト照合、Solo は月額 $29 以上）。この 2 個はホステッドサービス上でのみ動作し、同サービスは 2026-09-21 以降停止しています。418 件のテストに合格しています。ベータ版では、ウォッチリストのポーリング + アラート配信を予定していますが、まだ利用できません。ベータ版の提供計画は docs/BETA.md をご覧ください。

---

これを作った理由

私はソウルを拠点とする開発者です。英語圏の友人たちが、KOSPI の取引を大きく左右するような韓国の開示情報を何度も見逃すのを目にしてきました。バリューアップ対象銘柄への KCGI の届出、HBM 関連銘柄での BlackRock による 5％超の保有、アクティビストによるひそかな買い集めなどです。韓国の一次情報源（DART 전자공시）は明確ですが、英語での報道は数時間遅れることも、まったくないこともよくあります。彼らがすでに使っているチャットアシスタントに接続して、「Samsung Electronics で何か新しい情報はある？」と尋ね、私が DART を直接読んだときと同じ答えを得られるものが欲しかったのです。それが koreanpulse です。

これを MCP として提供しているのは、使ってほしい人たちがすでに利用しているスタックがその形だからです — Claude Desktop、Cursor、OpenAI Responses API、ChatGPT のカスタムコネクターです。新しいクライアントをインストールする必要はありません。無料プランでは日次スナップショットと 5 個の無料ツールを利用できます。ライセンスが必要な 2 個のツール（アクティビストと海外大口保有者に関する 5％ルールの許可リスト照合）は、韓国語話者が手作業で行うと何時間もかかる部分です。

---

これが必要な理由

「海外投資家の大半は、アクセスのしにくさと外国語で入手できる情報の少なさから、韓国のヘッジファンド市場への参入が驚くほど難しいと感じています。」 — HedgeVista, 2025

「公開情報は、すべての投資家が韓国語と英語の両方で利用できるようにするべきです。」 — ASIFMA Korean Capital Markets Report, 2022

「韓国取引所は、特に英語での対応能力が不足している企業に対し、IR サービスを提供します。」 — Wellington Management on Korea Value-Up program, 2025

英語での IR 情報の不足は、複数の情報源によって確認されています。以下の動きが、その背景にあります。

• 証券会社経由のアクセスが拡大し続けています — Hana Securities × Futu が、Futu の香港の個人顧客向けに韓国株取引を開始しました（2026年4月）。また、Samsung Securities × Interactive Brokers がパイロットを開始しました（2026年5月）
• KOSPI は MSCI 先進国市場への再分類に向けた見直しの対象となっており、これが世界の投資家が韓国市場へのアクセスの変化を追う理由の一つです
• 外国人投資家が KRX に直接アクセスする際に必要だった、数十年来の登録手続きである IRC（Investor Registration Certificate）の要件が、2023-12-14 に廃止されました
• Millennium は2025年に、韓国への初の投資（Billionfold に2億5,000万ドル）を行いました
• 韓国のアクティビスト市場が成熟しつつあり（KCGI、Align Partners）、世界のアクティビストも韓国で株主提案を行っています（ValueAct、Elliott）
• 韓国の造船、HBM、防衛、バイオテクノロジーはいずれも世界的に重要ですが、情報源は韓国語のみです
• 韓国の個人投資家は暗号資産から KOSPI へ大きく資金を移しました（2025年に Upbit/Bithumb から1,100億ドルが流出）
• Bloomberg/FactSet はエンタープライズ向けのみで、個人・中小企業向けの選択肢はありません

利用者と料金

対象者	プラン	理由
暗号資産から KOSPI/KOSDAQ に乗り換える投資家	Cloud Solo $29/mo	ウォッチリストに該当する銘柄があれば、Discord チャンネルに通知します。それがこのプランのすべてです (アラートは提供予定で、現在は利用できません)
韓国系ディアスポラ／海外在住の韓国人投資家	Cloud Solo $29/mo	読み慣れたニュースを英語でまとめてお届けします (アラート配信は提供予定)
K コンテンツ／新興市場担当のジャーナリスト	Cloud Solo $29/mo	何時間もかかる手作業での翻訳を不要にします
韓国市場を担当するブティックファンドのアナリスト	Cloud Analyst $79/mo	現在はクエリ上限が高く、ウォッチリスト／アーカイブ／複数チャンネルへのアラートは提供予定です
有料リサーチ予算のある個人トレーダー	Cloud Analyst $79/mo	現在はクエリ上限が高く、検索の保存機能は提供予定です
ブティック型ロング／ショート運用チーム、小規模リサーチチーム	Cloud Desk $249/mo	現在はクエリ上限が最も高く、シート／共有ウォッチリスト／Slack アラートは提供予定です

/today の無料デイリースナップショット（ログインも API キーも不要）が、新規利用の入口です。有料ツールで検索できるものと同じ分類済みデータを、平日に1日1回公開しています。

最初の20名分はデザインパートナープログラムをご利用いただけます — お問い合わせください。

料金

🚧 ベータ版。 Solo $29 / Analyst $79 / Desk $249。ホステッドサービスが一時停止中（2026-09-21以降）のため、チェックアウトは停止しています。サービス再開に備えて、プラン名と料金を以下に掲載しています。ホステッドサービスが再開すると、有料ユーザーはすぐに、ライセンスが必要な2つの許可リストのタグ付けツール、ホステッド翻訳、従量制のクエリ上限（2K / 15K / 100K）を利用できます。ウォッチリストのポーリング、アラートの送信、シート数の制限、ティア別の保持期間は提供を予定していますが、まだ利用できません。提供開始までは、シート数、ウォッチリスト数、アラートチャンネルの上限、アーカイブの保持期間は名目上の制限であり、ほとんどのティア別の違いはロードマップ上のものです。早期登録者は、これらの機能が提供された後も登録時の料金が適用されます。ホステッドサービスは2026-09-21以降、一時停止中のため、ライセンス保有者を含むすべてのユーザーが、ライセンスが必要な2つのツールを現在利用できません。

ティア	$/月	ウォッチリスト	クエリ/月	アーカイブ	アラートチャンネル
Cloud Solo	29	5 (提供予定)	~2,000 (従量制)	30日 (提供予定)	DiscordまたはTelegramを1つ (提供予定)
Cloud Analyst	79	25 (提供予定)	~15,000 (従量制)	1年 (提供予定)	複数（Discord / Telegram / Email）(提供予定)
Cloud Desk	249	共有、3シート (提供予定)	~100,000 (従量制)	チームアーカイブ (提供予定)	Slack / webhooks (提供予定)

初回のお支払いには30日間の返金期間があります。

サブスクリプション：一時停止中 — ホステッドエンドポイントの一時停止中（2026-09-21以降）は、チェックアウトを停止しています。プランはkoreanpulse.dev/#pricingに掲載しています。ティア別のPolarチェックアウト（Solo / Analyst / Desk）は、サービス再開後に再開されます。いずれもPolarがMerchant of Recordとして対応し、売上税 / VAT / 返金を処理します。ライセンスキーは、subscription.createdでWebhookワーカーからメールで送信されます。

Enterprise / SLA：お問い合わせください。公開価格はありません。

自分で実行する（OSS）

ソースコードはAGPL-3.0です。セルフホストする場合は、自分のDARTキーとOpenAIキーを使って、MCPサーバーをローカルで実行できます。この方法は、ハッカーやプライバシーを最大限重視するユーザー向けです。

	OSSセルフホスト	Cloud（Solo / Analyst / Desk）
費用	$0	月額 $29 / $79 / $249
プロバイダーキー	自分のDART_API_KEY + 自分のOPENAI_API_KEY	自分のDART_API_KEY（ローカルに保持）；OpenAIキーはこちらで管理します
ローカルインストールが必要	はい（pip install koreanpulse）	はい（同じpip install。翻訳リクエストのみ当社のWorkerに送信されます）
ウォッチリストのポーリング + アラート	含まれません	提供を予定しています — まだ利用できません
ホステッドアーカイブ	なし	提供を予定しています — まだ利用できません（30日 / 1年 / チームアーカイブ）
ホステッド翻訳キャッシュ	なし	現在利用可能（テナント間のキャッシュヒットが累積します）
アカウント同期	なし	提供を予定しています — まだ利用できません
サポート	コミュニティのみ（issues/PRs）	Analyst / Deskでは優先サポート
おすすめのユーザー	ハッカー、プライバシーを厳格に重視する環境、OSSコントリビューター	ウォッチリストからアラートへのワークフローが提供されたら使いたい方

OSSセルフホストは上記の料金表には含まれません — 別の選択肢です。インストールとキーの設定については、docs/SELF_HOSTING.mdをご覧ください。注：上記のOSSとCloudの比較表は、pipによるインストールの方法を対象としています。インストール不要の方法として、ホステッドリモートMCP（https://mcp.koreanpulse.dev/mcp）がありましたが、2026-09-21以降、一時停止中です。現在はセルフホストのpip install koreanpulseをご利用ください。ホステッドサービスの一時停止中は、上記のCloud列は保留となります。Cloudライセンスは現在利用できず、自分でインストールしても、ライセンスが必要な2つのツールは含まれません。

ツール

MCP ツールを7つ提供しています — 無料5つ＋ライセンス必須2つ。Claude Desktop／Cursor／あらゆるMCPクライアントから呼び出せます。無料ツール5つはセルフインストールで実行でき、ライセンス必須ツール2つはホスト型サービスでのみ実行できます。このサービスは2026-09-21以降、一時停止しています。有料プランでは、韓国語話者が手作業で行う必要のある許可リストのタグ付け作業を利用できます。無料プランでは、DART＋RSSの生データを提供します。

無料プラン（license_key不要、登録不要）：

ツール	概要
track_korean_filings	DARTの最新開示情報＋英訳／要約
lookup_corp_code	韓国企業名 → DART法人コード
resolve_stock_code	KRXの6桁コード → DART法人エントリー
search_korean_industry_news	etnews／한국경제／Korea Herald／zdnetのRSSを16業種に分類
koreanpulse_about	サーバー情報、無料／有料ツール一覧

有料プラン（Solo $29/月以上、license_keyが必要 — ツールの引数、または呼び出し元クライアントのセキュア入力フィールドから渡してください）：

ツール	概要
monitor_activist_investors	アクティビストの5％ルールに関する開示を自動タグ付け（KCGI／Align／Truston／Anda／Cha／VIP／ValueAct／Elliott）
monitor_foreign_holders	外国人の5％ルールに関する開示（BlackRock／Vanguard／Norges／GIC／Temasek＋ほか15社）

ライセンスなしで有料ツールを呼び出すと、サーバーはライセンスキーが必要であることを説明する短い通知を返します。ツールの応答には購入リンクは含まれません。

さらに4つを予定しています（docs/SPEC.md）：digest_analyst_reports、get_ma_pipeline、track_government_policy、summarize_korean_earnings_call。

既存サービスとの差別化

	Bloomberg	FactSet	KED Global	koreanpulse
韓国の一次情報の網羅性	中程度	中程度	英語の速報のみ	充実
リアルタイムAIエージェント連携（MCP）	なし	なし	なし	ネイティブ対応
個人／中小企業向け価格	エンタープライズ価格	エンタープライズ価格	無料（シグナルは限定的）	$29／$79／$249のクラウドプラン
韓国のアクティビスト／M&Aの動向	弱い	弱い	事後対応	先回りした監視 (予定)

他の韓国系 MCP サーバーとの違い

韓国データを扱う MCP サーバーはいくつかあります。用途に合ったものをお選びください。 当プロジェクトは、許可リストに基づく提出者タグ付けを備えた、英語優先の株式データをセルフホストで提供しています（ホスト型エンドポイントは2026-09-21以降、一時停止中です）。 生の KRX OHLCV データや韓国語の財務諸表テーブルが必要な場合は、他のサーバーのほうが適しています。

機能	koreanpulse	korea-stock-mcp（jjlabsio、137★）	korean-dart-mcp（chrisryugj、35★）	openregistry（sophymarine）
トランスポート	Streamable HTTP + SSE	stdio のみ（npx）	stdio のみ（npx）	Streamable HTTP
ホスト型エンドポイント	mcp.koreanpulse.dev/mcp — 2026-09-21以降、一時停止中	—（セルフインストール）	—（セルフインストール）	openregistry.sophymarine.com/mcp
ワンクリック接続（ChatGPT / Claude.ai）	一時停止中（ホスト型エンドポイントは2026-09-21以降停止中）	不可（stdio）	不可（stdio）	対応
利用開始に必要な DART API キー	ホスト型エンドポイントの一時停止中は必要（登録＋設定）	必要（登録＋設定）	必要（登録＋設定）	該当なし
アクティビスト提出者のタグ付け（KCGI / Align / Truston / Anda / Cha / VIP / Life / Platform / Must / Dalton / FCP / Oasis / Palliser / Whitebox / City of London / ValueAct / Elliott）	17個のラベル（ホスト型のみ。一時停止中）	— 生の提出書類のみ	— 生の提出書類のみ	— 登録情報のみ
外国人保有者向け5％ルールの許可リスト（BlackRock / Vanguard / Norges / GIC / Temasek + さらに15社）	20個のラベル（ホスト型のみ。一時停止中）	— 生の提出書類のみ	— 生の提出書類のみ	— 登録情報のみ
英語優先の docstring（LLM に適した形式）	すべてのツール	韓国語が主、英語が副	韓国語が主	対応
韓国の業界ニュース（etnews / 한국경제 / Korea Herald / zdnet の RSS、英訳済み）	16業界	—	—	—
KRX OHLCV（日次価格）	— 対象外	対応（KOSPI / KOSDAQ / KONEX）	—	—
XBRL 財務諸表	— 対象外	対応	対応	—
HWP / PDF 添付ファイルから Markdown への変換	— 対象外	—	対応	—
マルチユーザーアーキテクチャ（1つのエンドポイントでN個のAIエージェントが並列稼働）	N→1 のホスト型設計。現在は一時停止中（キャッシュヒット率70％で、クォータ上限からMAU約9,500人と推定 — 算出方法は容量を参照）	1:1（ユーザーのマシンでユーザーごとに1プロセス）	1:1（ユーザーのマシンでユーザーごとに1プロセス）	ホスト型
エンドユーザーに必要な DART API キー	ホスト型エンドポイントの一時停止中は必要（ホスト型設計では共有キーを使用）	必要（ユーザーごとに登録）	必要（ユーザーごとに登録）	不要
料金	無料：5ツール · Solo $29 · Analyst $79 · Desk $249/月	無料のOSS（APIキーはユーザーが用意）	無料のOSS（APIキーはユーザーが用意）	無料の匿名利用枠

この分野には、対象範囲が異なるか、導入規模が小さい他のサーバーもあります。 SongT-50/korean-stock-mcp、 koreal6803/finlab-ai （クオンツ重視）、 eddmpython/dartlab（Pythonライブラリ）。 比較の最終確認日は2026-05-07です。それ以降に他のプロジェクトで変更がリリースされている可能性があります。

容量（DART のクォータ計算）

DART では、各 API キーの上限が1 日あたり 40,000 回です（2026-05 に確認済み）。DART_DAILY_QUOTA 環境変数で上書きできるソフト上限を**1 日あたり 32,000 回（80%）**に設定しています。

提出書類の一覧レスポンスは、鮮度に応じた TTL を適用する list_filings_cached() を経由します（今日の期間は 60 秒、6 日以内は 1 時間、7 日以上前は 24 時間）。キャッシュヒットでは DART のクォータを消費しません。

キャッシュヒット率	顧客数の上限／日	MAU 上限（12 か月の構成比）
0%（提出書類のキャッシュなし）	32,000	~800
70%（現実的な 3 か月後）	107,000	~9,500
85%（成熟時）	213,000	~19,000
95%（再利用率が高い場合）	~25,000 MAU（DART の上限による制約）	—

絶対上限：DART キー 1 つあたり ~30,000 MAU。これを超える場合は、2 つ目のキー（別の 사업자등록번호）が必要です。

12 か月の構成比に基づく予測（756 MAU）では、DART の呼び出しは1 日あたり約 930 回で、キャッシュヒット率 70% の場合、ソフトクォータの**2.9%**です。クォータ対策が必要になるまで、約 34 倍の拡張余地があります。

src/koreanpulse/cache.py、src/koreanpulse/dart.py:list_filings_cached を参照してください。

ロードマップ

現在利用可能：クエリ（セルフインストールによる DART 提出書類と業界ニュース。外国人保有者およびアクティビストの追跡はホステッドサービスでのみ実行され、2026-09-21 以降停止中）、ホステッド翻訳キャッシュ（Cloud KOREANPULSE_CACHE_MODE=hosted）、/today の日次スナップショット、Polar → D1 によるライセンス発行（Polar は唯一の決済プロバイダーであり、Merchant of Record です）。ファーストパーティのホステッド MCP エンドポイント（https://mcp.koreanpulse.dev/mcp）は 2026-09-21 以降停止中です。セルフホスト可能な pip install koreanpulse の方法を使用してください。

計画中 — まだ利用できません：

• ウォッチリストのポーリングループ（Cloudflare cron + koreanpulse.alerts）
• アラート配信の実行（Discord / Telegram / Slack / webhook）
• プランごとの上限適用：ウォッチリスト数、アラートチャンネル数、アーカイブ保持期間、シート数

これまでのマイルストーン：

• W1–2 ✅ プロジェクトの骨組み、FastMCP サーバー、DART クライアント、agentprod との統合
• W3–4 ✅ MVP：track_korean_filings、lookup_corp_code、search_korean_industry_news、キャッシュ付き翻訳レイヤー
• W5–6 ✅ Webhook ハンドラーの骨組み（ライセンス自動発行） — Polar 決済
• W5–6 ✅ Cloudflare D1 対応の LicenseStore（インメモリ版を置き換え）
• W7–8 ⏳ ウォッチリストのポーリング + アラート配信（計画中、まだ利用不可） — Solo / Analyst / Desk を支えるウォッチリストからアラートへのワークフローに、cache-worker cron + daily-worker cron + koreanpulse.alerts モジュールを接続します。D1 スキーマとアラート配信の基本機能はすでにリリース済みですが、cron ループが未実装です。
• W7–8 digest_analyst_reports、summarize_korean_earnings_call
• W9–10 Cloud Desk 向けマルチシート / 共有ウォッチリスト
• W11–12 初の有料顧客

アーキテクチャ

• MCP サーバー — FastMCP（Python）。ユーザーのマシン上で stdio 経由で実行されます。当社側のホスティング費用はかかりません。Cloud の顧客も引き続きローカルにインストールします。KOREANPULSE_CACHE_MODE=hosted に切り替えると、翻訳呼び出しのみ Worker にルーティングされます。
• Cache Worker（cache-worker/）— Cloudflare Workers + KV。OpenAI キーを保持し、グローバルな翻訳キャッシュを提供し、各呼び出しにライセンスチェックを適用します。無料枠（Workers は 1 日あたり 100K リクエスト、KV は 1 日あたり 100K 読み取り）で、MRR が $5K を大幅に超えるまで有料トラフィックをカバーできます。
• Daily Worker（daily-worker/）— Cloudflare Workers + KV。cron による /today ダッシュボードの生成（平日 KST 16:30）。
• Webhook Worker（webhook-worker/）— Cloudflare Worker + D1（SQLite）。Polar の決済イベント（Polar は唯一の決済プロバイダーで、2026-05-06 以降有効）と、Cache Worker 向けの /v1/validate を処理します。旧 Lightsail/FastAPI/Postgres スタックを置き換え、運用者がサーバーを一切稼働させずに済むようにします。
• agentprod を再利用 — Throttle、Retry、CostTracker。

OSS のセルフホストと Cloud

MCP を実行する方法は 2 つあり、KOREANPULSE_CACHE_MODE で切り替えます。どちらもローカルへのインストールが必要です（pip install koreanpulse と Claude Desktop の 4 行の設定）。違いは、翻訳リクエストを当社の Worker 経由で送信するか、お使いのマシンから OpenAI に直接送信するかです。

（クイックスタートの比較は上記の「自分で実行する」にもあります。編集時は両方の内容を一致させてください。）

	local（OSS のセルフホスト）	hosted（Cloud Solo / Analyst / Desk）
MCP のローカルインストール	必須	必須（同じ pip install）
プロバイダーキー	お客様の OPENAI_API_KEY	当社のキー（Worker 上。お客様側に OpenAI キーは不要）
翻訳キャッシュ	ローカルの JSONL ファイル	グローバルな Cloudflare KV（テナント間で再利用）
1 回あたりのコスト	OpenAI への支払いはお客様負担	Cloud プランに含まれます
プライバシー	翻訳データはお使いのマシンと OpenAI の外に出ません	翻訳リクエストは当社の Worker に送信されます。DART の通信は引き続きローカルです
おすすめの用途	ハッカー、OSS コントリビューター、プライバシーを最大限重視する環境	ウォッチリストからアラートまでのワークフローのリリース後に利用したい方

キャッシュヒットがあるからこそ、月額 29 ドルの Solo プランで健全な粗利益を維持できます。同じ韓国語の開示タイトルは一度だけ翻訳され、その後、同じプランの他のすべてのテナントに KV から提供されます。モードごとの環境変数の違いについては、docs/CLAUDE_DESKTOP.md を参照してください。

ホスト型 HTTP トランスポート — 2026-09-21 以降、一時停止中です。 ファーストパーティのエンドポイント https://mcp.koreanpulse.dev/mcp（Streamable HTTP）は、2026-05-06 に ChatGPT と Claude.ai でエンドツーエンドの検証を最後に行いました。現在は無効になっており、応答しません。HTTP トランスポートのコード（koreanpulse.mcp_http）は、セルフホストするユーザー向けにリポジトリに残されています。セルフホストするユーザーとプライバシーを最大限重視するユーザーには、ローカルの stdio インストール方法が引き続き標準です。Smithery の掲載ページ により、Smithery CLI ユーザーも引き続きサービスを見つけられます。

法的な位置付け

• 韓国のニュース：出典を明記した短い要約と外部リンクのみで、全文の再掲載は行いません。要約は公開 RSS フィードのメタデータから生成されます。
• DART データ：出典を明記したうえで DART オープン API 経由で取得します。すべての項目に元の開示資料へのリンクがあります。元の開示資料には、それぞれ適用される規則が引き続き適用されます。
• 韓国の証券会社のレポート：取り込みません（有料レポートは対象外です）。
• 空間データや地図データは使用しません。
• 投資助言ではありません。 koreanpulse は開示データ、翻訳、フィルタリング、タグ付けを提供します。取引を実行せず、個別の買い推奨・売り推奨も提供しません。個別の分析は行いません。すべての出力は、情報提供のみを目的とする一般的なデータです。
• データを下流で再配布する場合は特に、ユーザーご自身の管轄区域や利用目的に適用されるライセンス、データ利用、金融サービスに関する義務を確認してください。このリポジトリの内容は、法的助言ではありません。
• プライバシーとデータ保護については、https://koreanpulse.dev/privacy を参照してください。韓国の PIPA、EU GDPR、米国の CCPA について説明しています。利用規約：https://koreanpulse.dev/terms。

請求（Polar — 現在のプロバイダー）

請求処理は、webhook-worker/ の Cloudflare Worker ＋ D1（SQLite）で実行されます。運用者がサーバーを用意する必要はありません。

現在のプロバイダー：Polar（polar.sh）— 2026-05-06 以降の Merchant of Record です。すべてのサブスクリプションの VAT／売上税／返金／チャージバックに対応します。subscription.created 時に、Webhook Worker がライセンスキーを自動でメール送信します。

Lemon Squeezy：削除済み。 2026-05-06 にストア申請が却下され、異議申し立ては行いませんでした。本番環境では LS バリアントのシークレットは設定されておらず、LS の Webhook 配信も受け付けません。Python の LS ハンドラー（koreanpulse.billing）と koreanpulse-webhook エントリーポイントは、2026-10-18 にリポジトリから削除されました。webhook-worker の /webhook/lemonsqueezy ルートは何も行わず、次回の Worker デプロイ時に削除されます。Polar が唯一の請求プロバイダーです。

デプロイとシークレットの設定手順の詳細は webhook-worker/README.md をご覧ください。概要は次のとおりです。

cd webhook-worker
npm install
npx wrangler d1 create koreanpulse_db   # paste returned id into wrangler.toml
npm run migrate:prod                     # applies 0001_licenses.sql + 0002_pricing_v2.sql

# ── Polar (active provider) ──────────────────────────────────────────
npx wrangler secret put POLAR_WEBHOOK_SECRET    # `polar_whs_...` from Polar webhook page
npx wrangler secret put POLAR_API_TOKEN         # `polar_oat_...` (subscriptions:read scope)
npx wrangler secret put POLAR_PRODUCT_SOLO      # UUID of Cloud Solo product
npx wrangler secret put POLAR_PRODUCT_ANALYST   # UUID of Cloud Analyst product
npx wrangler secret put POLAR_PRODUCT_DESK      # UUID of Cloud Desk product

# ── Shared ───────────────────────────────────────────────────────────
npx wrangler secret put KOREANPULSE_CACHE_SHARED_SECRET   # same value cache-worker uses

npm run deploy

エンドポイント（https://api.koreanpulse.dev または https://koreanpulse-webhook.<account>.workers.dev にデプロイ）：

• GET /health → {"status":"ok"}
• POST /webhook/polar → Standard Webhooks 署名（webhook-id／webhook-timestamp／webhook-signature）を検証し、webhook-id による冪等性を確保します
• POST /webhook/lemonsqueezy → 使用を終了（何も行わないルート。次回の Worker デプロイ時に削除。上記の請求に関する注記を参照）
• POST /v1/validate → cache-worker による HMAC 署名付きで、ライセンスを検証し、期間カウンターをアトミックにインクリメントします

処理対象の Polar イベント：subscription.created／.active／.updated／.canceled／.revoked。ライセンスキーを自動発行し、プランをその場でアップグレードし、キャンセル時には無効化します。ライセンスの各行には metadata.provider = "polar" のタグが付けられるため、行ごとに発行元を追跡できます。

以前の構成（Lightsail 上の Python koreanpulse-webhook FastAPI ＋ Postgres）は、2026-05-05 に置き換えられ、コードも 2026-10-18 に削除されました。運用者向けの記録は docs/legacy/POSTGRES_LIGHTSAIL.md にあります。新規デプロイでは Cloudflare Worker の構成を使用してください。

配布／マーケットプレイス

掲載文と申請チェックリストは docs/MARKETPLACE.md にあります。

• 公式ホスト型エンドポイント — https://mcp.koreanpulse.dev/mcp — 2026-09-21 以降、一時停止中です。pip install koreanpulse を使用してください
• Smithery — Smithery CLI ユーザー向けのマーケットプレイス掲載
• PulseMCP — 未申請（延期）
• Glama — 公開中（自動検出、スコアバッジあり）
• Awesome MCP — PR #5893
• MCP Market — Smithery の取り込み（自動）
• mcp.so — 公開中（手動申請）
• MCP Registry（registry.modelcontextprotocol.io）— 公開済み

ベータ版のユーザー獲得計画（30 日間で 50 ユーザー）と暗号資産ネイティブのチャネル構成は docs/BETA.md にあります。デモ録画用スクリプトは docs/DEMO.md にあります。CI／PyPI リリースパイプラインは docs/CI.md にあります。

アラートの基本機能（ライブラリ — ホスト型のウォッチリスト→アラートのループはまだ利用できません）

koreanpulse.alerts モジュールには、予定されているウォッチリストのワークフローで使用するアラート送信機能が含まれています。koreanpulse.alerts.send_alert(url, title=, body=) は、次のいずれかに送信します。

• Discord Webhook（https://discord.com/api/webhooks/...）
• Slack の受信 Webhook（https://hooks.slack.com/services/...）
• Telegram ボット（ショートカット tg://<bot_token>/<chat_id> または完全な sendMessage URL）

送信後は処理を待たず、失敗を通知しません。通信やフォーマットに失敗した場合は例外を発生させずに AlertResult(ok=False) を返すため、いずれかのチャネルが停止してもツール呼び出しが中断されることはありません。src/koreanpulse/alerts.py をご覧ください。

プロンプトの例

セルフインストールした koreanpulse サーバーに接続された Claude.ai、ChatGPT、または任意の MCP クライアントに、以下をコピーして貼り付けてください（ホスト型エンドポイントは 2026-09-21 以降、一時停止中です）。

Ask Claude: "What DART filings were submitted for Samsung Electronics in the last 7 days?"

Ask Claude: "Look up the DART corp code for Kakao and show me its latest disclosures."

Ask Claude: "Any Korean semiconductor news this week from 전자신문?"

Ask Claude: "Which activist investors filed 5%-rule disclosures on KOSPI stocks this month? [license_key: YOUR_KEY]"

Ask Claude: "Show me recent foreign-holder 5%-rule filings — has BlackRock or Norges Bank crossed any thresholds? [license_key: YOUR_KEY]"

最初の 3 つのプロンプトでは、無料ツール（サインアップ不要）を使用します。最後の 2 つでは、活動家および外国人保有者の許可リストタグ付けを使用します。この機能はホスト型サービス（2026-09-21 以降、一時停止中）でのみ実行され、Solo $29/mo のライセンスキーが必要です。セルフインストールでは使用できません。license_key が見つからない場合、サーバーはライセンスキーが必要であることを説明する短い通知を返します（応答に購入ページへのリンクは含まれません）。

ライセンス

ソースコード：AGPL-3.0-or-later。ホスト型サービス：商用。

Copyright (C) 2026 Lee Jong-guk (이종국)

このプログラムはフリーソフトウェアです。Free Software Foundation が公開する GNU Affero General Public License のバージョン 3、または（任意で）それ以降のバージョンの条件に従って、再配布および改変することができます。このプログラムは、商品性または特定目的への適合性を含め、いかなる保証もなく配布されます。全文については、LICENSE または https://www.gnu.org/licenses/ をご覧ください。