{
  "schema_version": "1.0",
  "updated_at": "2026-11-06T14:12:54.160Z",
  "agent": {
    "id": "sos-a-share-agent",
    "name": "SOS A股复盘与内容执行 Agent",
    "version": "0.1.0",
    "owner": "SOS",
    "summary": "提供 A 股单交易日结构化复盘数据、连板天梯查询、带事实闸门的内容生成，以及微博/知乎/头条/淘股吧/雪球五平台的人工确认式发布执行。",
    "availability": "public_read_and_submit",
    "availability_note": "公网入口 https://sos-a-share-gateway.pages.dev 可读能力清单/任务列表、可提交任务；发布执行仍只能在本机（需已登录浏览器），本机关机则无法执行。MCP stdio 服务无法运行在 Pages 上，仅在本地可用。"
  },
  "protocols": [
    {
      "type": "mcp",
      "name": "sos-a-share-gateway",
      "transport": "stdio",
      "command": "node",
      "args": [
        "agent-gateway/mcp-server.js"
      ],
      "protocol_version": "2024-11-05",
      "tools": [
        "get_daily_review",
        "get_lianban_ladder",
        "get_market_sentiment",
        "submit_publish_task",
        "list_capabilities"
      ],
      "local_only": true,
      "public_note": "stdio 传输，只能在调用方本机运行，公网不提供。"
    },
    {
      "type": "http",
      "name": "sos-a-share-gateway-public",
      "base_url": "https://sos-a-share-gateway.pages.dev",
      "endpoints": {
        "home": "GET /",
        "manifest": "GET /manifest.json",
        "llms_txt": "GET /llms.txt",
        "openapi": "GET /openapi.json",
        "agent_card": "GET /agent-card.json",
        "market": "GET /v1/market",
        "verify": "POST /v1/verify（也支持 GET /v1/verify?text=...）",
        "publish": "POST /v1/publish",
        "stats": "GET /v1/stats",
        "tasks": "GET /tasks",
        "task_detail": "GET /tasks/:id",
        "submit_task": "POST /tasks"
      },
      "local_only": false,
      "limits": [
        "查/验返回真实数据并带 data_stale / 抓取时间；数据源不可用返回错误，不回退旧值",
        "发只登记任务，不执行发布；发布依赖本机登录态浏览器",
        "无自动结算、无账户体系、无鉴权"
      ]
    }
  ],
  "capabilities": [
    {
      "id": "a_share_daily_review",
      "name": "A股单交易日结构化复盘查询",
      "status": "verified",
      "verified_at": "2026-11-06",
      "description": "返回最近交易日的指数涨跌、涨停/跌停/连板家数、封板率、炸板率、涨跌家数、成交额、情绪温度与阶段、主线题材及龙头。数据取自公开接口，逐字段透传，不做二次加工。",
      "input": {
        "date": "YYYY-MM-DD（可选；公开数据源只提供最近交易日）"
      },
      "output": "JSON，含 data_date / data_stale / indices / kpi / mainlines / source{fetched_at,url,latency_ms}",
      "evidence": "本机实测：https://lianban.pages.dev/api/stocks/review 返回 200，data_date=2026-11-05",
      "limitation": "公开接口只提供最近一个交易日；非交易日返回上一交易日并标记 data_stale=true"
    },
    {
      "id": "a_share_lianban_ladder",
      "name": "连板天梯（2板及以上）查询",
      "status": "verified",
      "verified_at": "2026-11-06",
      "description": "按板高分组返回连板个股：代码、名称、板高、价格、涨幅、成交额、封单、首封时间、开板次数、题材、涨停原因。",
      "input": {
        "min_days": "最低板高，默认 2",
        "limit": "最多返回条数，默认 60，上限 200"
      },
      "output": "JSON，含 ladder[]（按板高降序）/ days[] / promote / relay / source",
      "evidence": "本机实测：https://lianban.pages.dev/api/stocks/tianti 返回 200，data_date=2026-11-05，共 84 条涨停明细",
      "limitation": "数据源不可用时直接报错，不用缓存或推测值填充"
    },
    {
      "id": "content_generation_fact_gate",
      "name": "内容生成 + 事实闸门",
      "status": "verified_local",
      "description": "基于当日真实数据包生成平台文案，并在输出前过事实闸门：无来源的数字、未在白名单的股票代码/个股名会被整句删除并返回移除清单。",
      "input": {
        "platform": "weibo | zhihu | toutiao | taoguba | xueqiu",
        "angle": "可选"
      },
      "output": "正文 + 事实闸门移除清单",
      "evidence": "代码：src/lib/content-engine.ts、src/lib/fact-gate.ts；已产出 data/weekly-content-1031.json 等真实内容文件",
      "limitation": "需要本机 Next.js 服务与 LLM Key（.env.local 已配置），不是独立 SaaS 接口"
    },
    {
      "id": "multi_platform_publish",
      "name": "五平台发布执行（人工确认）",
      "status": "verified_local",
      "description": "微博、知乎、今日头条、淘股吧、雪球，通过本机已登录浏览器执行发布，发布后做页面可见性校验并留存截图。",
      "input": {
        "platform": "平台名",
        "task_id": "内容任务 ID",
        "human_approval": "必须为 true"
      },
      "output": "发布结果 + 页面校验结果 + 截图路径",
      "evidence": "data/jobs.json 记录：微博/知乎/头条/淘股吧/雪球均有真实 success 记录（最近一次微博 2026-11-03T01:17:38Z）",
      "limitation": "依赖本机浏览器登录态，无法在无登录态的服务器上执行；已有多个 failed 记录，失败原因会如实返回"
    }
  ],
  "data_sources": [
    {
      "id": "lianban_public_api",
      "url": "https://lianban.pages.dev/api/stocks/",
      "access": "read_only",
      "note": "只读调用，不写入、不修改该站点；不可用时直接返回错误，不回退任何旧值或本地缓存"
    }
  ],
  "pricing": {
    "currency": "CNY",
    "model": "per_task_quote",
    "auto_settlement": false,
    "settlement": "manual",
    "settlement_note": "暂不支持自动结算：任务需运营方人工确认报价与交付后，线下人工转账。不设虚拟账本、不承诺自动打款。",
    "quote_status": "pending_owner_confirmation",
    "quote_note": "各任务单价尚未由运营方确认，接口返回 amount=null 与 mode=quote_required，确认前不接单、不收费。"
  },
  "task_endpoint": {
    "list": "https://sos-a-share-gateway.pages.dev/tasks",
    "submit": "POST https://sos-a-share-gateway.pages.dev/tasks",
    "schema": {
      "platform": "weibo | zhihu | toutiao | taoguba | xueqiu",
      "title": "string，可选",
      "content": "string，至少 10 字",
      "requester": "string，可选"
    }
  },
  "contact": {
    "method": "http_task_submit",
    "endpoint": "https://sos-a-share-gateway.pages.dev/tasks",
    "note": "暂无公开邮箱/即时通讯账号；请通过任务接口提交需求，运营方人工回复。公网入口：https://sos-a-share-gateway.pages.dev/tasks",
    "human_reply_sla": "未知（人工处理，不作承诺）"
  },
  "constraints": [
    "不提供任何编造数据：数据源失败时返回错误，不用假数据填充",
    "不展示虚假在线数、虚假成交量、虚假用户数",
    "不做自动打款、不记虚拟余额；结算一律人工",
    "对外发布默认不带任何网址，除非委托方明确要求",
    "不自动发布：所有发布任务需人工确认后执行"
  ],
  "public_url": "https://sos-a-share-gateway.pages.dev",
  "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",
    "agent_card": "https://sos-a-share-gateway.pages.dev/agent-card.json",
    "manifest": "https://sos-a-share-gateway.pages.dev/manifest.json",
    "human_home": "https://sos-a-share-gateway.pages.dev/"
  },
  "endpoints": {
    "market": {
      "method": "GET",
      "path": "/v1/market",
      "url": "https://sos-a-share-gateway.pages.dev/v1/market"
    },
    "verify": {
      "method": "POST",
      "path": "/v1/verify",
      "url": "https://sos-a-share-gateway.pages.dev/v1/verify",
      "get_also": "GET /v1/verify?text=..."
    },
    "publish": {
      "method": "POST",
      "path": "/v1/publish",
      "url": "https://sos-a-share-gateway.pages.dev/v1/publish"
    },
    "stats": {
      "method": "GET",
      "path": "/v1/stats",
      "url": "https://sos-a-share-gateway.pages.dev/v1/stats"
    },
    "tasks": {
      "method": "GET",
      "path": "/tasks",
      "url": "https://sos-a-share-gateway.pages.dev/tasks"
    },
    "submit_task": {
      "method": "POST",
      "path": "/tasks",
      "url": "https://sos-a-share-gateway.pages.dev/tasks"
    }
  },
  "auth": {
    "required": false,
    "scheme": "none",
    "note": "免注册、免密钥。可选的 X-Agent-Source 请求头仅用于来源统计，不参与鉴权。"
  },
  "pricing_public": {
    "data_endpoints": "free",
    "publish_endpoint": "quote_required",
    "auto_settlement": false,
    "note": "查/验两类接口免费且无需密钥；发只登记任务，人工确认报价后线下结算，无自动扣款。"
  },
  "limitations": [
    "公网入口只收任务、返回数据，不执行发布；发布依赖本机已登录浏览器，本机关机就执行不了。",
    "没有自动结算：结算方式为人工转账，任务金额在运营方确认前为 null。",
    "没有任何\"外部 Agent 已接入\"的证据；部署完成不等于有用户或调用量。",
    "数据只覆盖最近一个交易日（公开数据源限制），非交易日会标记 data_stale=true。",
    "数据源不可用时返回 502/503 错误，不回退旧值、不用缓存填充、不编造。",
    "调用计数只统计本网关的真实 HTTP 调用，内部自测与外部来源靠自声明请求头区分。"
  ],
  "verification_metric": {
    "endpoint": "https://sos-a-share-gateway.pages.dev/v1/stats",
    "description": "唯一有效的验证指标：外部来源真实调用次数与首次调用时间。内部自测不计入 external_calls。",
    "note": "部署完成、页面可打开都不算验证；has_external_calls 为 false 时即表示尚无外部 Agent 调用。"
  }
}