API 與 MCP 說明
重點摘要：比價紀錄提供免費、免註冊的 JSON API 與 4 個 MCP 工具，價格單位為新台幣、每天更新；另有 x402 付費端點，完整價格歷史 0.01 USDC、整個分類匯出 0.05 USDC。
免費 JSON API，不用註冊。資料為新台幣，每天更新。
| 端點 | 說明 |
|---|---|
GET /api/categories | 分類與商品數 |
GET /api/search?q=AirPods&cat=earbuds | 搜尋商品（最多 50 筆） |
GET /api/product/{id} | 單一商品目前最低價與近 90 天摘要 |
GET /api/category/{slug} | 分類內所有商品目前價格 |
GET /api/deals?cat= | 今日降價清單 |
POST /mcp | MCP 工具：search_products、get_product_price、list_price_drops、list_categories |
付費端點（x402，USDC）
GET /api/pro/history/{id} | 完整每日價格歷史 |
GET /api/pro/export/{slug} | 整個分類匯出，含每項商品 90 天統計 |
沒有付款時回傳 HTTP 402 與付款資訊，支援 x402 的 AI 代理會自動付款。
範例：https://shop.penguindriver.com/api/search?q=AirPods
常見問題
有哪些免費 API 可以查價？
包含 /api/categories（分類與商品數）、/api/search?q=關鍵字（最多 50 筆）、/api/product/{id}（目前最低價與近 90 天摘要）、/api/category/{slug}（分類內所有商品）與 /api/deals（今日降價）。
MCP 有哪些工具？
對 /mcp 發送 POST 可使用 4 個工具：search_products（搜尋商品）、get_product_price（單品價格與 90 天統計）、list_price_drops（今日降價）、list_categories（分類清單）。
付費端點怎麼使用？
付費端點採 x402 協定以 USDC 付款：/api/pro/history/{id} 提供完整每日價格歷史（0.01 USDC），/api/pro/export/{slug} 匯出整個分類含 90 天統計（0.05 USDC）。未付款時回傳 HTTP 402 與付款資訊，目前為測試網。
AI 可以讀取純文字版的價格嗎？
可以，頁面網址加上 .md 就能取得 Markdown 純文字版，例如分類頁與單品頁；網站也提供 /llms.txt 列出所有分類的純文字清單。