jsonshelf

面向 AI 智能体的确定性 JSON 修复、验证、示例生成和模式强制转换工具。 无需 LLM 调用。延迟低于 10 毫秒。单次调用成本 0.0005 美元。仅限智能体使用。

实时端点： https://jsonshelf.vercel.app/

curl https://jsonshelf.vercel.app/ 返回完整的机器可读清单。无 HTML。无需人工干预。

功能说明

四种工具，全部为纯计算，100% 确定性：

每个错误响应都包含 { error, code, message, fix, docs, http_status } —— 智能体无需猜测。

发现（无需人工干预）

• GET /.well-known/ai-plugin.json — OpenAI 插件清单

• GET /.well-known/mcp.json — MCP 服务器清单

• GET /llms.txt — 机器可读文档

• GET /openapi.json — OpenAPI 3.1 规范

• GET /v1/pricing — 机器可读定价

• GET /v1/errors — 完整错误目录

认证

# 1. Issue a key (100 free credits)
curl -X POST https://jsonshelf.vercel.app/v1/keys

# 2. Use the key
curl -X POST https://jsonshelf.vercel.app/v1/repair \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"input":"{name:\"alice\", skills:[\"code\",]}"}'

计费

预付费额度。单次 POST 请求返回一个支付 URL，智能体可自动跳转完成支付：

curl -X POST https://jsonshelf.vercel.app/v1/credits \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"pack":"starter"}'

返回 { payment_url, x402: { ... } }。协议兼容的客户端会发出 x402 标头。

MCP

通过 https://jsonshelf.vercel.app/mcp 使用 HTTP（JSON-RPC 2.0，协议版本 2024-11-05）。包含四种工具：jsonshelf_repair、jsonshelf_validate、jsonshelf_example、jsonshelf_coerce。

许可证

Apache 2.0。