{
  "schema_version": "1.0",
  "a2a_compatible": false,
  "a2a_note": "这不是标准 A2A 服务器：没有 JSON-RPC task/send 端点，也没有 /.well-known/agent-card.json。本文件只是能力卡片，实际调用走 HTTP JSON 接口，见 openapi。",
  "name": "SOS A股 Agent Gateway",
  "description": "免注册、免密钥的 A 股当日盘面查询与事实核验接口。查返回真实盘面数据与出处、抓取时间；验判定一句话中的数字/个股/题材是否与当日真实数据一致；发只登记发布任务不执行。数据源不可用时返回错误，不编造、不回退旧值。",
  "url": "https://sos-a-share-gateway.pages.dev",
  "version": "1.0.0",
  "provider": {
    "organization": "SOS",
    "contact": "https://sos-a-share-gateway.pages.dev/tasks"
  },
  "protocols": [
    {
      "type": "http-json",
      "transport": "https",
      "base_url": "https://sos-a-share-gateway.pages.dev",
      "openapi": "https://sos-a-share-gateway.pages.dev/openapi.json",
      "auth": "none"
    }
  ],
  "capabilities": {
    "streaming": false,
    "push_notifications": false,
    "stateful_sessions": false,
    "auth_required": false,
    "rate_limit_header": false
  },
  "default_input_modes": ["text/plain", "application/json"],
  "default_output_modes": ["application/json"],
  "skills": [
    {
      "id": "a_share_market_today",
      "name": "今日真实盘面查询",
      "description": "返回最近交易日（北京时间）的涨停家数、跌停家数、连板家数、最高板、连板梯队、情绪温度与阶段、封板率、炸板率、晋级率、主线题材及家数、成交额、指数。带 data_date / data_stale / sources（url、抓取时间、延迟）。",
      "endpoint": { "method": "GET", "path": "/v1/market", "url": "https://sos-a-share-gateway.pages.dev/v1/market" },
      "input": { "params": "无" },
      "output": "application/json",
      "free": true,
      "verified": true,
      "verified_at": "2026-11-06"
    },
    {
      "id": "a_share_fact_verify",
      "name": "一句话事实核验",
      "description": "给一句话，逐条判定其中数字/个股/题材与当日真实盘面是 match、mismatch、unknown 还是 info，并返回原始依据（字段值、数据日期、来源 URL）。verdict 为 supported / partially_supported / contradicted / unverifiable。",
      "endpoint": { "method": "POST", "path": "/v1/verify", "url": "https://sos-a-share-gateway.pages.dev/v1/verify", "get_also": "GET /v1/verify?text=..." },
      "input": {
        "text": "string，1–2000 字，必填"
      },
      "output": "application/json",
      "free": true,
      "verified": true,
      "verified_at": "2026-11-06"
    },
    {
      "id": "publish_task_register",
      "name": "发布任务登记（不执行）",
      "description": "把内容登记成一条发布任务（微博/知乎/头条/淘股吧/雪球）。只入队，不执行发布；执行依赖运营方本机已登录浏览器。报价人工确认，无自动结算。",
      "endpoint": { "method": "POST", "path": "/v1/publish", "url": "https://sos-a-share-gateway.pages.dev/v1/publish" },
      "input": {
        "platform": "weibo | zhihu | toutiao | taoguba | xueqiu",
        "title": "string，可选，≤120 字",
        "content": "string，10–4000 字，必填",
        "requester": "string，可选，≤80 字"
      },
      "output": "application/json",
      "free": false,
      "pricing": "quote_required",
      "verified": true,
      "verified_at": "2026-11-06",
      "limitation": "公网不执行发布；本机关机就无法执行"
    }
  ],
  "auth": {
    "required": false,
    "scheme": "none",
    "note": "免注册、免密钥。可选 X-Agent-Source 请求头仅用于来源统计。"
  },
  "pricing": {
    "data_endpoints": "free",
    "publish_endpoint": "quote_required",
    "auto_settlement": false,
    "settlement": "manual",
    "note": "查/验免费；发只登记任务，人工确认报价后线下结算，无自动扣款、无虚拟余额。"
  },
  "data_freshness": {
    "coverage": "最近一个交易日（北京时间）",
    "fields": ["data_date", "data_stale", "session", "as_of_shanghai", "fetched_at"],
    "policy": "数据源不可用返回 502 upstream_unavailable；不回退旧值、不用缓存填充、不编造。data_stale=true 时必须向用户明示数据不是今日。"
  },
  "errors": {
    "format": { "ok": false, "error": { "code": "string", "message": "string", "details": "object?" } },
    "codes": [
      { "code": "invalid_request", "http": 400, "meaning": "参数不合法" },
      { "code": "method_not_allowed", "http": 405, "meaning": "方法用错" },
      { "code": "queue_full", "http": 429, "meaning": "发布队列已满（上限 300）" },
      { "code": "internal_error", "http": 500, "meaning": "网关内部异常" },
      { "code": "upstream_unavailable", "http": 502, "meaning": "盘面数据源不可用" },
      { "code": "storage_unavailable", "http": 503, "meaning": "服务端存储未绑定" }
    ]
  },
  "docs": {
    "llms_txt": "https://sos-a-share-gateway.pages.dev/llms.txt",
    "llms_full_txt": "https://sos-a-share-gateway.pages.dev/llms-full.txt",
    "openapi": "https://sos-a-share-gateway.pages.dev/openapi.json",
    "manifest": "https://sos-a-share-gateway.pages.dev/manifest.json",
    "home": "https://sos-a-share-gateway.pages.dev/"
  },
  "verification": {
    "endpoint": "https://sos-a-share-gateway.pages.dev/v1/stats",
    "metric": "external_calls 与 first_external_call_at",
    "note": "部署完成或页面可打开不算验证；只有真实外部调用才算。"
  },
  "limitations": [
    "只覆盖最近一个交易日；非交易日或上游未更新时 data_stale=true",
    "发布不在公网执行，依赖运营方本机登录态浏览器",
    "无自动结算、无账户体系、无鉴权",
    "调用计数基于 D1 单条 upsert，不宣称是计费级精确统计；来源标记为自声明，可能被伪造",
    "不构成投资建议，不提供交易、下单、推送能力"
  ]
}