跳到正文

用 AI 智能体查询 SEC 数据

接入 AI 智能体，查询机构申报的持仓，并与国会议员披露的交易对照。适用于 Claude Code、Codex、Cursor、Grok、Gemini 或任意 MCP 客户端。第一个示例可在演示模式下免密钥运行；涉及历史数据的问题属于 Pro 版及以上套餐（免费版：最近一个季度）。

示例响应采集于 2026年9月26日，对应 2026年Q2。再次运行时可能返回更新的报告期。

  1. 第 1 步：接入 MCP 服务器

    在 Claude Code 中添加 MCP 服务器：

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

    使用 Codex、Cursor、Grok 或 Gemini？各客户端的配置见 MCP 页面。用 claude mcp list 验证，应能看到 ko-sec-data ... ✔ Connected。

  2. 第 2 步：查询申报持仓

    你的提问
    列出 Berkshire Hathaway 最新一个 13F 申报季度的前几大持仓，以及它们相对上一季度的变化。

    智能体会把 Berkshire Hathaway 解析为 CIK 1067983，然后请求它申报的持仓。采集到的工具响应：

    get_institution_holdings

    采集的响应 · 2026年9月26日 · 2026年Q2
    工具响应数据行
    • AAPL
      APPLE INC
      $659.5亿
      权重
      22.04%
      变动
      UNCHANGED
    • AXP
      AMERICAN EXPRESS CO
      $512.8亿
      权重
      17.14%
      变动
      UNCHANGED
    • GOOG†
      ALPHABET INC
      $377.6亿
      权重
      12.62%
      变动
      ADDED

    † 发行人合计：该行合并了同一发行人的多个股类，即 GOOGL 78,791,167 股（$281.6亿） + GOOG 27,188,433 股（$96.06亿）。如只需某一股类，可按单个代码查询（ticker "GOOG"）。

    来源SEC EDGAR13F-HRBerkshire Hathaway Inc · CIK 1067983

    这个查询最新持仓的示例可在演示模式下免密钥运行（按 IP 限制调用频率）。免费 API 密钥每天可调用 200 次。历史数据属于 Pro 版及以上套餐。

  3. 第 3 步：对照持仓​与披露交易

    你的提问
    对比同一季度中机构申报的增持与国会议员的买入。说明各自的报告期、覆盖范围以及这种对比的局限。

    智能体可能需要多次调用工具，通常是 get_stock_holders、get_congress_trades 和 get_insider_trades，再自行筛选。对比不同数据集之前，请先核对返回数据的日期和覆盖范围。前两个查询需要 13F 与未交割（FTD）的历史数据，属于 Pro 版及以上套餐；国会议员披露（含完整历史）登录免费账户即可使用：

    • 画出 NVIDIA 最近八个季度的机构申报持仓变化，并说明所用指标和报告期。
    • 对比同一批证券的 Reg SHO 阈值名单记录与未交割（FTD）记录。

    国会议员交易披露在所有套餐中免费；查看某位议员的完整历史只需免费登录：

    • 列出 Nancy Pelosi 今年的交易披露，包括交易日期、披露日期、持有人和申报金额区间。

  4. 第 4 步：使用你的 API 密钥接入

    免费 API 密钥提供独立额度：每天 200 次调用，REST 与 MCP 共用。免费版仅含最近一个季度和最新数据；完整历史需 Pro 版或更高套餐。Pro 版（每天 20,000 次调用）增加完整历史、宏观数据（美国国债、美联储、BLS、CFTC、FDIC、EIA、OFR）、13D / 13G、Form D、PDF 报告和申报文件正文。未交割（FTD）和 Reg SHO 阈值名单在所有套餐中均可使用，包括演示模式。卖空持仓数据仍在开发中，暂不提供。

    附上你的密钥（通过 Authorization 请求头发送）
    claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcp \
  --header "Authorization: Bearer ko_live_YOUR_KEY"

    不要把密钥​放进共享文件

    Claude Code 会把这个请求头连同 API 密钥保存在它的配置文件中，请勿把该文件放进共享仓库或日志。无法设置请求头的客户端可以改为在 URL 后加 ?api_key=，但这样密钥更容易出现在日志里。一旦泄露，请在控制台创建新密钥并吊销旧密钥。
    获取 API 密钥 API 参考

下一步