ko-mcp

30 秒快速开始

在 AI Agent 中使用（MCP）——立即可用，无需密钥：

claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcp

接着可以询问：“谁在买入 NVDA？”、“国会议员上个月交易了什么？”、 “哪些机构持有现货 BTC ETF？”——Agent 会调用真实工具，并引用真实文件。

通过 REST 使用——无密钥演示模式：

curl "https://api.ko.io/api/v1/institutions?search=berkshire&demo=true"

在 Python 中使用：

pip install ko-edgar

from ko_edgar import KoClient

ko = KoClient()  # demo mode; KoClient(api_key="ko_live_...") for your quota
for h in ko.stocks.holders("NVDA"):
    print(h["name"], h["holding_value"], h["action"])

在 TypeScript 中使用：

npm install @ko-io/sdk

import { KoClient } from "@ko-io/sdk";

const ko = new KoClient(); // or { apiKey: "ko_live_..." }
const { rows } = await ko.congress.trades({ sort: "recent" });

免费密钥每天可调用 200 次，永久免费，无需信用卡 → ko.io/console。

此仓库包含什么

浏览文档索引，查看设置指南、软件包文档和贡献工作流。

目录	内容
server/	托管的 MCP 服务（mcp.ko.io）——Cloudflare Worker，包含 32 个工具，从此仓库部署
docs/clients/	每个 MCP 客户端的已验证设置指南
python/	ko-edgar——官方 Python SDK（同步 + 异步，带类型）
typescript/sdk/	@ko-io/sdk——官方 TypeScript SDK（Node 18+、浏览器、边缘环境）
typescript/mcp-proxy/	@ko-io/mcp-sec-data——为不支持远程 HTTP MCP 的客户端提供的 stdio 桥接程序
cookbook/	针对真实投资问题的 10 个可运行解答
llms.txt	每个工具和端点的机器可读映射

server/ 中的 MCP 服务与运行在 https://mcp.ko.io/mcp 的代码完全一致——每次对 main 分支中 server/ 的更改推送后都会部署。 你也可以在自己的 Cloudflare 账户中自托管（执行 cd server， 删除 wrangler.toml 中的 routes 区块——它固定指向 ko.io 区域—— 然后执行 npx wrangler deploy）；它会使用你的 API 密钥代理到 api.ko.io， 因此你的配额和套餐会随你使用。API 背后的数据管道作为托管服务运行（双区域、3 副本 ClickHouse、27 条管道按照各数据源的发布计划刷新）。

注意：三个客户端软件包均已发布——ko-edgar 已发布到 PyPI，@ko-io/sdk 和 @ko-io/mcp-sec-data 已发布到 npm。托管 MCP 端点和 REST API 现已可用。

连接客户端

客户端	指南	单行命令
Claude Code	指南	claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcp
Claude Desktop	指南	远程 HTTP 配置或 npx -y @ko-io/mcp-sec-data
Cursor	指南	~/.cursor/mcp.json
Windsurf	指南	Cascade → MCP
Zed	指南	设置中的 context_servers
OpenAI Codex	指南	codex mcp add ko-sec-data --url https://mcp.ko.io/mcp
ChatGPT / Gemini / Grok	指南	REST API / 自定义 GPT Actions

如需在任何客户端中使用自己的配额，请在服务 URL 后添加 ?api_key=YOUR_KEY， 或发送 Authorization: Bearer YOUR_KEY。

数据

数据集	覆盖范围	免费层级
13F 机构持仓	8,800 万+ 行，2013 年至今，按机构家族合并	✅
内部人交易（Form 3/4/5）	1,100 万+ 笔交易，已分类公开市场交易	✅
国会议员交易	STOCK Act 披露，涵盖两院	✅
加密货币 ETF 敞口	根据 13F 数据统计的机构现货 BTC ETF 持仓	✅
Form 144	内部人计划出售的股份（前瞻性）	✅
未能交割数据 + Reg SHO	空头压力的痕迹	✅
股票价格与财务数据	每日 OHLCV + 从 XBRL 得出的 10-K/10-Q 报表，包括现金、资本支出、自由现金流、股票回购、股息	✅
SEC 文件网关	任何文件，提供带签名的可分享链接	列表/索引 ✅ · 文件 Pro
宏观数据（财政部、美联储、CPI、OFR 压力指标）	每日联邦来源数据	Pro
欧洲披露（SE、NL、DK、UK）	内部人交易（PDMR）、主要持仓、净空头头寸（UK 除外）、年度报告；每行注明来源。实时数据：自 2026-10-17 起涵盖所有四个市场（UK 不提供空头头寸）——get_eu_markets 会显示哪些数据已上线	✅（滚动时间窗口）

所有数据都在处理流程中追溯至来源，文件网关还能获取底层 SEC 文件——因此你的 Agent 引用的是真实文件，而不是编造数字。

32 个 MCP 工具

机构：get_institution_holdings · list_institutions · 股票：get_stock_profile · get_stock_holders · get_stock_activity · get_stock_price · get_stock_financials · 内部人：get_insider_trades · list_insider_traders · 国会：get_congress_trades · get_congress_member · 政府合同：get_gov_contracts · search_gov_contracts · 加密货币：get_crypto_exposure · get_crypto_holders · get_crypto_holder · 文件：sec_list_filings · sec_get_filing_index · sec_get_filing_document · 空头数据：get_ftd_data · 搜索：search · Form 144：get_form144_notices · 宏观（Pro）：get_treasury_yields · get_fed_rates · get_economic_indicators · get_financial_stress · 欧洲：get_eu_markets · get_eu_insider_dealings · get_eu_major_holdings · get_eu_short_positions · get_eu_annual_reports · get_eu_issuer

完整参数参考：llms.txt · ko.io/docs

公司财务数据

get_stock_financials 返回 10-K/10-Q 报表数据：营收、净利润、每股收益、利润率、经营现金流、 cash_and_equivalents、total_assets、total_liabilities、capex、free_cash_flow、stock_repurchase（股票回购）、 dividends_paid、investing_cashflow、financing_cashflow 和债务。 资本支出、股票回购和股息通常均为正数现金支出（USD）；负值会按申报或推导结果原样传递；负的 capex 会使 free_cash_flow 为 null。 仅当经营现金流和 capex 均有报告且 capex >= 0 时，free_cash_flow = operating_cashflow - capex；否则为 null（缺失值绝不会按 0 处理）。 cash_and_equivalents 不包括短期投资；long_term_debt 是 us-gaap LongTermDebt，其中包括流动部分。 示例：“MSFT 最近 4 个季度的股票回购” -> get_stock_financials(ticker="MSFT", period_type="quarterly", limit=4)。 免费且无需密钥的调用仅返回最近一个季度；更早的季度数据和年度报表需要 Pro。

政府合同

get_gov_contracts 返回自 FY2015 以来美国联邦主合同的发行方级别义务金额。 使用 include=actions 获取行动行，或使用 award_id 获取归属于某个合同的一项行动。 search_gov_contracts 可跨公司搜索行动，或使用 view=companies 对公司进行排名。 金额始终以精确的十进制字符串表示。总额为正数义务金额；撤销义务为负数；净额为两者之和。 免费访问范围覆盖过去 92 天。历史数据需要 Pro。 选择一个时间范围：period、fiscal_year 或 from/to。 自动精确匹配涵盖当前上市的公司，以及有记录证据的经审核关联。 没有关联的行动并不能证明没有合同。最近几个月的数据尚属暂定；国防部报告约延迟 90 天。 请参阅方法说明。

为什么不直接抓取 EDGAR？

有很多出色的开源工具可用于从 SEC EDGAR 获取原始文件 （例如 sec-edgar-mcp——如果 你需要在本地进程中获取某家公司的原始文件，这是个不错的选择）。 ko.io 解决的是另一个问题——回答原始 EDGAR 无法回答的问题：

	原始 EDGAR 访问	ko.io
“获取 AAPL 最新的 10-K”	✅	✅（文件网关）
“所有机构都在买入哪些 NVDA 股票？”	❌ 需要解析每一份 13F	✅ 122ms
“伯克希尔过去 52 个季度的投资组合”	❌ 实时解析 50 多份文件	✅ 预计算
“将 Vanguard 的 7 个申报实体合并为一家管理机构”	❌	✅ 家族合并
国会议员交易、FTD、宏观数据、加密货币敞口	❌ EDGAR 不包含	✅
在基于 Web 的 AI 中使用（claude.ai、ChatGPT）	❌ 本地进程	✅ 托管 MCP
设置	Python 环境 + 安装	一条命令，无需安装

方案

	Demo（无需密钥）	Free	Pro	Builder
每日调用次数	有限	200	20,000	200,000
每次请求的行数	500	500	5,000	50,000
核心 SEC 数据	✅	✅	✅	✅
历史数据深度	最新	最新	完整	完整
宏观数据（财政部 / 美联储 / CPI / 压力指标）	—	—	✅	✅
批量导出	—	—	—	✅

配额于 00:00 UTC 重置。MCP 和 REST 共用一个配额。价格：https://ko.io/pricing/

贡献

欢迎提交 Issue 和 PR——请参阅 CONTRIBUTING.md。 安全问题请报告至：SECURITY.md。

MIT © ko.io