Company filing and CVE evidence snapshots

公司申报和 CVE 证据快照

免费的实验性能力范围。可用性受保守的成本和来源健康状况控制；请遵守 Retry-After，并留意明确标注的覆盖缺口。

面向两类有限公开信息查询的免费 Phase A JSON API：

• **company_snapshot：**用于查询已知股票代码对应的当前 SEC 申报事件状态。返回发行人/CIK、申报日期和来源链接，并明确标注来源时间戳、覆盖范围和过期时间。此功能不提供财务报表提取、财报电话会议记录或广泛的股票研究。GET /v1/company/{ticker}。最新申报可能是内部人申报；不一定是财报发布。
• **cve_snapshot：**用于查询已知 CVE ID 的当前证据。返回 NVD 状态、是否列入 CISA KEV、FIRST EPSS 和公告链接，并明确标注来源时间戳、覆盖范围和过期时间。此功能不评估资产适用性，也不提供经验证的修复建议。GET /v1/cve/{cve}。

基础 URL：Fishnet

OpenAPI · MCP 工具说明 · 机器可读概览

常规使用示例：

curl 'https://agent-research-fishnet.walsh-datascience.workers.dev/v1/company/AAPL?via=github'
curl 'https://agent-research-fishnet.walsh-datascience.workers.dev/v1/cve/CVE-2024-3094?view=status&via=github'

使用 view=status 获取精简的选定事实。保存 facts.state_hash；稍后将其作为 changed_since=sha256:... 与 view=status 一起提交，以比较选定状态。这是哈希比较，不是按历史时间戳查询。方法变更也会改变状态哈希。请查看覆盖范围和来源时间戳；证据不可用时，比较结果将返回未知。公司数据包的有效期最长为 15 分钟，CVE 数据包最长为 60 分钟，实际有效期可能更短。max_age_seconds 用于声明可接受的新鲜度，不会强制刷新来源。

数据包包含 packet_key、生成/基准时间/过期时间戳、来源版本、覆盖缺口，以及数据/方法/结果/条款哈希。精简响应还包含不依赖基线的 packet_version。这些只是浅层元数据观察结果，并非独立的第二意见服务，也不保证研究完整。

无需付款、钱包、API 密钥或个人标识符。可选的不透明 X-Fishnet-Operator、X-Fishnet-Client 或 X-Fishnet-Agent 值会生成每日轮换的 HMAC 信号。系统会记录请求键/时间、缓存状态、粗粒度框架/渠道、状态、延迟和成本单位。应用遥测不会保留 IP、原始用户代理、原始引荐来源或原始调用方 ID。信号无法证明操作者彼此独立。原始事件保留 14 天，并在有活跃流量时清理；Cloudflare 有自己的基础设施数据政策。

集成测试期间请使用 X-Fishnet-Test: true。这项免费实验设有每日构建预算和可用性限制；409/429/503 响应会说明新鲜度、预算或可用性方面的缺口。请遵守 Retry-After。某些大型 SEC 申报文件响应超过 4 MiB 来源限制，因此仍不可用。汇总安全核算会统计请求次数、保守 CPU 预留量，以及可用的 D1 行数/存储指标，且不包含个人标识符。因安全检查而被拒绝的请求不计为成功需求证据。可用性属于实验性质。SAM、FDA 和支付功能均已停用。

可选需求线索：desired_fields 接受 OpenAPI 中列出的字段名称；history_days 接受 0/1/7/30/90/365/3650；max_age 接受 60/300/900/3600/86400 秒；compare_sources 接受 true/false。这些参数用于声明所需内容，不会创建新数据。不支持的受控历史记录/字段/比较会返回 HTTP 422 unsupported_capability，并提供可用的当前状态能力及可选反馈操作。系统绝不会保留任意路由/查询参数；可识别的不支持请求会归并为粗粒度类别。 可选反馈：还有哪些数据或能力可以减少你下一次工具调用？ 成功的数据包会提供 feedback_request，其中包含有时效限制且绑定到数据包的令牌、必需的数据包密钥／版本／端点，以及列出未来可能具备的能力的 research_candidate 菜单。这些候选项不是现有产品。向 POST /v1/feedback 发送 schema 2.0，或明确调用可选的 submit_fishnet_feedback MCP 工具。请包含 feedback_type，并可选填写 next_action_without_fishnet、usage_reason、期望的能力／字段／历史记录／时效性、重要程度或所述的使用频率／价格。仍支持 V1 HTTP 客户端。请使用提供的数据包版本，不要重建哈希。令牌仅证明与数据包的关联，不代表调用方彼此独立，也不证明底层数据的新鲜度。

上限为 2,048 个 JSON UTF-8 字节和 240 个 UTF-8 文本字节；不得包含个人数据、URL、机密或完整提示词。不安全文本会被拒绝；已接受的自由文本会被分类后丢弃，不予存储。受控反馈字段会单独存储 14 天，并主动清理；调用方信号使用相同的每日 HMAC。重复提交会消耗配额。限额：每天总计 100 次，每个可选信号 10 次，匿名共享 20 次。反馈以及所述的使用频率／价格均为自述，不代表购买或已验证的需求。可选反馈不会自动触发，也不会导致构建相关能力。不提供反馈也不影响使用核心数据包。

MCP：version 0.2.0 MCPB release，Node.js 22+，stdio 传输。包含两个快照工具和可选的反馈提交功能；除下方远程 URL 外，也可选用本地捆绑包。反馈工具会写入有界遥测数据，并明确对此作出标注。之前的 0.1.0 版本仍可用。

远程 MCP — 无需本地安装 Fishnet

使用 Streamable HTTP 连接到 **https://agent-research-fishnet.walsh-datascience.workers.dev/mcp**。匿名免费使用 Phase A，无需 API 密钥或钱包。兼容的客户端仍需知道或发现该 URL，并授权或配置访问权限。发布到注册表并不意味着可以自动发现或选择工具。

工具：company_snapshot、cve_snapshot，以及明确可选的 submit_fishnet_feedback。快照参数和数据包语义与 REST API 完全相同。反馈会写入遥测数据，不是只读操作，也不具备幂等性，且绝不会自动运行。

协议 2026-07-28 使用每个请求的元数据（io.modelcontextprotocol/protocolVersion、clientInfo、clientCapabilities），以及与之匹配的 MCP-Protocol-Version、Mcp-Method，对于 tools/call 请求还包括 Mcp-Name 标头。server/discover 是可选的；可以直接调用 tools/list 或使用已知架构调用 tools/call。无状态旧版协议 2025-11-25 和 2025-06-18 支持 initialize → notifications/initialized → tools/list → tools/call。请求使用 Content-Type: application/json 和 Accept: application/json, text/event-stream；结果为 JSON。

不会创建会话；不支持 GET/DELETE 流、资源、提示词、订阅、批处理、采样和扩展方法。无 Origin 的服务端客户端可以正常使用。浏览器的 Origin 必须与服务源完全匹配；不支持通配符 CORS。RPC 请求体最大为 4,096 UTF-8 字节，嵌套深度为 12，读取请求体的时间为 5 秒；反馈的限制更小。拒绝请求不会触发源构建。

一次 MCP HTTP 请求计为一次交互。粗略路由、协议系列、阶段、工具和结果会保留在现有的 14 天事件流中。不会存储 RPC ID、原始 clientInfo、Origin、原始请求体／路径／查询参数或提示词。有限的诊断信息包括精确的受支持协议版本、粗略的自报客户端系列、已识别的能力标记、是否存在跟踪上下文、目录版本、工具选择类别和参数形状类别。不会保留跟踪值或客户端版本；这些类别不能用于验证客户端身份或关联会话。HTTP 200 携带 isError: true 表示应用错误，并非有效的数据包使用。底层覆盖范围／数据源缺口仍会明确显示。请遵守错误提示并退避；全局安全限制可能会暂停服务。传输层特定故障会禁用远程 MCP；只要记账功能正常，REST 仍可用。

官方 Registry 发布版 0.3.0 新增了远程地址，并保留未更改的 0.2.0 stdio MCPB。不会覆盖任何现有发布版。