Insider Trading

@pipeworx/insider-trading

美国上市公司的 SEC EDGAR 内部人士及所有权申报——通过 EDGAR 全文搜索实时读取 Form 4 内部人士交易、8-K 重大事件以及 Schedule 13D/G 持股申报。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1881+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也不是由其发布。

工具

工具	返回内容
insider_trades	Form 4 申报：日期、提交申报的高管／董事／持股 10% 以上的所有者、表格、accession、EDGAR 链接
insider_8k	8-K 申报，附有解码后的条目代码（财报、收购、高管离职、退市……）
insider_13d	Schedule 13D/G 受益所有权申报：哪位投资者的持股超过 5%、时间以及申报链接
insider_activity_summary	一次调用获取以上三类数据——90 天的 Form 4 和 8-K、一年的 13D/G，以及数量统计

四种工具均接受 ticker，也接受公司名称（"NVIDIA Corp"）或纯 CIK。insider_trades / insider_8k / insider_13d 还接受 days 和 limit（最大值为 200）。

数量统计的含义

total_*_filings 是 filings 中的行数——两者始终一致。同一公司和时间范围内的上游总数会单独报告为 matched_*_filings，如果数量更多，则会显示 truncated: true。增大 limit 即可获取其余内容。（在 2026-08-31 之前，数量统计是上游总数，而行数据是客户端筛选后的子集，因此工具可能返回 {total_form4_filings: 3, filings: []}，并正常显示 200——fleet #739。）

如果没有匹配的 SEC 注册实体，ticker 会返回 {found: false, reason: "unresolved_company", hint}，而不会抛出错误，方便 Agent 恢复处理。reason: "missing_ticker" 表示参数为空。

身份验证

无需身份验证。EDGAR 不需要密钥。SEC 公平访问规则要求提供描述性 User-Agent，该数据包会发送此标头；请求受 SEC 每 IP 约 10 次／秒的限制，因此突发并行调用可能会暂时失败。

数据源

• EDGAR 全文搜索 — https://efts.sec.gov/LATEST/search-index （forms、ciks、dateRange=custom + startdt/enddt、用于分页的 from）
• SEC 公司 ticker 列表 — https://www.sec.gov/files/company_tickers.json （ticker／名称 → CIK，通过 @pipeworx/shared 中的 resolveSecEntity）
• 申报文件 — https://www.sec.gov/Archives/edgar/data/<cik>/…（提供链接，不获取文件）

值得了解的上游注意事项

• forms 会筛选 ROOT 表格。 Schedule 13D/G 的 ROOT 表格为 SCHEDULE 13D / SCHEDULE 13G；旧版拼写 SC 13D 无法匹配任何 文档，并会静默返回空结果。
• efts 的缓存键不包含 ciks，因此经过筛选的请求可能会以 200 状态码返回 未筛选的缓存正文。此处的每个请求都会携带一个取反的无意义词元 （-zqfc<cik>）以确保缓存键唯一，检查回显的 query.query.bool.filter，并再次按 CIK 筛选每一行。
• 仅提供 startdt 的 dateRange=custom 会被静默忽略——始终会发送 两个边界值。
• display_names 中的 ticker 格式并不一致。 NVDA Form 4 显示为 NVIDIA CORP (CIK 0001045810)，而 NVDA 8-K 显示为 NVIDIA CORP (NVDA) (CIK 0001045810)。切勿通过匹配该字符串中的 ticker 来选择公司；请在服务器端使用 ciks 筛选。

快速开始

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

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/insider-trading/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点除了列出自身工具包的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威答案。

这是有意为之，并非意外复用。元工具能让受限连接回答本工具包未覆盖的问题——通过 ask_pipeworx 在整个目录中进行路由——无需添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义比路由带来的价值更耗费上下文，不如只连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不仅仅是此工具包的工具：

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

这两个 URL 都连接到同一个网关和相同的 1881+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/insider_trades \
  -H 'Content-Type: application/json' \
  -d '{"ticker":"NVDA","days":30}'

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

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

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关：

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

也可以直接运行，以确认服务能够启动：

npx -y @pipeworx/mcp-insider-trading

它通过 stdin/stdout 使用 MCP 通信，并针对仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所附带的共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT