Koreanpulse

koreanpulse

通过 MCP 为 AI Agent 提供英文版韩国股票披露、激进投资者申报和外资持股变动数据。

面向 AI 助手的韩国股市情报。 koreanpulse 是一款 MCP 服务，可将 ChatGPT / Claude / Cursor / FastMCP Agent 接入韩国（KRX / KOSPI / KOSDAQ）股票数据 — 跟踪 DART 公司披露的提交情况、监测外资持股变动和激进投资者行动，并以英文搜索分类后的韩国行业新闻。仅提供数据和情报，不提供买入或卖出建议。

目标：当你关注的股票出现 5% 规则申报或 DART 事件时，以英文收到提醒。（测试版 — 观察列表轮询和提醒分发仍在计划中，尚不可用；目前可用的是按需查询。）

核心价值：koreanpulse 会为 AI 助手翻译、标记并筛选韩国一手来源披露数据 — 外资持股 5% 规则披露、韩国激进投资者申报和重大 DART 事件。KRX、ASIFMA 以及多家全球资产管理公司均公开表示，韩国披露信息流向英文内容的渠道存在结构性不足。/today 提供免费的公开每日快照；付费 Cloud 套餐（Solo 29 美元/月、Analyst 79 美元/月、Desk 249 美元/月）涵盖两款允许名单标记工具，这两款工具仅在托管服务上运行；自 2026-09-21 起服务暂停期间不可用 — 观察列表轮询和提醒分发仍在计划中，尚不可用；上线后，早期订阅用户可保留注册时的费率。黑客可自行托管 OSS — 请参阅自行运行。

面向 AI/MCP Agent 构建者。 koreanpulse 可将韩国股票一手来源接入现有的 Claude Desktop / Cursor / FastMCP Agent — 使用 Agent 已用于美国数据的相同 MCP 接口。提供两种连接方式：(a) pip install koreanpulse + 4 行配置，适用于 Claude Desktop / Cursor stdio；(b) Smithery CLI 用户可使用 Smithery 市场列表。第一方托管远程 MCP 端点（https://mcp.koreanpulse.dev/mcp）自 2026-09-21 起已暂停；请使用自行托管的安装方式，该方式可运行 5 款免费工具（另外 2 款受许可证限制的工具，即激进投资者和外资持股标记工具，仅在托管服务上运行）。这 7 款工具以类型化函数调用的形式提供 DART 申报、外资持股 5% 规则变动、韩国激进投资者申报以及 16 个行业的行业新闻；交易 Agent 堆栈的其余部分无需更改。

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 快照不受影响。只读 — 仅提供申报和披露信息。不执行交易，不提供投资建议。 此服务可回答的内容（供 Agent 检索的能力向量）。 涵盖任何 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）；覆盖 16 个行业的韩国行业新闻（半导体 / 造船 / 电池 / 生物技术 / 国防 / 汽车 / EV 充电 / AI / 钢铁 / 石化 / 建筑 / 金融科技 / 游戏 / 电子商务 / 电信 / 能源），来源包括电子新闻 + 韩国经济报 + The Korea Herald（原生英文）+ 지디넷코리아。所有内容均支持按需翻译为英文并缓存在服务端。koreanpulse_about 还会返回工具目录和示例查询，供 Agent 端发现能力。

---

状态

预 Alpha（v0.1.13）。 已发布 7 个 MCP 工具——5 个免费 + 2 个需许可证（激进投资者 + 外国持有者白名单标记，Solo $29/mo+；这两个工具仅在托管服务上运行，该服务自 2026-09-21 起暂停）。418 项测试通过。Beta 阶段计划推出观察列表轮询 + 警报分发，目前尚不可用。Beta 用户获取计划见 docs/BETA.md。

---

我为什么开发这个项目

我是一名常驻首尔的开发者。我一直看到说英语的朋友错过可能改变其 KOSPI 交易决策的韩国披露信息——KCGI 提交关于价值提升目标公司的申报、BlackRock 持有某 HBM 公司超过 5% 股份，或某位激进投资者悄然增持。韩国一手来源（DART 전자공시）的信息明确无误；英文报道往往晚数小时，甚至完全没有。我想做一个工具，让他们能接入自己已经在用的聊天助手，询问“Samsung Electronics 有什么新消息吗？”，并获得与我直接查阅 DART 时相同的答案。这就是 koreanpulse。

我将它做成 MCP，因为这正是我希望使用它的人已有的技术栈形式——Claude Desktop、Cursor、OpenAI Responses API、ChatGPT 自定义连接器。无需安装新的客户端。免费层提供每日快照和 5 个免费工具；两个需许可证的工具（对激进投资者和外国持有者进行 5% 规则白名单标记）则解决了手动处理需要韩语使用者花费数小时的问题。

---

为什么要做这个项目

“由于市场准入和外语信息的可获取性有限，大多数外国投资者发现，进入韩国对冲基金市场的难度出乎意料地高。” — HedgeVista，2025 年

“应向所有投资者提供韩文和英文版本的公开信息。” — ASIFMA《韩国资本市场报告》，2022 年

“韩国交易所将为能力有限的公司提供投资者关系服务，尤其是在英语方面。” — Wellington Management 关于韩国价值提升计划的评论，2025 年

英语投资者关系信息缺口已得到多方验证。以下因素进一步加剧了这一问题：

• 券商渠道持续拓宽 — Hana Securities × Futu 面向 Futu 的香港零售客户推出韩国股票交易服务（2026 年 4 月），Samsung Securities × Interactive Brokers 则启动了试点（2026 年 5 月）
• KOSPI 一直在接受重新归类为 MSCI 发达市场的评估——这是全球投资者关注韩国市场准入变化的原因之一
• IRC（投资者登记证）要求于 2023-12-14 废除，取消了外国投资者直接进入 KRX 的数十年旧登记程序
• Millennium 于 2025 年首次投资韩国市场（向 Billionfold 投资 $250M）
• 韩国维权投资领域日渐成熟（KCGI、Align Partners），全球维权投资者也开始在韩国提交文件（ValueAct、Elliott）
• 韩国造船、HBM、国防、生物科技都具有全球影响力——但信息来源仅限韩文
• 韩国散户大举从加密货币转向 KOSPI（2025 年有 $110B 资金离开 Upbit/Bithumb）
• 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 密钥）是引流入口——它使用付费工具查询的同一批分类数据，每个工作日发布一次。

前 20 个指定席位可参与设计合作伙伴计划——请联系我们。

定价

🚧 Beta 版。 Solo 29 美元 / Analyst 79 美元 / Desk 249 美元。托管服务暂停期间（自 2026-09-21 起），结账已关闭；服务恢复后将继续使用下方的套餐名称和价格。托管服务恢复后，付费用户将立即获得：两个受许可证限制的白名单标记工具、托管翻译，以及按量计费的查询额度（2K / 15K / 100K）。监控列表轮询、警报发送、席位限制和分层保留期限均为计划功能，尚不可用——在这些功能发布前，席位数、监控列表数量、警报渠道限制和归档保留期限都只是名义限制，大多数套餐差异化内容仍在路线图中。早期订阅者在这些功能上线后仍可保留注册时的价格。托管服务自 2026-09-21 起暂停，因此目前所有人都无法使用这两个受许可证限制的工具，包括持有许可证的用户。

套餐	每月价格（美元）	监控列表	每月查询数	归档	警报渠道
Cloud Solo	29	5 个*（计划中）*	约 2,000 次*（按量计费）*	30 天*（计划中）*	1 个 Discord 或 Telegram*（计划中）*
Cloud Analyst	79	25 个*（计划中）*	约 15,000 次*（按量计费）*	1 年*（计划中）*	多渠道（Discord / Telegram / Email）（计划中）
Cloud Desk	249	共享，3 个席位*（计划中）*	约 100,000 次*（按量计费）*	团队归档*（计划中）*	Slack / Webhook*（计划中）*

首次付款可在 30 天内申请退款。

订阅：已暂停——托管端点暂停期间（自 2026-09-21 起），结账已关闭。套餐仍列于 koreanpulse.dev/#pricing。服务恢复后，将重新开放各套餐对应的 Polar 结账（Solo / Analyst / Desk），由 Polar 作为交易记录商处理（销售税 / 增值税 / 退款）；Webhook 工作进程会在 subscription.created 时通过电子邮件发送许可证密钥。

企业版 / 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 年 / 团队归档）
托管翻译缓存	无	现已包含（跨租户缓存命中效果会叠加）
账户同步	无	计划中——尚不可用
支持	仅限社区（问题 / PR）	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 许可证，而自行安装也不包含这两个受许可证限制的工具。

工具

