Usitc Edis

@pipeworx/usitc-edis — USITC 调查案卷（第 337 条 / 第七编）

美国国际贸易委员会（USITC）调查的案件案卷：第 337 条（不公平进口 / 专利）案件和第七编（反倾销 / 反补贴税，“进口损害”）案件，通过 IDS（调查数据库系统，ids.usitc.gov）访问——可搜索 / 列出全部约 4,400 项调查，并查看单项调查的完整详情。无需密钥。

属于 Pipeworx — 一个将 AI Agent 连接到 1684+ 个实时数据源的 MCP 网关。

此处不提供的内容：已提交的文件（EDIS）

此工具包不提供 EDIS（电子文件信息系统，edis.usitc.gov）——即调查中提交的文件及其附件。EDIS 的 WAF 会向任何使用非已识别通用 HTTP 客户端签名 User-Agent 的请求返回 403（伪装成通用的“维护中”HTML 页面），即使发送了有效的 API 密钥也一样 — 已于 2026-09-24 实时验证。此工具包的早期版本曾在 User-Agent 前加上 curl/8.7.1 ，冒充其他客户端，以绕过此限制。Bruce 对此作出否决（2026-09-25），推翻了此前允许这种做法的案件裁定，因此移除了 edis_* 工具，以及仅为其提供服务的令牌 / curl 相关代码。

在 EDIS 提交的文件正等待 USITC 将我们如实声明的 User-Agent 加入允许列表 （pipeworx-usitc-edis/1.0 (+https://pipeworx.io)）。若要在此处重新加入 EDIS 接口，需要先获准加入允许列表，或找到其他无需冒充客户端即可绕过 WAF 的途径 — 不能重新添加 curl 前缀。

工具

工具	认证	可回答的问题
itc_investigation_search	无	分页列出调查，按最新优先排序，并可在同一页面按类型 / 活跃状态筛选
itc_investigation_detail	无	查看某项调查的完整状态记录（通过内部 investigation_id 查询）
itc_investigation_types	无	查看 4 个顶级调查类型类别

认证

此工具包中的所有内容均无需密钥，已于 2026-09-24 实时验证。IDS （advanced-search、investigation/{id}、lookup/investigation-types）均可在完全不提供凭据的情况下返回真实数据。唯一的请求头要求是模拟浏览器的 Origin / Referer（这不是凭据，只是同源页面会发送的内容）；仅提供普通 User-Agent 的请求会被拒绝。

数据源

• https://ids.usitc.gov/idata/api/v1/advanced-search（POST）— 分页搜索 / 列出调查。
• https://ids.usitc.gov/idata/api/v1/investigation/{id}（GET）— 调查完整详情。
• https://ids.usitc.gov/idata/api/v1/lookup/investigation-types（GET）— 4 个顶级调查类型类别。

留给下一位构建者的注意事项

• GET investigation/{id} 包含 ITC 员工身份信息 — case_manager_id 包含案件经理的全名、个人工作邮箱 和电话号码。这是委员会工作人员的信息，而非案卷当事人的信息， 并且 itc_investigation_detail 会直接删除该字段，而不是对其进行脱敏。 今后在此处添加任何案件级端点（参与方、知识产权、HTS 编号、命令、投票）， 也应遵循同一规则——已于 2026-09-24 尝试实时访问，但 case/participants、case/hts_numbers、 case/unfair_import_orders*、investigation/participants 等均无法访问 （要么在尝试的所有查询参数形式下都返回 503 维护页面，要么—— investigation/intellectual_property——不管传入什么筛选条件， 都返回未经筛选的约 880KB 数据）。因此没有构建并发布不可靠的功能； Angular 包（ids.usitc.gov/main-*.js）中可见的路由模式 （/case/{case_id}/investigation/{investigation_id}/...）是下一步线索。
• IDS 的 advanced-search criteria 筛选 DSL 尚不明确。实时 Angular 应用 （ids.usitc.gov/case）会在服务端构建一个结构化的 criteria 数组， 供筛选流程使用，但实时尝试的各种形式（{field, value}、{fieldName, operator, value}、DevExtreme 风格的 [field, "=", value] 三元组）要么静默匹配不到任何内容，要么像格式错误一样重定向到 302。 因此，itc_investigation_search 仅公开经过实时验证的参数 （pageNumber、pageSize、针对 institution_start_date 的 sortOrder）， 并在同一页内按类型和活动状态进行客户端筛选。**获取真实 DSL 是实现真正 服务端筛选的最快途径：**在浏览器中打开 ids.usitc.gov/case，使用高级搜索筛选， 然后从开发者工具中读取 POST 请求正文。
• advanced-search 的响应封装有个小问题：在某些请求形式中，匹配总数位于顶层的 totalRecords；而在另一些形式中，hitCount 位于每条案件记录内部—— 切勿信任顶层的 hitCount；顶层并没有这个字段。
• EDIS（edis.usitc.gov）是独立的、需凭据访问的服务，并使用 UA 筛选 WAF。 此处有意不提供该服务——请参阅上文“此处未提供的内容”。 不要使用伪造的 User-Agent 重新添加它。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/usitc-edis/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 都连接到同一个网关和同一组 1684+ 个数据源。唯一的区别在于直接列出的 工具来自哪个工具包；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/itc_investigation_search \
  -H 'Content-Type: application/json' \
  -d '{"page_size":5,"sort_order":"desc"}'

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

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

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

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

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-usitc-edis

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Usitc Edis data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT