For AI Agents

讓 AI 代理直接查機型、算報價

MAQ 開放兩個機器可讀端點：一般 REST API，以及 Model Context Protocol（MCP）伺服器。代理可以用一句需求選機、查在售機型、取得可配置的每一個欄位與選項、送出一組配置取回精確總價，並產生一張可交給客人的報價單網址。公開、免申請、免金鑰。

這兩個端點都不會建立訂單。代理負責配置與報價；訂購一律由客人本人在訂購頁確認送出。 MAQ 不接受代理代為下單，也不會透過 API 收取任何付款資訊。

價格口徑

所有金額為新台幣、含稅含運費的總價，不另計稅額或運費。
報價由訂購頁的同一套配置器引擎計算，與網頁顯示的數字一致。
價格會隨供應狀況變動；報價單有效期兩天，逾期請重新取得。
只提供整台的總價，不揭露個別零件的單價或選項加價。

REST API

基底位址 https://maq.tw/api/v1　·　每個 IP 每分鐘 60 次

`POST /recommend`	用一句需求描述選機（客人講不出規格時用這個）
`GET /machines`	在售機型與現價
`GET /machines/`	規格，以及每個可配置欄位有哪些選項
`POST /quote`	送一組配置，回精確總價與配置內容
`POST /quote/create`	把配置存成報價單，回傳可交給客人的短網址

範例：客人只講需求，讓 MAQ 推薦配置

curl -s https://maq.tw/api/v1/recommend \
  -H 'Content-Type: application/json' \
  -d '{"need":"我只是 RAG／ERP 需求","budget":300000}'

回應會給建議機型、適用情境、可跑的模型、含稅含運費總價，以及一個 order_url——那個連結會把這組配置預先帶入訂購頁，客人打開看到的就是代理配好的那一台。

範例：把 Llama 70B 機型換成 RTX PRO 6000 96GB 後報價

curl -s https://maq.tw/api/v1/quote \
  -H 'Content-Type: application/json' \
  -d '{"slug":"ai-high","selection":{"graphic":"GPU_RTX_PRO_6000_96GB"}}'

欄位代號（例 graphic）與料號（例 GPU_RTX_PRO_6000_96GB）都來自 GET /machines/ 的回應，不需要事先知道。未指定的欄位會沿用原廠預設配置。

MCP 伺服器

端點 https://maq.tw/mcp/　·　協定版本 2026-07-28　·　Streamable HTTP，僅接受 POST

支援 MCP 的代理（Claude、ChatGPT、Cursor 等）可直接把這個網址加為伺服器，取得六個工具：

recommend — 用一句需求描述選機，回建議機型與已帶入配置的訂購連結
list_machines — 在售機型與現價
get_machine — 規格與可配置選項
quote — 依指定配置計算精確報價
create_quote — 產生報價單短網址交給客人（有效期兩天）
search_faq — 保固、售後、備機、預載軟體等常見問題

其他探索管道

llms.txt — 全站的機器可讀摘要，含本頁兩個端點
每個機型訂購頁都有 Product 結構化資料；常見問題頁有 FAQPage 結構化資料

給人看的部分

如果你是自己來看的：這些端點也可以直接用瀏覽器打開 /api/v1/machines 看一眼。有客製需求或想談合作，請洽聯絡我們，電話 (02) 2658-6798。