共提供 7 个 MCP 工具——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/mo 起，需提供 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 Agent 集成（MCP）	无	无	无	原生
独立用户/中小企业定价	企业级定价	企业级定价	免费（信号较弱）	$29 / $79 / $249 云端层级
韩国激进投资者 / 并购管线	较弱	较弱	被动响应	主动监测 （计划中）

与其他韩国 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 个标签（仅托管版；已暂停）	— 仅原始申报文件	— 仅原始申报文件	— 仅登记数据
英文优先的文档字符串（便于大模型使用）	所有工具	以韩语为主，英语为辅	以韩语为主	是
韩国行业新闻（etnews / 한국경제 / Korea Herald / zdnet RSS，已翻译为英文）	16 个行业	—	—	—
KRX OHLCV（日价格）	— 不在范围内	是（KOSPI / KOSDAQ / KONEX）	—	—
XBRL 财务报表	— 不在范围内	是	是	—
HWP / PDF 附件 → markdown	— 不在范围内	—	是	—
多用户架构（一个端点，N 个 AI Agent 并行）	N→1 托管设计，目前已暂停（按 70% 缓存命中率估算，配额上限约为 9,500 MAU — 推导见 容量）	1:1（每位用户在自己的机器上运行一个进程）	1:1（每位用户在自己的机器上运行一个进程）	托管版
最终用户是否需要 DART API 密钥	托管端点暂停期间需要（托管设计使用共享密钥）	是（每位用户自行注册）	是（每位用户自行注册）	否
定价	免费版 5 个工具 · Solo $29 · Analyst $79 · Desk $249/月	免费开源（自带 API 密钥）	免费开源（自带 API 密钥）	免费匿名套餐

该领域的其他服务（范围不同或安装量较小）： SongT-50/korean-stock-mcp、 koreal6803/finlab-ai （侧重量化）、 eddmpython/dartlab（Python 库）。 上次核实比较信息的日期为 2026-05-07——其他项目此后可能已有更新。

容量（DART 配额计算）

DART 将每个 API 密钥的调用量限制为每天 40,000 次（已于 2026-05 验证）。我们将软上限设为 每天 32,000 次（80%），可通过 DART_DAILY_QUOTA 环境变量覆盖。

备案列表响应通过 list_filings_cached() 处理，并采用会根据数据新鲜度调整的 TTL（当天时间窗口为 60s，≤6d 前为 1h，≥7d 前为 24h）。命中缓存不会消耗 DART 配额。

缓存命中率	客户每日上限	MAU 上限（12mo 组合）
0%（无备案缓存）	32,000	~800
70%（符合现实的 3-mo）	107,000	~9,500
85%（成熟阶段）	213,000	~19,000
95%（高复用率）	~25,000 MAU（受 DART 限制）	—

硬性上限：每个 DART 密钥约 30,000 MAU。超过此上限需要第二个密钥（使用单独的 사업자등록번호）。

预测的 12mo 组合（756 MAU）约为 每天 930 次 DART 调用 = 软配额的 2.9%（缓存命中率为 70%）。在需要配额工程优化前，仍有约 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 是我们唯一的账单服务商和名义商户）。第一方托管 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 ⏳ 监控列表轮询 + 警报分发（计划中，尚未提供）——将 cache-worker cron + daily-worker cron + koreanpulse.alerts 模块接入监控列表到警报的工作流，为 Solo / Analyst / Desk 提供支持。D1 架构和警报分发基础功能已上线；目前缺少 cron 循环。
• W7–8 digest_analyst_reports、summarize_korean_earnings_call
• W9–10 Cloud Desk 的多席位 / 共享监控列表
• W11–12 首位付费客户

架构

• MCP 服务 — FastMCP（Python），通过 stdio 在用户的计算机上运行。我方无需承担托管成本。云端客户仍需在本地安装；切换 KOREANPULSE_CACHE_MODE=hosted 后，仅翻译调用会路由至 Worker。
• 缓存 Worker（cache-worker/）— Cloudflare Workers + KV。保存我们的 OpenAI 密钥，提供全局翻译缓存，并在每次调用前进行许可证检查。免费套餐（Workers 每天 100K 次请求 + KV 每天 100K 次读取）足以支撑付费流量，远超 $5K MRR。
• 每日 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 可自托管 vs Cloud

运行 MCP 有两种方式，通过 KOREANPULSE_CACHE_MODE 切换。两种方式都需要本地安装（pip install koreanpulse + 4 行 Claude Desktop 配置）；区别在于翻译请求是经由我们的 Worker，还是从你的机器直接发送到 OpenAI。

