MCP 接入與使用
在 AI 助手中查詢套餐、餘額與訂單,核對報價後下單。
MCP 服務位址
https://www.zhanqunba.com/api/mcp
連線方式
以本站 VIP 卡密作為 Bearer 權杖。無需網頁登入;不提供 OAuth。僅在可信本機客戶端或伺服器保存卡密。
適用於支援遠端 Streamable HTTP 與自訂 Authorization 標頭的客戶端。
{
"mcpServers": {
"zfensi": {
"url": "https://www.zhanqunba.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:ZFENSI_CARD}"
}
}
}
}先將卡密存入本機環境變數 ZFENSI_CARD,再讓客戶端讀取;範例不包含真實卡密。
先核價,再下單
- 查找套餐與可用餘額。
- 取得報價,核對目標、金額、幣別與有效期。
- 確認後使用報價編號、金額上限與 UUID 下單。
- 憑原訂單號查詢進度。
給 AI 助手的範例指令
先查詢我的可用餘額與 Instagram 套餐,為我填寫的帳號取得報價。展示目標、套餐數量與總價,待我確認後再下單;逾時重試時保持相同請求編號。
可用工具
| Tool | 接入與使用說明 |
|---|---|
list_services | 分頁查詢服務、數量與價格 |
get_balance | 查詢餘額與可用餘額 |
quote_order | 校驗目標並取得不扣款報價 |
create_order | 依報價與金額上限付費下單 |
get_order_status | 按原訂單號查詢進度 |
HTTP 握手範例
curl 'https://www.zhanqunba.com/api/mcp' \
-H "Authorization: Bearer $ZFENSI_CARD" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
--data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0.0"}}}'呼叫與扣款規則
- 報價不建立訂單、不扣款;有效期為 5 分鐘。
- max_amount 使用最小貨幣單位:人民幣 100 分為 1 元。報價改變或失效時重新報價。
- 逾時後重用相同的 quote_id、request_id 與參數;新 UUID 表示另一筆付費訂單。
- 以目前固定套餐數量為準。評論及關鍵字使用 comment_input、hashtag_input。
- 僅可查詢該卡訂單;取消狀態不代表已退款,未知起始數與剩餘數回傳 null。
- 支援 MCP 2025-11-25、2025-06-18、2025-03-26;無狀態 JSON 回應,不維持 SSE 連線。
- 每卡工具呼叫最多 60 次/分鐘。HTTP 429 遵守 Retry-After;工具 RATE_LIMITED 時等待一分鐘。
- 請求上限 64 KiB。工具均需 Bearer 驗證;卡密停用或過期後不可繼續呼叫。
