Arkansas Opinions

@pipeworx/arkansas-opinions

来自 Arkansas Judiciary 官方意见档案的 Arkansas Supreme Court 和 Arkansas Court of Appeals 最新意见——包括中性引注、案件名称、裁决日期、案卷号、撰写人、裁决结果、全文及每次已发布的修订；收集范围为 2026-01-01 起的裁决，每小时收集一次。Fleet #2924。

属于 Pipeworx — 一个将 AI Agent 连接到 1784+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方没有关联，也未经其认可或发布。

之所以创建此工具，是因为 court-listener 工具包所依赖的 CourtListener 数据落后 Arkansas 法院数月：截至 2026-10-10，其最新的 Arkansas Supreme Court 意见为 2026 Ark. 114（2026-06-11），而法院已发布至 2026 Ark. 144（2026-10-08）。较早的 Arkansas 判例法仍由 court-listener 提供；其 lookup_citation 现在会在 CourtListener 缺少 YYYY Ark. N / YYYY Ark. App. N 引注时，转而查询此工具包。

工具

• ark_recent_opinions(court?, since?, limit?, include_syllabi?) — 按时间从新到旧列出意见，可指定一家法院（"supreme"、"appeals"）或两家法院，也可选择起始日期。回答“本周 Arkansas Supreme Court 裁决了什么”。
• ark_opinion(citation | item_id, version?, max_chars?) — 根据中性引注（"2026 Ark. 140"、"2026 Ark. App. 449"，拼写可宽松匹配）或档案条目 ID 查询单条意见：元数据、全文、引注状态及版本历史。version 可返回较早修订版的文本。
• ark_search_opinions(query, court?, date_after?, date_before?, limit?) — 对案件名称、引注和意见文本进行全文搜索（SQLite FTS5，porter 词干提取），并为每条结果提供高亮片段。引用短语可精确匹配；如果没有意见包含所有词语，工具会改用任意词匹配并说明这一点（matched: "any_term"）。
• ark_coverage() — 按法院提供：意见数量、最早和最新裁决日期、每年最低和最高引注编号、发布后修订过的意见数量、最近一次成功收集的时间，以及回填状态。在认为某条记录确实不存在之前，请先调用此工具。

每条响应都包含 source（"Arkansas Judiciary, official opinions archive"）和 data_as_of（收集器最近一次成功完成运行的时间）。每条意见还包含 source_url，即该意见在法院网站上的原始页面，可用于核对文本。

版本

意见发布后可能会有编辑性更正，档案会将其标记为已更新。收集器会重新读取已标记的意见；当其文本或元数据哈希与当前版本不同时，新文本会成为当前版本，并保留先前版本。ark_opinion 会列出每个版本的检索时间、SHA-256、长度和原因（first_fetch、source_updated）。重新读取后若没有变化，则不会添加新版本。

引注状态

仅根据来源明确说明的内容记录；每条意见都包含 citation_status + citation_status_note：

• neutral_citation_assigned — 法院已指定中性引注，且文本中没有“not designated for publication”（未指定公开发表）标记。除此之外不作任何推断；来源没有说明其先例效力。
• unpublished — 文本说明该意见未指定公开发表。应视为引注受限，绝不可作为先例。
• no_citation_assigned — 没有引注的意见摘要、命令或通知。
• not_yet_read — 法院已列出该意见，但尚未读取文本（通常发生在一小时内）；读取之前不得引用。

身份验证

调用方无需密钥。工具只通过 Pipeworx 网关提供响应：意见从收集器填充的数据库中读取；因此，单独执行 npm install 不会获得数据，所有工具都会明确抛出“not bound in this runtime”（在此运行时未绑定）错误，而不是返回空列表。

数据源

• Arkansas Judiciary 官方意见档案——Arkansas Supreme Court 和 Court of Appeals 的意见及其元数据（法院、日期、中性引证、案号、撰写人、意见类型、县、审期、裁决结果、协同意见和异议意见法官）和全文。每小时检查一次；收录 2026-01-01 起的裁决。

Arkansas 法院的意见属于政府作品，归公众所有。

给下一位维护者的说明：

• 该档案会根据来源 IP 应用不同的机器人检查。2026-10-10，同一个真实的 User-Agent 从笔记本电脑发起请求时遇到了检查，而从 Cloudflare 网络发起时则成功通过，因此采集器以 Cloudflare Worker 定时任务的方式运行。它不会尝试通过检查，也不会更改身份；遇到检查时会停止运行，并在 ark_coverage().last_collection_attempt 中显示为 captcha_wall。采集器读取档案的方式记录在 workers/ark-opinions-collector 中。
• 对于 2026-01-01 之前裁决、但由档案重新发布的意见，交由 court-listener 处理。
• 两个法院都会每日发布一份摘要文件；Court of Appeals 还会发布“无意见”通知。这些文件会以 document_kind: "syllabus" / "no_opinion_notice" 保存，且不会包含在 ark_recent_opinions 中，除非设置 include_syllabi: true。
• 存储：Cloudflare D1 数据库 pipeworx-ark-opinions，绑定到网关时使用 ARK_OPINIONS_DB（pack-manifest.json 中的 d1Binding）。架构：workers/ark-opinions-collector/src/schema.ts。

快速开始

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

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

此端点实际提供的内容

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

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接回答该包未涵盖的问题——通过 ask_pipeworx 路由到整个目录——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的包端点；如果额外的 schema 占用的上下文比路由功能带来的收益更大，请连接一次完整网关，而不是连接多个包端点。

或者连接完整的 Pipeworx 网关，直接列出所有包的工具，而不只是此包的工具：

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ark_recent_opinions \
  -H 'Content-Type: application/json' \
  -d '{"court":"supreme","limit":5}'

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

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

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

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

或者直接运行，确认它能够启动：

npx -y @pipeworx/mcp-arkansas-opinions

它通过 stdin/stdout 使用 MCP 通信，并为仅此包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接添加的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT