Texas Ag Opinions

@pipeworx/texas-ag-opinions

自 1939 年以来的德克萨斯州总检察长意见：按编号查询具体意见（全文、请求人、引用的法规），检查该意见是否有记录在案的推翻／修改／确认／撤回状态，并按法规引文搜索该状态索引。

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

工具

• tx_ag_opinion_lookup(opinion_number) — 总检察长、日期、请求人、RQ- 请求编号、主题类别、一句话摘要、意见全文，以及从中找到的法规引文（使用基于意见 PDF 的尽力而为正则表达式提取）。 还会包含该意见自身后续处理状态（如果有）。
• tx_ag_opinion_status(opinion_number) — 查询总检察长自己的便民索引中是否有特定意见的推翻／修改／确认／取代／撤回记录。not_listed 并不表示该意见仍是有效法律 — 总检察长自己的页面说明，该列表可能不完整。
• tx_ag_statute_search(citation) — 在约 381 条有后续处理记录的意见中，搜索提及指定法规引文或关键词的意见。功能有限 — 有关具体涵盖范围，请参阅下文“数据来源”。

认证

无需密钥。

数据来源

• https://www.texasattorneygeneral.gov/opinions — 着陆页列出了自 1939 年以来的全部 16 位总检察长及其确切的意见编号范围（例如“GA-0001 - GA-1096”）。该页面于 2026-10-07 抓取一次，数据存入 src/index.ts 中的 TX_AG_RANGES — tx_ag_opinion_lookup 和 tx_ag_opinion_status 据此将裸编号对应到正确的总检察长 slug，无需猜测。
• https://www.texasattorneygeneral.gov/opinions/{ag-slug}/{number} — 单条意见的专属页面（例如 /opinions/ken-paxton/kp-0537）：总检察长姓名、主题类别、一句话摘要，以及意见 PDF 链接。实时获取，绝不预先打包。
• https://www.texasattorneygeneral.gov/sites/default/files/opinion-files/opinion/{year}/{number}.pdf — 意见全文。已确认文本可直接读取（而非扫描件）：extractPdfText（shared/src/pdf-text.ts）可在无任何警告的情况下清晰解析。请求人姓名／职务／地址、RQ- 请求编号、问题的一句话表述，以及引用的法规均通过正则表达式从文本中提取 — 尽力而为，并非真正的引文解析器（类似“§§ 51.031, .034”的多条文引文仅会提取第一条；不会提取非“ TEX. ... CODE §”格式的引文，例如引用联邦法律或使用“Art.”而非“§”的引文）。
• https://www.texasattorneygeneral.gov/opinions/opinions-overruled-modified-affirmed-withdrawn — 单个页面列出了总检察长意见委员会标记为后来被推翻、修改、确认、取代或撤回的全部意见（381 条，数据于 2026-10-07 获取），并附有引用该意见的法规或案件。数据打包在 src/tx-ag-status-data.ts 中（约 38 KB — 远低于需要通过 KV 打包的几十万 KB 阈值，因此仍作为普通的模块作用域导入，不同于表格大得多的州法典数据包）。该索引为 tx_ag_opinion_status 和 tx_ag_statute_search 提供数据支持。

本工具包无法做到的事情及原因

不带 AG slug 的 /opinions/{number} 是个陷阱。 对任何编号，无论真实还是虚构，它都会返回 HTTP 200 — 已在线验证：真实意见（kp-0537）和虚构意见（kp-9999）返回的内容字节数完全相同，因为不带 slug 的路径是一个通用的“ajax-individual-opinion”表单占位页，显示“URL 中的 Attorney General 名称无效”，而不是意见内容。正确包含 AG slug 的路径遇到错误编号时会正确返回 404。本工具包始终先从 TX_AG_RANGES 中解析 AG slug，绝不会请求不带 slug 的路径。

无法对整个档案（约 19,000 篇意见，可追溯至 1939 年）进行全文法条引文搜索。 网站自己的意见搜索框是一个 Cludo 小部件（api-us1.cludo.com，customerId 10000129，engineId 10001310），它会在签名 API 调用后完全通过客户端渲染搜索结果 — 已在线确认：尝试的每种调用形式（GET、POST，以及带或不带 Origin 和 Referer 标头）都会返回 401 {"Message":"Authorization has been denied for this request."}。tx_ag_statute_search 只会在预先整理好的被推翻／修改／维持／撤回索引（381 篇意见）中搜索引文或关键词；这些词必须出现在描述哪些内容取代了该意见的文本中 — 适用于“这篇意见是否已被后续法令推翻”，而不适用于一般性的“哪些意见讨论了这条法令”。该工具的每个响应都会在 coverage_note 字段中说明此限制。

负载较高时会遇到 Cloudflare JS 验证。 网站由 Cloudflare 防护；在约 15 次快速连续抓取后，它曾对本工具包自己的一个研究请求返回“请稍候……”验证页面（而非真实内容）。两个实时抓取工具都会检测这种情况（isCloudflareChallenge），并抛出明确的 upstream_down: 错误指出问题，而不是把验证页面误当作真实内容静默解析。

快速开始

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

{
  "mcpServers": {
    "texas-ag-opinions": {
      "url": "https://gateway.pipeworx.io/texas-ag-opinions/mcp"
    }
  }
}

此端点实际提供的内容

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/tx_ag_opinion_lookup \
  -H 'Content-Type: application/json' \
  -d '{"opinion_number":"KP-0537"}'

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

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

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

{
  "mcpServers": {
    "texas-ag-opinions": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-texas-ag-opinions"]
    }
  }
}

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

npx -y @pipeworx/mcp-texas-ag-opinions

它通过 stdin/stdout 使用 MCP，并且仅针对本工具包的工具响应 initialize/tools/list/tools/call — 不包含上述网关连接添加的任何通用元工具。相同的源代码、相同的工具，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Texas Ag Opinions data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT