快速开始

五分钟内,从零拿到第一条带 SEC filing 引用的 MCP 查询结果。

4 分钟阅读更新于 2026-05-20 入门级

KO 通过一个 MCP 端点和并行的 REST API,提供 SEC 文件、内部人交易、13F 持仓、国会交易与宏观指标。本页用三步把 MCP 服务器接入你的 Agent。结束时,你会有一次针对 marts.fact_holdings 的真实调用。

提示 · 你会学到

注册免费账号 → 在 Claude Desktop 装好 MCP 服务器 → 用一句自然语言查询 85.4M 行 SEC 持仓数据。

在 ko.io/auth/register 注册。免费档每月 500 次 MCP 调用、1,000 次 REST 调用,无需信用卡。登录后进入 /console/keys,点击 新建密钥。

BASH

# 一次性打开注册页与密钥控制台
$ open https://ko.io/auth/register
$ open https://ko.io/console/keys

成功

密钥创建后立即存进密码管理器——完整值只在创建时显示一次。一个密钥同时用于 MCP 与 REST。

ko.io/console/keys — 首次登录后的控制台

② 接入 MCP

如果你用 Claude Desktop、Cursor 或 Windsurf,MCP 是最快路径——19 个工具自动注册,且保留引用字段。把下面的片段写入 claude_desktop_config.json 后重启应用。

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ko-sec-data": {
      "transport": "http",
      "url": "https://mcp.ko.io/mcp",
      "headers": {
        "X-API-Key": "ko_live_..."
      }
    }
  }
}

把 ko_live_... 替换成第一步复制的密钥。Cursor 用同样结构写到 ~/.cursor/mcp.json;ChatGPT 或自定义客户端见完整接入教程。

注意 · 不要提交此文件

MCP 配置里的 API 密钥是明文。把 claude_desktop_config.json 和 .cursor/mcp.json 加进全局 ~/.gitignore_global。一旦密钥进了公开仓库,立刻在控制台吊销。

③ 第一个查询

重启 Claude Desktop。输入框右下角的 MCP 指示器应显示 ko-sec-data — 19 工具。在任意对话里问:

列出伯克希尔在 2025 Q4 按市值排序的前 10 大持仓。

Agent 会选择 get_institution_holdings,调用 MCP 服务器并返回结构化结果。背后这次调用解析为:

JSON · GET /v1/institutions/0001067983/holdings?quarter=2025Q4

{
  "data": [
    {
      "ticker": "AAPL",
      "shares": 300000000,
      "value_usd": 75120000000,
      "pct_portfolio": 22.41,
      "source": {
        "form": "13F-HR",
        "accession_number": "0001067983-26-000009",
        "filed_at": "2026-02-14",
        "url": "https://www.sec.gov/Archives/.../13fhr_2025q4.xml"
      }
    },
    { /* BAC, AXP, KO, CVX, OXY, MCO, ... */ }
  ],
  "meta": { "total": 10, "as_of": "2026-02-14", "latency_ms": 38 }
}

每行都带一个 source 对象(含 form / accession_number / filed_at / url),你的 Agent 能把这条 13F-HR 引用回 SEC EDGAR 原文。可以接着追问 "和 2025 Q3 对比一下" 或 "列出前 3 个标的本月的内部人 Form 4 卖出"——Agent 会自动串联工具,无需重新提示。

速率限制

Pro 档上限 500 次 / 分钟,免费档 60 次。超出会返回 429 Too Many Requests 并带 Retry-After 头。回退策略与单工具上限见速率限制参考。