court_auction_search
Search Korean court auction property listings to find foreclosed real estate by region, property type, price range, or auction date.
Instructions
Search Korean court auction property listings. Find foreclosed real estate by region, property type, price range, or auction date.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | Court region (e.g., '서울', '부산', '대구', 'Seoul') | |
| property_type | No | Property type (e.g., '아파트', '토지', '상가', 'apartment', 'land') | |
| min_price | No | Minimum appraisal price (KRW) | |
| max_price | No | Maximum appraisal price (KRW) | |
| keyword | No | Search keyword | |
| page | No | Page number (default 1) |
Implementation Reference
- src/index.ts:15-40 (handler)This is the dynamic handler for all tools, including "court_auction_search". It uses the tool's endpoint and performs a gatewayRequest.
for (const tool of allTools) { server.tool( tool.name, tool.description, tool.inputSchema.shape, async (params) => { const method = tool.method || "POST"; const result = await gatewayRequest(method, tool.endpoint, params as Record<string, unknown>); if (result.error) { return { content: [{ type: "text" as const, text: `Error (${result.status}): ${result.error}` }], isError: true, }; } const text = typeof result.data === "string" ? result.data : JSON.stringify(result.data, null, 2); return { content: [{ type: "text" as const, text }], }; }, ); } - src/tools/court-auction.ts:5-17 (registration)Definition and registration of the "court_auction_search" tool, including its schema and endpoint.
{ name: "court_auction_search", description: "Search Korean court auction property listings. Find foreclosed real estate by region, property type, price range, or auction date.", inputSchema: z.object({ region: z.string().optional().describe("Court region (e.g., '서울', '부산', '대구', 'Seoul')"), property_type: z.string().optional().describe("Property type (e.g., '아파트', '토지', '상가', 'apartment', 'land')"), min_price: z.number().optional().describe("Minimum appraisal price (KRW)"), max_price: z.number().optional().describe("Maximum appraisal price (KRW)"), keyword: z.string().optional().describe("Search keyword"), page: z.number().optional().describe("Page number (default 1)"), }), endpoint: "/v1/auction/search", },