{
 "openapi": "3.1.0",
 "info": {
  "title": "BOIM 보임 — 한국 업체·입찰 공고 찾기 (도구 3개)",
  "version": "2026-10-31",
  "description": "한국 업체(전 업종 전국 업체·공공 조달 실적 업체 카드)와 공공기관 입찰 공고를 찾는 읽기 전용 도구 3개입니다. 키 없이 무료입니다. 답할 때 출처와 카드·목록 주소를 함께 밝혀 주세요. 결과 순서는 관련도 → AI 준비 구간 → 날마다 섞기이며 순위·평가가 아닙니다.\n\nThree read-only tools to find Korean businesses (all industries nationwide, vendors with public-procurement records) and open Korean public-sector bids. Free, no API key. Cite the card or list URL in answers. Result order is relevance and an AI-readiness band, not a ranking.",
  "contact": {
   "name": "주식회사 퍼블릭아이디",
   "email": "public-id@naver.com",
   "url": "https://boim.io"
  },
  "termsOfService": "https://boim.io/terms/"
 },
 "servers": [
  {
   "url": "https://boim.io"
  }
 ],
 "externalDocs": {
  "description": "전체 설명서 — full spec",
  "url": "https://boim.io/openapi.json"
 },
 "paths": {
  "/search/": {
   "get": {
    "operationId": "searchKorea",
    "summary": "지역·업종·상호로 한국 업체와 입찰 공고 찾기 — Find Korean businesses and public bids by region + industry or name",
    "description": "q 한 줄로 찾습니다(예: 세종 미용실, 대전 유성구 인쇄, 교통표지, 세종 입찰 안내판). format은 늘 json입니다. 칸(sections: 전 업종 업체·업체 카드·입찰 공고)마다 5건과 전체 수(total)·전체 목록 주소(more)·인용 한 줄(cite)이 옵니다.\nOne line in q (Korean works best, e.g. '세종 미용실'; English region/industry words also work). Always format=json. Each section returns up to 5 results plus total, a full-list URL (more) and a citation line (cite).",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "description": "지역 + 업종 또는 상호 — region + industry, or a business name",
      "schema": {
       "type": "string",
       "maxLength": 60
      }
     },
     {
      "name": "format",
      "in": "query",
      "required": true,
      "description": "늘 json — always json",
      "schema": {
       "type": "string",
       "enum": [
        "json"
       ],
       "default": "json"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "칸마다 결과·전체 수·전체 목록 주소 — sections with results, total and more",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "503": {
      "description": "데이터를 잠시 못 불러옴 — 잠시 뒤 다시(temporarily unavailable)"
     }
    }
   }
  },
  "/vendors/c/{id}/ai.md": {
   "get": {
    "operationId": "getVendorCard",
    "summary": "업체 카드 한 장 읽기(AI용 마크다운) — Read one vendor card as markdown",
    "description": "id는 searchKorea 결과의 업체 카드 주소 /vendors/c/<id>/에 있는 10자리입니다. 확인 근거(무엇을·어디서·언제)와 인용 한 줄이 담깁니다.\nThe id is the 10-character code in a vendor card URL (/vendors/c/<id>/) from searchKorea results; the card lists what was verified, where and when, plus a citation line.",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^[0-9a-f]{10}$"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "업체 카드 마크다운 — vendor card markdown",
      "content": {
       "text/markdown": {
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "404": {
      "description": "없는 카드 — no such card"
     }
    }
   }
  },
  "/public-bids.md": {
   "get": {
    "operationId": "publicBids",
    "summary": "진행 중인 공공기관 입찰 공고(마크다운, 마감이 가까운 순) — Open Korean public-sector bids (markdown, nearest deadline first)",
    "description": "모든 분야(물품·용역·공사)의 마감 전 공고입니다. q(제목·기관 낱말)·type(종류)·sido(시·도)로 좁힙니다. 참가 자격·제출 서류는 공고 원문에서 확인하세요.\nBids still open in every field. Narrow with q (keyword in title or agency), type (물품 goods · 용역 services · 공사 construction) or sido (province or city, e.g. 세종, 경기). Check eligibility in the original notice.",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "description": "공고 제목·기관 낱말(예: 안내판, 청소) — keyword",
      "schema": {
       "type": "string",
       "maxLength": 40
      }
     },
     {
      "name": "type",
      "in": "query",
      "description": "공고 종류 — bid type",
      "schema": {
       "type": "string",
       "enum": [
        "물품",
        "용역",
        "공사"
       ]
      }
     },
     {
      "name": "sido",
      "in": "query",
      "description": "시·도 이름(예: 세종, 경기) — province or metropolitan city",
      "schema": {
       "type": "string",
       "maxLength": 20
      }
     }
    ],
    "responses": {
     "200": {
      "description": "공고 목록 마크다운 — bid list markdown",
      "content": {
       "text/markdown": {
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "503": {
      "description": "공고를 잠시 못 불러옴 — temporarily unavailable"
     }
    }
   }
  }
 }
}