For AI Agents

AIエージェントが機種検索・見積もりを直接行えます

MAQは2つの機械可読エンドポイントを公開しています：標準的なREST API、そしてModel Context Protocol（MCP）サーバーです。エージェントは要件を一文で伝えるだけで機種を選定でき、販売中の機種を検索し、設定可能な全項目とその選択肢を取得し、設定内容を送信して正確な合計金額を取得し、顧客に渡せる見積もりURLを生成できます。公開・登録不要・APIキー不要です。

どちらのエンドポイントも注文を作成しません。エージェントが担当するのは構成と見積もりまでで、注文の確定・送信は必ず顧客ご本人が注文ページで行います。 MAQはエージェントによる代理注文を受け付けておらず、APIを通じて決済情報を取得することもありません。

価格表記のルール

金額はすべて新台湾ドル建て、税・送料込みの総額です。別途の税額や送料はかかりません。
見積もりは注文ページと同一のコンフィギュレーターエンジンで計算されるため、ウェブサイト表示の金額と一致します。
価格は在庫状況により変動します。見積もりの有効期限は2日間です。期限切れの場合は再取得してください。
提供するのは本体一式の合計金額のみで、個別パーツの単価やオプション加算額は開示していません。

REST API

ベースURL https://maq.tw/api/v1　·　IPごとに毎分60リクエストまで　·　APIキー不要・登録不要　·　HEADはGETと同様に扱われます

`GET\|POST /recommend`	要件を一文で伝えるだけで機種を選定（顧客がスペックを言語化できない場合に利用）
`GET /machines`	販売中の機種と現在の価格
`GET /machines/`	スペック、および設定可能な各項目の選択肢
`GET\|POST /quote`	構成内容を送信し、正確な合計金額と構成内容を取得
`POST /quote/create`	構成内容を見積もりとして保存し、顧客に渡せる短縮URLを返却

例：顧客が要件のみを伝え、MAQに構成を推薦させる

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

レスポンスには推奨機種、想定用途、実行可能なモデル、税・送料込みの合計金額、そして order_urlが含まれます——このリンクは注文ページに構成内容をあらかじめ反映するため、顧客が開くとエージェントが構成した機種がそのまま表示されます。

例：Llama 70B機種のGPUを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/のレスポンスから取得できるため、事前に把握しておく必要はありません。指定しなかった項目は工場出荷時のデフォルト構成が適用されます。

GETしか送れないエージェントの場合

エージェントによってはブラウジング／リサーチモードでURLの取得しかできず、POSTを送信できない場合があります。そのためrecommendとquote はGETにも対応しており、パラメータをクエリ文字列に含めるだけで、ブラウザに直接貼り付けても読み込めます：

https://maq.tw/api/v1/recommend?need=我只是 RAG ERP 需求
https://maq.tw/api/v1/recommend?need=本地跑 70B，資料不能外流&budget=800000
https://maq.tw/api/v1/quote?slug=ai-high&graphic=GPU_RTX_PRO_6000_96GB

GET /api/v1自体が自己説明型のエンドポイントであり、レスポンス内のget_examples にそのまま使えるURLが一覧表示されます。このAPIにはAPIキーもUser-Agent制限もありません。 robots.txtも各社のAIクローラーに対して全面的に開放しています。取得できない場合は、GETまたはPOSTを使用しているか、 HEADのみを送っていないかご確認ください。

MCPサーバー

エンドポイント https://maq.tw/mcp/　·　プロトコルバージョン 2026-07-28　·　Streamable HTTP、POSTのみ受付

MCP対応エージェント（Claude、ChatGPT、Cursorなど）は、このURLをサーバーとしてそのまま追加することで、6つのツールを利用できます：

recommend — 要件を一文で伝えるだけで機種を選定し、推奨機種と構成済みの注文リンクを返却
list_machines — 販売中の機種と現在の価格
get_machine — スペックと設定可能なオプション
quote — 指定した構成に基づき正確な見積もりを計算
create_quote — 顧客に渡せる見積もり短縮URLを発行（有効期限2日間）
search_faq — 保証、アフターサービス、代替機、プリインストールソフトウェアなどのよくある質問

その他の情報取得手段

llms.txt — サイト全体の機械可読サマリー、本ページの2つのエンドポイントも含む
各機種の注文ページにはProduct構造化データ、よくある質問ページにはFAQPage構造化データを実装

人間の方へ

ご自身でご覧になっている方は、これらのエンドポイントをブラウザで直接開くこともできます。 /api/v1/machinesを試してみてください。カスタム要件やご協業のご相談はお問い合わせまで、またはお電話 (02) 2658-6798 までご連絡ください。