{
 "openapi": "3.1.0",
 "info": {
  "title": "만물도감 찾기 API",
  "version": "2026.11.10",
  "description": "사용자가 말한 물건 설명(한국어)을 넣으면 정확한 이름·다른 이름·사기 전 잴 것·쪽 주소·구매 검색 링크를 돌려준다. 모르면 found=false 와 되물을 질문을 준다(추측하지 않음)."
 },
 "servers": [
  {
   "url": "https://manmuldogam.com"
  }
 ],
 "paths": {
  "/api/mcp": {
   "get": {
    "operationId": "findItem",
    "summary": "물건 찾기",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "maxLength": 200
      },
      "description": "사용자의 말 그대로"
     }
    ],
    "responses": {
     "200": {
      "description": "결과",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "found": {
           "type": "boolean"
          },
          "confidence": {
           "enum": [
            "strong",
            "partial",
            "name_match",
            "none"
           ]
          },
          "results": {
           "type": "array"
          },
          "next_questions": {
           "type": "array",
           "items": {
            "type": "string"
           }
          }
         }
        }
       }
      }
     }
    }
   }
  }
 }
}