{"openapi":"3.0.3","info":{"title":"K-Company Lookup API","version":"1.1.0","description":"Korean business registry lookup by bizno (사업자등록번호). Returns company name, representative, industry, status, founding date, and address in English. Includes MCP endpoint for AI agent integration.","contact":{"name":"lazymac","url":"https://api.lazy-mac.com/k-company-lookup"}},"servers":[{"url":"https://api.lazy-mac.com/k-company-lookup","description":"Production"}],"paths":{"/":{"get":{"summary":"API info / landing page","operationId":"getInfo","responses":{"200":{"description":"JSON API info or HTML landing page"}}}},"/health":{"get":{"summary":"Health check","operationId":"healthCheck","responses":{"200":{"description":"Service health","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string","example":"k-company-lookup"},"ts":{"type":"string","format":"date-time"}}}}}}}}},"/lookup/{bizno}":{"get":{"summary":"Look up a Korean company by 사업자등록번호 (bizno)","operationId":"lookupByBizno","parameters":[{"name":"bizno","in":"path","required":true,"description":"10-digit Korean business registration number. Hyphens allowed (e.g. 116-81-00015 or 1168100015).","schema":{"type":"string","pattern":"^[0-9]{3}-?[0-9]{2}-?[0-9]{5}$|^[0-9]{10}$","example":"1168100018"}}],"responses":{"200":{"description":"Company record found","content":{"application/json":{"schema":{"type":"object","properties":{"bizno":{"type":"string","description":"10-digit normalized bizno"},"name":{"type":"string","description":"Company name in English"},"representative":{"type":"string","description":"CEO / representative name"},"industry":{"type":"string","description":"Industry description"},"status":{"type":"string","enum":["active","closed","suspended"]},"founded":{"type":"string","format":"date","description":"Founding date"},"address":{"type":"string","description":"Registered address"},"employees":{"type":"string","description":"Approximate headcount"},"type":{"type":"string","enum":["corporation","sole_proprietorship","partnership"]},"source":{"type":"string","description":"Data source identifier"}}}}}},"400":{"description":"Invalid bizno format or checksum"},"404":{"description":"Company not found in registry"}}}},"/search":{"get":{"summary":"Search Korean companies by name or industry keyword","operationId":"searchCompanies","parameters":[{"name":"q","in":"query","required":true,"description":"Search query — company name or industry keyword (English or Korean)","schema":{"type":"string","minLength":2,"example":"samsung"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of results (1–50)","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"total":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"bizno":{"type":"string"},"name":{"type":"string"},"industry":{"type":"string"},"status":{"type":"string"},"founded":{"type":"string"}}}}}}}}},"400":{"description":"Missing or too-short query"}}}},"/mcp":{"get":{"summary":"MCP endpoint info (browser-friendly)","operationId":"mcpInfo","responses":{"200":{"description":"MCP server metadata and usage instructions"}}},"post":{"summary":"MCP JSON-RPC 2.0 endpoint","operationId":"mcpEndpoint","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"type":"integer"},"method":{"type":"string","enum":["initialize","tools/list","tools/call","notifications/initialized"]},"params":{"type":"object"}}},"examples":{"initialize":{"summary":"Initialize","value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}},"tools_list":{"summary":"List tools","value":{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}},"lookup":{"summary":"Lookup by bizno","value":{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"lookup_company_by_bizno","arguments":{"bizno":"1168100018"}}}}}}}},"responses":{"200":{"description":"JSON-RPC 2.0 response"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Required for /lookup and /search endpoints. Get a key via Gumroad."}}}}