{
  "openapi": "3.0.3",
  "info": {
    "title": "buygood.tw 好物選 API 規格介面",
    "description": "提供 buygood.tw 每 12 小時檔期精選物、0 元開店分潤與超商物流門市快搜之 OpenAPI 標準介面，供 Custom GPTs、Claude MCP 及自動化 AI 代理調用。",
    "version": "1.0.0",
    "contact": {
      "name": "tagAHA 點點智聯營運總部",
      "url": "https://tagaha.com",
      "email": "ceo@tagaha.com"
    }
  },
  "servers": [
    {
      "url": "https://buygood.tw",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "summary": "獲取目前 12H 檔期推薦破盤良品資訊與主頁面",
        "description": "取得目前全網推薦的破盤爆款商品名稱、官方直營通路（momo/PChome）、現折優惠與長輩 AI 聲控下單端點。",
        "responses": {
          "200": {
            "description": "成功返回檔期好物頁面",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/join": {
      "get": {
        "summary": "獲取 0 元免費開店加盟與 LINE 轉發分潤指南",
        "description": "查詢 0 元開通專屬選物店流程、零囤貨零保證金機制、LINE 好友下單分潤計算與提領說明。",
        "responses": {
          "200": {
            "description": "成功返回 0 元開店指南頁面",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/shipping": {
      "get": {
        "summary": "查詢全台 7-11、全家、萊爾富三大超商門市代碼與寄件單格式",
        "description": "提供全台超過 13,000 間超商門市代碼即時檢索與電子寄件標籤標準產生器。",
        "responses": {
          "200": {
            "description": "成功返回超商快搜頁面",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "大語言模型（LLM）純文字結構化知識摘要",
        "description": "遵循 RFC 規格之 AI 專屬精簡知識本體，包含實體定義、痛點解法與問答檢索庫。",
        "responses": {
          "200": {
            "description": "成功返回 llms.txt 純文字檔案",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/feed.xml": {
      "get": {
        "summary": "12H 限時檔期 RSS 2.0 / Atom 即時新聞訂閱源",
        "description": "提供 Google News 與各類訂閱爬蟲秒級感知當前 12H 檔期推薦良品之 XML 格式來源。",
        "responses": {
          "200": {
            "description": "成功返回 RSS 訂閱 XML 檔案",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}