Ftc Enforcement

@pipeworx/ftc-enforcement

FTC（美国联邦贸易委员会）的案件与程序——涵盖竞争／合并执法和消费者保护执法，可按公司、案件／事项编号、主题或日期查询。它与 hsr-notices（合并申请进行反垄断审查的最早信号）和 enforcement-actions（DOJ 新闻稿及 SEC 诉讼／行政执法信息源）互为补充，提供 FTC 自有的案件记录：投诉、同意令、和解、案件状态及相关联邦法院。

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

工具

• ftc_search_cases(query?, category?, status?, start_date?, end_date?, limit=20) — 按公司名称、个人姓名、案件／事项编号或关键词搜索案件／程序。category 可限定为 merger、nonmerger（行为执法）或两者（any，默认值）。status 可限定为 pending、closed 或 under_order。
• ftc_case_detail(slug) — 获取单个案件的状态、联邦法院（如有）、完整当事人名称、案件摘要、相关联的新闻稿，以及完整的文件时间线（投诉、命令、和解、诉状），每份文件均包含提交日期、标题和 PDF URL。接受 ftc_search_cases／ftc_recent_actions 返回的 slug 字段（即案件 ftc.gov URL 的最后一个路径段）或完整案件 URL。
• ftc_recent_actions(days=30, category?, limit=20) — 获取最新案件／程序，可选择限定为合并或非合并执法。

合并与非合并

category: "merger"／"nonmerger" 对应 FTC 自有的“竞争主题”筛选项（实时搜索表单中的 field_competition_topics=708／711）——这是 ftc.gov 自有搜索中唯一能区分合并执法与非合并（行为）执法的筛选项。field_case_action_type（联邦／行政／程序执法）和 field_enforcement_type 无法进行这种区分。

数据来源

数据直接从 FTC 自有的 Drupal Views 搜索页面 https://www.ftc.gov/legal-library/browse/cases-proceedings 实时抓取。此内容没有结构化信息源：api.ftc.gov（hsr-notices 套件使用的 JSON:API 中介）仅记录了两种资源类型——HSR 提前终止通知和“请勿来电”投诉（已根据 FederalTradeCommission/ftc-api-docs 核实，2026-10-07）；而 /jsonapi、/v0/cases、/v0/legal-library-items 等类似路径均返回 404。此套件向公开搜索表单发出与浏览器相同的 GET 请求，并解析返回的 HTML：这是每次请求都实时代理公开 FTC 数据，而非镜像数据集。

每个响应都通过各案件自身的 last_updated 字段（FTC 自有的“最后更新”日期）提供 data_as_of，并附上指向 ftc.gov 及相关 PDF 文件的 url／documents[].url。

可达性说明

从非 Worker 的网络环境发起带有描述性 User-Agent 的普通 GET 请求可以成功（已于 2026-10-07 验证）。www.ftc.gov 使用了某种机器人过滤机制——不带 UA 的请求即使访问 /robots.txt 也会收到类似 Akamai 的“似乎是滥用自动化请求”拦截页面，而带 UA 的请求则不会——这与该集群此前遇到的“.gov UA 拦截”类别相符，不一定属于优质 UA 也无法绕过的 Cloudflare 出口 IP 拦截类别（loc.gov、Kalshi、Overpass；参见 mcps/chronicling-america）。只能通过已部署 Worker 自身的出口确认这一类别。src/index.ts 中的 pwFetch 是带有描述性 UA 的直接 fetch，也接受与 chronicling-america 使用的格式相同的 _proxyUrl/_proxyToken——如果部署后的探测显示出现 403，修复方法是：将 www.ftc.gov 添加到 supabase/functions/egress-proxy 的 ALLOWED_HOSTS，部署该函数，在网关的 workers/gateway/src/index.ts 中将 entry.slug === 'ftc-enforcement' 添加到 EGRESS_PROXY_URL/EGRESS_PROXY_TOKEN 注入代码块，然后重新部署网关。无需更改 pack 代码。

标记语言约定（解析方式如此设计的原因）

• items_per_page 必须是 20、50、100 之一（表单自身 <select> 的选项）——任何其他值都会静默地显示零行，而不会报错。此 pack 始终请求能够覆盖调用方 limit 的最小有效页面大小，并在客户端进行切片。
• 字段提取仅限于对应行／案件／时间线条目的特定 HTML 块，绝不扫描整个页面——ftc.gov 会在案件自身内容之前渲染侧边栏和大型菜单块（例如“Latest Press Releases”），这些无关节点使用的 CSS 类名与案件内容完全相同。不限定范围的扫描会返回错误但看似合理的值（例如来自无关新闻稿的当天日期），而不是报错。
• 案件的“Type of Action”（Federal/Administrative/ProcessEnforcement）和“Case Status”会稳定地出现在搜索结果行中；案件详情页包含案件状态、最后更新日期、完整标题和联邦法院（仅联邦案件）。
• 文档日期仅取自案件的“Case Timeline”条目；单个时间线条目可能包含多个 PDF。

快速开始

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

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

此端点实际提供的内容

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

这是有意为之，并非意外复用。元工具让限定范围的连接能够回答此 pack 未涵盖的问题——通过可跨整个目录进行路由的 ask_pipeworx——无需添加第二个 MCP 服务。目前无法挂载不带这些元工具的 pack 端点；如果额外的 schema 带来的上下文成本超过了路由的价值，请只连接一次完整网关，而不是连接多个 pack 端点。

也可以连接完整的 Pipeworx 网关，直接列出每个 pack 的工具，而不仅是此 pack 的工具：

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

两个 URL 都连接到同一个网关和相同的 1879+ 个数据源。唯一的区别在于直接列出哪个 pack 的工具；无论使用哪个 URL，ask_pipeworx 都能访问所有工具。

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-ftc-enforcement

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Ftc Enforcement data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT