Sec Insider

sec-insider

SEC Forms 3/4/5 — 内部人交易，托管后便可反向查询。

Pipeworx 的一部分：https://pipeworx.io — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

为什么要托管

所有内部人 API 都以公司为起点，我们的也不例外：传入一家发行方，就能获取其 Form 4。“上周哪些内部人买入最多，无论是哪家公司” 无法从某个申报人开始查询——因为聚合涉及所有发行方——因此没有任何上游数据源能够回答。扁平表格让这类查询只需一次索引查询。

工具

• insider_top_buyers({since?, until?, min_value_usd?, limit?}) — 按美元金额列出所有发行方中规模最大的公开市场买入。
• insider_top_sellers({…}) — 同样适用于卖出。
• insider_coverage() — 查看已加载的季度发布内容，以及买入的统计口径。信任排名前请先检查此项。

交易代码决定了每行数据的全部含义

在已加载的时间范围内，182,061 笔交易的分类如下：

代码	含义	行数
S	公开市场卖出	27,601
A	授予或奖励	19,211
M	期权／衍生品行权	10,783
F	扣留股份用于缴税	9,357
P	公开市场买入	11,261

只有 P 代表有人决定在市场上买入。授予属于薪酬，行权则是转换。若“买入最多”的排名把 A 或 M 也计算在内，就会把实际上什么也没买的内部人排到前面，因此此工具包只筛选 P，并会在每个响应中说明这一点。

关于数据的两点说明

日期由申报人提供，有时会出错。 已加载的时间范围内有 7 行日期在未来，最远到 2028 年；还有 2,902 行日期早于 2025 年 10 月。较早的日期是合理的（Form 5 和修正申报会报告过去期间的数据）；未来日期则是笔误。若不加限制地按新近程度排序，日期错误的行就可能排在最前面，因此最新日期探测会限制在今天。

数据最多会滞后一个季度。 SEC 按季度重新发布数据，因此最近几周的数据通常尚未出现在任何一次发布中。默认时间范围以实际已加载数据中的最新日期为锚点，而不是今天——否则“过去 90 天”会完全落在数据范围之外，导致本来有答案的问题返回空结果。若某个时间范围内没有数据，会说明已加载哪些发布内容，而不是只返回一个空列表。

加载

node scripts/ingest-sec-insider.mjs 2026q2 2026q1

URL 前缀已更改。 最新季度发布在 /files/datastandardsinnovation/data/… 下；较早的季度仍在 /files/structureddata/data/… 下。两处数据都可访问——2026q2 只能从第一个路径获取，2026q1 只能从第二个路径获取——因此只识别一种前缀的加载器会在不作提示的情况下漏掉一半归档。加载器会先尝试新版路径，再尝试旧版路径。

FOOTNOTES.tsv 是 zip 中最大的文件（36.6 MB），本项目不会读取它；该文件不会被解压。架构：supabase/migrations/072_sec_insider.sql。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "sec-insider": {
      "url": "https://gateway.pipeworx.io/sec-insider/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/sec-insider/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关级别的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点会列出大约 30 个共享工具，以及该工具包自身的工具。连接的 initialize 响应会说明其确切范围，并且是当天适用的权威信息。

这是有意设计的，并非意外的多路复用。元工具可以让限定范围的连接回答此工具包未涵盖的问题——通过跨整个目录路由的 ask_pipeworx，无需再添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义消耗的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

你也可以连接完整的 Pipeworx 网关，直接获取所有工具包列出的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是，哪些工具包的工具会被直接列出；通过任一端点，ask_pipeworx 都可以访问所有工具包的工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/insider_top_buyers \
  -H 'Content-Type: application/json' \
  -d '{"limit":10}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/insider_top_buyers。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关往返：

{
  "mcpServers": {
    "sec-insider": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-sec-insider"]
    }
  }
}

或者直接运行，以确认服务可以启动：

npx -y @pipeworx/mcp-sec-insider

它通过 stdin/stdout 使用 MCP 协议，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接额外提供的共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你也可以用通俗英语提问，而不是直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Sec Insider data" })

网关会自动选择合适的工具并填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT