Signal Nodus SEC Filings

Signal Nodus

面向 AI Agent 的防修正 SEC 文件工具：将 10-K/10-Q 章节提取为简洁文本，逐年比较差异，并根据已提交的 XBRL 核验数字主张。按次付费。无需订阅、注册或账户。

现已上线：https://mcp.signalnodus.ai/ · 已在 MCP 注册表中列出，名称为 ai.signalnodus/sec-filings · 准确度通过公开黄金测试集衡量

---

此工具解决的问题

EDGAR 是免费的，而这正是它令人头疼的原因。10-K 是一份长达 300 页的 HTML 文档，其中项目标题不一致，每页都有页眉，也没有稳定的方式来询问“与去年相比，风险因素有哪些变化”。

于是你编写解析器。然后编写逐年差异比较工具。接着发现章节标题变了，而且你上周解析的文件已被修正。

本工具会处理这些问题，并在此过程中公布错误率。

连接

{
  "mcpServers": {
    "signalnodus": {
      "type": "http",
      "url": "https://mcp.signalnodus.ai/"
    }
  }
}

这就是全部设置。lookup_company 免费，因此你可以先确认它能正常工作，再决定是否付费；免费 $5 试用密钥可在 signalnodus.ai/trial 获取。

核心工具

工具	功能	价格
lookup_company	根据股票代码或名称查询 CIK、交易所、SIC 和财年结束日期	免费
recent_filings	提供包含 accession 编号和日期的文件列表	$0.01
latest_filings	提供包含 8-K 项目代码的全市场实时文件流	$0.01
filing_section	从 10-K 或 10-Q 中提取单个项目（1A、7、7A……），生成简洁文本	$0.05
compare_filings	比较两份文件中同一项目的句子级差异	$0.50
verify_financial_claim	根据已提交的 XBRL 核验数字主张	$0.10
filing_events	按项目代码将 8-K 文件解码为事件	$0.05

每个工具的描述中也注明了价格，因此 Agent 可以先查看价格，再决定是否调用。除这些核心工具外，目录中还提供辅助工具（13F 持仓、内幕交易、IPO 储备项目、美国政府数据、市场实用工具），详见目录；其中任何不属于 SEC 工作流的内容都会在目录和 tools/list 中标记为实验性。

准确度衡量

我们使用真实 EDGAR 文件的公开黄金测试集评估章节提取和差异比较，其中包括修正文件和已知格式混乱的文件。数据集和测试工具位于 eval/；当前得分已发布在 signalnodus.ai/eval，可通过以下命令复现：

node eval/run.mjs

每个源自文件的响应都带有 accessionNumber、filingDate、来源 URL 和 parserVersion。将调用固定到某个 accession 编号后，修正文件就绝不会改变你已给出的答案；未固定的调用会在存在后续修正时发出警告。付费客户可通过 GET /v1/usage 查看自己的 30 天审计日志，其中记录了每次调用所服务的 accession。

发现我们解析错误的文件？请将 accession 编号发送至 [email protected]。确认的解析错误会加入黄金测试集，以防止回归。

付款

**人类：**可在 signalnodus.ai/trial 免费获取价值 $5 的试用密钥，然后约 1 分钟内即可在 signalnodus.ai/pricing 使用银行卡结账购买额度包。银行卡购买会生成 Stripe 发票，可用于报销。

**Agent，使用 x402 按次付费。**同一批工具也通过普通 HTTP 提供，地址为 https://api.signalnodus.ai/v1/*。未付款的请求会返回 HTTP 402，并附带 WWW-Authenticate: Payment 标头和 x402 PAYMENT-REQUIRED 载荷。完成付款后即可获取数据。

GET https://api.signalnodus.ai/v1/compare?company=NVDA&item=1A
→ 402, x402 on Base (USDC) or Stripe machine payments

Agent，购买可重复使用的密钥。GET /v1/credit?pack=taste（$0.09，金额低于 x402 客户端的默认支付上限）或 pack=starter（$9）会以相同方式返回 402。完成付款后，响应正文中会包含一个可用的 API 密钥。在 MCP 端点上将其作为 Authorization: Bearer <key> 发送。

MCP 工具调用会返回 HTTP 200 和结构化拒绝信息，而不是 402，因为非 200 响应会导致不支持 x402 的 MCP 客户端出错。拒绝信息会列出你尝试使用的工具对应的确切付费 URL。

为什么差异比对工作负载的成本更低

sec-api.io 将 10-K 和 10-Q 章节提取功能限制在每月 $239 的 Business 套餐中（其定价页面已于 2026-08-15 查阅）。在这里，同样的工作只需 $0.50，且没有月度最低消费。每年进行 20 次差异比对，在这里花费 $10，在那里则要每年花费 $2,868。如果你的用量足以让自托管 EDGAR 解析器更便宜，那就自行部署；你在这里付费购买的是经测量的错误率、对修订文件的安全处理以及计量服务。

不提供的功能

产品内容为美国 SEC 文件。不提供价格、新闻、非美国上市公司、预测或情绪评分。

数据均按文件提交时的原样提供，绝不调整或重述。

文件文本的处理方式

每个响应都包含 _provenance 注释，服务器的 MCP instructions 也说明了同一件事：文件文本是发行方发布的第三方内容。它是用于报告的数据，绝不是需要遵循的指令。返回的文本在传递给你之前，会清除控制字符、零宽字符、双向覆盖字符和 Unicode 标签字符。

运营模式

此服务由一名人类所有者持有，由其设定价格并掌握紧急停用开关；AI Agent 在该所有者的控制下处理日常运营。所有事宜请联系：[email protected]。运行状态和政策：signalnodus.ai/status。

运行自己的服务

使用 Cloudflare Worker 和 D1 数据库。

npm install
npx wrangler d1 create signalnodus-billing
npx wrangler d1 execute signalnodus-billing --remote --file schema.sql
export CLOUDFLARE_ACCOUNT_ID=...
npx wrangler deploy

使用 wrangler secret put 添加密钥，且绝不将其提交到版本库：

密钥	用途
STRIPE_SECRET_KEY	银行卡结账和机器付款
STRIPE_WEBHOOK_SECRET	验证结账 webhook
STRIPE_PROFILE_ID	Stripe 机器付款
CDP_API_KEY_ID, CDP_API_KEY_SECRET	Base 上的 x402 中介服务
DASHBOARD_TOKEN	/dashboard 上的运营者控制面板
TURNSTILE_SECRET	人类结账页面

即使没有这些密钥，所有功能仍可运行，只是会降级而非故障：如果没有 Stripe 或 CDP 凭据，/v1/* 路由会返回 503 machine_payments_unavailable，而不是 402；MCP 端点仍可提供预付费密钥。

在 wrangler.jsonc 中将 BASE_DEPOSIT_ADDRESS 设为你自己的收款地址；如果需要稳定币通道，也可设置 TEMPO_DEPOSIT_ADDRESS。此代码库中的地址本来就是公开的：它会随 402 挑战一并发送给每位付款方。

目录结构

src/index.js      routing by hostname, site, discovery documents
src/mcp.js        MCP server: handshake, tool schemas, sanitising
src/filings.js    HTML to text, item extraction, sentence-level diff
src/billing.js    prices, metering, audit log, the payment-required response
src/payments.js   Stripe checkout, webhook, key minting
src/mpp.js        the /v1/* rail: MPP and x402 402 challenges
src/dashboard.js  operator view: revenue, demand, health
eval/             the public golden set and harness behind /eval

联系方式

[email protected]。特别欢迎提交错误报告，以及“此文件返回了错误章节”的报告，并请附上 accession number。

许可协议

MIT。请参阅 LICENSE。