API 與 MCP 說明
重點摘要：二行程經典車資料庫提供免費 JSON API，不用註冊，共 5 個端點（車款清單、單一車款、搜尋、零件反查、投稿），以及 4 個 MCP 工具，可查 42 款車的規格出處、零件、保養與行情。
免費 JSON API，不用註冊。
| 端點 | 說明 |
|---|---|
GET /api/models | 全部車款清單 |
GET /api/model/{slug} | 單一車款規格（含出處）、零件、保養、行情 |
GET /api/search?q=NSR | 搜尋車款 |
GET /api/parts?q=BR9ES | 零件型號反查適用車款 |
POST /api/contribute | 投稿（JSON：slug, kind=part|maint|sale|spec, item, value, note, source） |
POST /mcp | MCP 工具：search_models、get_model_specs、find_part、get_maintenance |
付費端點（x402，USDC）
GET /api/pro/export 全部車款與已審核資料一次匯出。沒有付款時回 HTTP 402。
常見問題
怎麼用 API 查某台二行程車的規格？
先用 GET /api/search?q=NSR 找到車款代號，再呼叫 GET /api/model/{slug}，會回傳規格（含維基百科出處與授權）、零件對照、保養資料與成交行情。
MCP 提供哪些工具？
POST /mcp 提供 4 個工具：search_models（搜尋車款）、get_model_specs（規格與出處）、find_part（零件型號反查車款）、get_maintenance（混合比、齒輪油、火星塞間隙等保養資料）。
可以透過 API 投稿資料嗎？
可以。POST /api/contribute，送出 JSON 欄位 slug、kind（part、maint、sale 或 spec）、item、value、note、source，投稿同樣要審核後才公開。
API 需要付費嗎？
基本 API 與 MCP 免費。另有 GET /api/pro/export 可一次匯出全部車款與已審核資料，透過 x402 協定以 USDC 付費，未付款時回應 HTTP 402，開放與否依網站設定。