（“自行运行”部分也有快速入门对比——编辑时请保持两处内容同步。）

	local（OSS 可自托管）	hosted（Cloud Solo / Analyst / Desk）
本地 MCP 安装	必需	必需（相同的 pip install）
服务提供商密钥	你的 OPENAI_API_KEY	我们的密钥，在 Worker 上（你无需提供 OpenAI 密钥）
翻译缓存	本地 JSONL 文件	全局 Cloudflare KV（跨租户复用）
单次调用成本	由你向 OpenAI 付费	由你的 Cloud 套餐承担
隐私	翻译内容不会离开你的机器和 OpenAI	翻译请求会发送到我们的 Worker；DART 流量仍在本地
适合人群	极客、OSS 贡献者、对隐私要求最高的环境	任何想在功能上线后使用监控列表到警报工作流的人

缓存命中是每月 29 美元的 Solo 套餐能够保持健康毛利率的关键：同一条韩国公告标题只需翻译一次，然后就能通过 KV 提供给同一套餐的所有其他租户。不同模式的环境变量配置区别请参阅 docs/CLAUDE_DESKTOP.md。

托管 HTTP 传输——自 2026-09-21 起暂停。 第一方端点 https://mcp.koreanpulse.dev/mcp（Streamable HTTP）最后一次通过 ChatGPT 和 Claude.ai 的端到端验证是在 2026-05-06，目前已关闭；该端点不会响应。HTTP 传输代码（koreanpulse.mcp_http）仍保留在仓库中，供可自托管用户使用。本地 stdio 安装方式仍是可自托管用户和隐私要求最高用户的标准方式；Smithery 列表 让 Smithery CLI 用户仍可通过发现路径找到该工具。

法律声明

• 韩国新闻：仅提供附带来源标注的简短摘要和外部链接，不转载全文。摘要根据公开 RSS 源的元数据生成。
• DART 数据：通过 DART 开放 API 获取并注明来源；每条数据都链接到原始公告。底层公告仍受其各自适用规则约束。
• 韩国券商报告：不予收录（不包含付费墙后的报告）。
• 不使用空间或地图数据。
• 不构成投资建议。 koreanpulse 提供披露数据、翻译、筛选和标签功能。不执行交易，也不提供个性化买卖建议；不会进行个性化分析。所有输出均为一般性数据，仅供参考。
• 用户应评估其所在司法管辖区和使用场景所适用的许可、数据使用和金融服务义务，尤其是在向下游重新分发数据时。本仓库中的任何内容均不构成法律建议。
• 隐私与数据保护：请参阅 https://koreanpulse.dev/privacy——涵盖韩国 PIPA、EU GDPR 和 US CCPA。服务条款：https://koreanpulse.dev/terms。

计费（Polar — 当前服务商）

计费由 webhook-worker/ Cloudflare Worker + D1（SQLite）处理。运营方无需运行任何服务器。

当前服务商：Polar（polar.sh）——自 2026-05-06 起担任 Merchant of Record。为所有订阅处理增值税 / 销售税 / 退款 / 拒付。用户在 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）— 已发布

docs/BETA.md 中包含 Beta 用户获取计划（30 天内获得 50 位用户）和面向加密货币原生用户的渠道组合。演示录制脚本见 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。

示例提示词

将以下内容复制并粘贴到 Claude.ai、ChatGPT，或连接到自安装的 koreanpulse 服务的任何 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]"

前三个提示词使用免费工具（无需注册）。最后两个提示词使用活动人士和外国持有人许可名单标记功能，该功能仅在托管服务上运行（自 2026-09-21 起暂停），并且需要 Solo $29/mo 许可证密钥；自安装版本无法使用这些功能——如果缺少 license_key，服务会返回一条简短通知，说明需要许可证密钥（响应中不含结账链接）。

许可证

源代码：AGPL-3.0-or-later。托管服务：商业服务。

版权所有 (C) 2026 Lee Jong-guk (이종국)

本程序是自由软件：您可以根据自由软件基金会发布的 GNU Affero 通用公共许可证的条款重新发布和/或修改本程序；许可证可以是第 3 版，也可以是（由您选择）任何更高版本。本程序按“原样”提供，不提供任何担保；也不提供任何明示或暗示的担保，包括但不限于适销性或特定用途适用性的暗示担保。完整文本请参阅 LICENSE，或访问 https://www.gnu.org/licenses/。