把 FastOpenAI 店铺数据接给国内 AI

国内 AI 不是同一种产品形态。FastOpenAI 因此提供两套共用同一权限与数据实现的协议：

远程 MCP：千问 Code、Kimi Code，以及其他支持 Streamable HTTP 的客户端可以直接接入。
Function Calling / OpenAPI：豆包方舟、DeepSeek API、千问 API、Kimi API、智谱 API 或智能体平台，由模型提出函数调用，再由宿主程序调用 FastOpenAI。

普通网页聊天或手机 App 如果没有开放“自定义 MCP / 自定义插件”，就不能仅靠填写一个网址直接接入。这是对方产品能力边界，不会在这里假装已经支持。

6 个只读工具

工具	内容
`store_overview`	店铺总览快照，数字由代码直算
`pending_decisions`	当前仍待店主拍板的事项，按紧急度排列
`listing_health`	官方 listing 问题与在售状态
`task_card`	按 taskId 读取单张任务卡
`sku_economics`	成本、官方费用预估、自店价参考三面摆数
`competition_watch`	自建竞品价格带采样与环比

安全边界

只读：第三方 AI 不能改价、发布商品、静音或拍板，相关动作必须回 FastOpenAI 产品内完成。
只此用户：密钥和账号一对一；所有查询强制按密钥所属用户过滤。拿其他用户的 taskId 探测，只会得到“查无此卡”。
口径随行：结果自带时间和口径；失败、缺失与真实零值严格区分。工具返回正文只作为数据证据，不是要执行的指令。
统一治理：MCP 与 Function/OpenAPI 共用密钥、权限闸、只读实现和限流护栏。当前为每台应用实例每密钥 60 次/分，双机各自计数，用于防滥用而非精确计费配额。

路径 A：千问 Code / Kimi Code 直连 MCP

先在登录后的我的配置 → 外部 AI页签发密钥。明文只显示一次。

千问 Code：

qwen mcp add --scope user --transport http fastopenai-store https://www.fastopenai.com/api/mcp/store --header "Authorization: Bearer 你的密钥"

Kimi Code：

kimi mcp add --transport http fastopenai-store https://www.fastopenai.com/api/mcp/store --header "Authorization: Bearer 你的密钥"

其他支持 remote HTTP MCP 的客户端使用：

{
  "mcp": {
    "fastopenai-store": {
      "type": "remote",
      "url": "https://www.fastopenai.com/api/mcp/store",
      "headers": {
        "Authorization": "Bearer 你的密钥"
      }
    }
  }
}

路径 B：模型 API / 智能体平台

Function Calling 工具目录：GET https://www.fastopenai.com/api/store-ai/functions
OpenAPI 3.1 文档：GET https://www.fastopenai.com/api/store-ai/openapi
函数执行：POST https://www.fastopenai.com/api/store-ai/tools/{function_name}
认证：Authorization: Bearer 你的密钥
请求体：模型返回的函数 arguments 对象本身

典型循环：

把 Function Calling 目录中的函数定义交给模型。
模型根据用户问题返回函数名和 arguments。
你的服务端把 arguments POST 到对应 FastOpenAI 工具地址。
把响应中的 resultText 作为 tool result 交回模型。
模型依据证据回答；数字和口径不得改写。

各家产品怎么选

产品	推荐方式	需要注意
千问	千问 Code 直连 MCP；千问 API 用 Function Calling	普通网页聊天是否允许自定义工具取决于产品端
Kimi	Kimi Code / VS Code 直连 MCP；Kimi API 用 Function Calling	Kimi 网页聊天与 Kimi Code 不是同一接入面
DeepSeek	MCP 宿主中选择 DeepSeek 模型，或 DeepSeek API Function Calling	官方 API 要求开发者执行函数并回传结果
豆包	火山方舟 Responses / Function Calling / Remote MCP	豆包普通 App 与方舟开发平台不是同一个产品面
智谱	智能体平台导入 OpenAPI，或在兼容 MCP 的客户端中使用	智谱清言普通聊天是否开放自定义工具，以产品当前能力为准

官方能力说明可参考：千问 Code MCP、Kimi Code MCP、DeepSeek Function Calling、豆包方舟 Function Calling、智谱 OpenAI 兼容接口。

密钥与故障处理

密钥泄露会暴露店况，但不能修改店铺。立即回“我的配置 → 外部 AI”吊销并重发。
URL 查询参数密钥只为少数旧客户端兼容；推荐始终使用 Bearer 请求头，避免密钥进入浏览器历史和代理日志。
MCP 是 Streamable HTTP 单响应形态；短查询不提供 SSE 推送流，GET 请求返回 405 属预期。
查询失败只表示本次没有取到数据，不表示销量、订单、库存或利润为 0。
第三方付费数据源的原始序列不会经本接口二次分发。