presale-mcp 0.1.0

package/dist/index.js

@@ -0,0 +1,3535 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z as z3 } from "zod";
+
+// src/utils.ts
+function normalizeWhitespace(value) {
+  return value.trim().replace(/\s+/g, " ");
+}
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function distanceLabel(distanceM) {
+  if (distanceM >= 1e3) {
+    const km = distanceM / 1e3;
+    return `\uC57D ${Number.isInteger(km) ? km.toFixed(0) : km.toFixed(1)}km`;
+  }
+  return `\uC57D ${Math.round(distanceM)}m`;
+}
+function haversineMeters(a, b) {
+  const radius = 6371e3;
+  const toRad = (degree) => degree * Math.PI / 180;
+  const dLat = toRad(b.lat - a.lat);
+  const dLng = toRad(b.lng - a.lng);
+  const lat1 = toRad(a.lat);
+  const lat2 = toRad(b.lat);
+  const sinLat = Math.sin(dLat / 2);
+  const sinLng = Math.sin(dLng / 2);
+  const h = sinLat * sinLat + Math.cos(lat1) * Math.cos(lat2) * sinLng * sinLng;
+  return Math.round(2 * radius * Math.asin(Math.sqrt(h)));
+}
+function assertKoreaCoordinate(lat, lng) {
+  if (lat < 33 || lat > 39 || lng < 124 || lng > 132) {
+    return "Coordinate is outside the expected South Korea bounding box.";
+  }
+  return void 0;
+}
+async function readJsonResponse(response) {
+  const text3 = await response.text();
+  try {
+    return text3.length === 0 ? null : JSON.parse(text3);
+  } catch {
+    throw new Error(`Invalid JSON response (${response.status})`);
+  }
+}
+
+// src/cache.ts
+var NOOP_CACHE = {
+  async getOrSet(_key, _ttlMs, fetchFn) {
+    return fetchFn();
+  },
+  async getOrSetWithStatus(_key, _ttlMs, fetchFn) {
+    return { value: await fetchFn(), hit: false };
+  },
+  async getOrSetWithStatusIf(_key, _ttlMs, fetchFn) {
+    return { value: await fetchFn(), hit: false };
+  }
+};
+function createCache(_db, _now = Date.now) {
+  return NOOP_CACHE;
+}
+var TTL = {
+  geocode: 30 * 24 * 60 * 60 * 1e3,
+  region: 30 * 24 * 60 * 60 * 1e3,
+  announcements: 6 * 60 * 60 * 1e3,
+  announcementDetail: 7 * 24 * 60 * 60 * 1e3,
+  trades: 24 * 60 * 60 * 1e3,
+  complexInfo: 30 * 24 * 60 * 60 * 1e3,
+  nearbyComplex: 6 * 60 * 60 * 1e3
+};
+
+// src/tools/geocode.ts
+async function getGeocode(input, env, fetcher = fetch, options = {}) {
+  const address = normalizeWhitespace(input.address);
+  if (!options.cache) return geocodeUncached(input, env, fetcher, options);
+  const key = `geo:${options.skipRegionCode ? "n" : "r"}:${address}`;
+  const cached = await options.cache.getOrSetWithStatus(key, TTL.geocode, async () => {
+    const result = await geocodeUncached(input, env, fetcher, options);
+    return "lat" in result ? result : null;
+  });
+  if (cached.value && "lat" in cached.value) return { ...cached.value, metadata: { ...cached.value.metadata, cache_hit: cached.hit } };
+  return geocodeUncached(input, env, fetcher, options);
+}
+async function geocodeUncached(input, env, fetcher, options) {
+  const address = normalizeWhitespace(input.address);
+  const metadata = {
+    cache_hit: false,
+    providers_tried: ["naver"],
+    collected_at: nowIso()
+  };
+  if (!address) {
+    return errorResult(address, "INVALID_ADDRESS", "\uC8FC\uC18C \uBB38\uC790\uC5F4\uC774 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.", metadata);
+  }
+  if (!env.NAVER_MAPS_CLIENT_ID || !env.NAVER_MAPS_CLIENT_SECRET) {
+    return errorResult(address, "NAVER_AUTH_MISSING", "NAVER_MAPS_CLIENT_ID \uB610\uB294 NAVER_MAPS_CLIENT_SECRET \uD658\uACBD\uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.", metadata);
+  }
+  let queryResult = await queryNaver(address, env, fetcher);
+  if (queryResult.kind === "http_error") {
+    return errorResult(address, "NAVER_API_ERROR", `\uB124\uC774\uBC84 Geocoding API \uC624\uB958: HTTP ${queryResult.status}`, metadata);
+  }
+  if (queryResult.kind === "not_found") {
+    const cleaned = cleanCompoundAddress(address);
+    if (cleaned && cleaned !== address) {
+      const retry = await queryNaver(cleaned, env, fetcher);
+      if (retry.kind === "hit") queryResult = retry;
+    }
+  }
+  if (queryResult.kind !== "hit") {
+    return errorResult(address, "ADDRESS_NOT_FOUND", "\uC785\uB825\uD558\uC2E0 \uC8FC\uC18C\uB97C \uC88C\uD45C\uB85C \uBCC0\uD658\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.", metadata);
+  }
+  const first = queryResult.address;
+  const lat = Number(first.y);
+  const lng = Number(first.x);
+  const regionCode = options.skipRegionCode ? void 0 : await lookupRegionCode(address, env, fetcher);
+  const normalizedAddress = first.jibunAddress || first.roadAddress || address;
+  const roadAddress = first.roadAddress || void 0;
+  const result = {
+    address,
+    lat,
+    lng,
+    normalized_address: normalizedAddress,
+    address_type: first.jibunAddress ? "jibun" : first.roadAddress ? "road" : "approximate",
+    matched_provider: "naver",
+    ...roadAddress ? { road_address: roadAddress } : {},
+    region: extractRegion(first.addressElements ?? []),
+    ...regionCode ? { region_code: regionCode } : {},
+    confidence: first.jibunAddress || first.roadAddress ? "exact" : "partial",
+    metadata
+  };
+  return result;
+}
+function errorResult(address, error, message, metadata) {
+  return {
+    address,
+    error,
+    message,
+    matched_provider: "naver",
+    suggestions: ["\uB3C4\uB85C\uBA85 \uC8FC\uC18C\uB85C \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uBCF4\uC138\uC694.", "\uB354 \uAD6C\uCCB4\uC801\uC778 \uC9C0\uBC88\uC744 \uC785\uB825\uD574\uBCF4\uC138\uC694.", "\uC2DC\xB7\uB3C4 \uB2E8\uC704\uAE4C\uC9C0 \uD3EC\uD568\uB41C \uC804\uCCB4 \uC8FC\uC18C\uB97C \uC0AC\uC6A9\uD574\uBCF4\uC138\uC694."],
+    metadata
+  };
+}
+async function queryNaver(query, env, fetcher) {
+  const url = new URL("https://maps.apigw.ntruss.com/map-geocode/v2/geocode");
+  url.searchParams.set("query", query);
+  const response = await fetcher(url.toString(), {
+    headers: {
+      "x-ncp-apigw-api-key-id": env.NAVER_MAPS_CLIENT_ID ?? "",
+      "x-ncp-apigw-api-key": env.NAVER_MAPS_CLIENT_SECRET ?? "",
+      Accept: "application/json"
+    }
+  });
+  if (!response.ok) return { kind: "http_error", status: response.status };
+  const payload = await readJsonResponse(response);
+  const first = payload.addresses?.[0];
+  if (!first || payload.meta?.totalCount === 0) return { kind: "not_found" };
+  return { kind: "hit", address: first };
+}
+function cleanCompoundAddress(address) {
+  let cleaned = address.split(",")[0] ?? address;
+  cleaned = cleaned.replace(/\([^)]*\)/g, " ");
+  cleaned = cleaned.replace(/\s*(일원|일대|일부|번지)\b.*$/u, " ");
+  cleaned = cleaned.replace(/번지\s*$/u, " ");
+  return normalizeWhitespace(cleaned);
+}
+function extractRegion(elements) {
+  const byType = (type) => elements.find((element) => element.types?.includes(type))?.longName;
+  const sido = byType("SIDO");
+  const sigungu = byType("SIGUGUN");
+  const eupmyeondong = byType("DONGMYUN");
+  const jibun = byType("LAND_NUMBER");
+  const region = {};
+  if (sido) region.sido = sido;
+  if (sigungu) region.sigungu = sigungu;
+  if (eupmyeondong) region.eupmyeondong = eupmyeondong;
+  if (jibun) region.jibun = jibun;
+  return region;
+}
+async function lookupRegionCode(address, env, fetcher) {
+  if (!env.KAKAO_REST_API_KEY) return void 0;
+  const url = new URL("https://dapi.kakao.com/v2/local/search/address.json");
+  url.searchParams.set("query", address);
+  url.searchParams.set("analyze_type", "similar");
+  url.searchParams.set("size", "1");
+  const response = await fetcher(url.toString(), {
+    headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` }
+  });
+  if (!response.ok) return void 0;
+  const payload = await readJsonResponse(response);
+  return payload.documents?.[0]?.address?.b_code || void 0;
+}
+
+// src/config/categories.yaml
+var categories_default = 'amenity:\n  - id: school_elementary\n    label: \uCD08\uB4F1\uD559\uAD50\n    aliases: ["\uCD08\uB4F1\uD559\uAD50", "\uCD08\uB4F1", "\uCD08\uB4F1\uAD50"]\n    kakao_code: SC4\n    filter:\n      category_name_contains: "\uCD08\uB4F1\uD559\uAD50"\n  - id: school_middle\n    label: \uC911\uD559\uAD50\n    aliases: ["\uC911\uD559\uAD50", "\uC911\uB4F1"]\n    kakao_code: SC4\n    filter:\n      category_name_contains: "\uC911\uD559\uAD50"\n  - id: school_high\n    label: \uACE0\uB4F1\uD559\uAD50\n    aliases: ["\uACE0\uB4F1\uD559\uAD50", "\uACE0\uAD50", "\uACE0\uB4F1"]\n    kakao_code: SC4\n    filter:\n      category_name_contains: "\uACE0\uB4F1\uD559\uAD50"\n  - id: school\n    label: \uD559\uAD50\n    aliases: ["\uD559\uAD50", "\uC2A4\uCFE8"]\n    kakao_code: SC4\n  - id: subway\n    label: \uC9C0\uD558\uCCA0\uC5ED\n    aliases: ["\uC9C0\uD558\uCCA0", "\uC9C0\uD558\uCCA0\uC5ED", "\uC5ED", "\uC804\uCCA0"]\n    kakao_code: SW8\n  - id: mart_large\n    label: \uB300\uD615\uB9C8\uD2B8\n    aliases: ["\uB9C8\uD2B8", "\uB300\uD615\uB9C8\uD2B8", "\uC774\uB9C8\uD2B8", "\uD648\uD50C\uB7EC\uC2A4", "\uB86F\uB370\uB9C8\uD2B8"]\n    kakao_code: MT1\n  - id: hospital\n    label: \uBCD1\uC6D0\n    aliases: ["\uBCD1\uC6D0", "\uC758\uB8CC"]\n    kakao_code: HP8\n  - id: pharmacy\n    label: \uC57D\uAD6D\n    aliases: ["\uC57D\uAD6D"]\n    kakao_code: PM9\n  - id: park\n    label: \uACF5\uC6D0\n    aliases: ["\uACF5\uC6D0"]\n    kakao_code: AT4\n    filter:\n      category_name_contains: "\uACF5\uC6D0"\n\nkeyword_search_presets:\n  apartment:\n    query: "\uC544\uD30C\uD2B8"\n    category_filter:\n      include_contains: ["\uC544\uD30C\uD2B8"]\n      exclude_contains: ["\uC911\uAC1C", "\uBD84\uC591\uC0AC\uBB34\uC18C", "\uBAA8\uB378\uD558\uC6B0\uC2A4", "\uC8FC\uCC28\uC7A5", "\uC544\uD30C\uD2B8\uC0C1\uAC00", "\uC544\uD30C\uD2B8 \uB3D9"]\n    deduplicate_by: "name"\n  officetel:\n    query: "\uC624\uD53C\uC2A4\uD154"\n    category_filter:\n      include_contains: ["\uC624\uD53C\uC2A4\uD154"]\n      exclude_contains: ["\uC911\uAC1C", "\uBD84\uC591\uC0AC\uBB34\uC18C"]\n    deduplicate_by: "name"\n  library:\n    query: "\uB3C4\uC11C\uAD00"\n    category_filter:\n      include_contains: ["\uB3C4\uC11C\uAD00"]\n      exclude_contains: ["\uC11C\uC810", "\uBD81\uCE74\uD398"]\n';
+
+// src/config.ts
+import { parse } from "yaml";
+var parsed = parse(categories_default);
+var categories = parsed.amenity;
+var keywordSearchPresets = parsed.keyword_search_presets;
+function resolveCategory(input) {
+  const normalized = input.trim().toLowerCase();
+  return categories.find((category) => {
+    if (category.id.toLowerCase() === normalized || category.label.toLowerCase() === normalized) return true;
+    return category.aliases?.some((alias) => alias.toLowerCase() === normalized) ?? false;
+  });
+}
+
+// src/tools/nearby-category.ts
+async function searchByNearbyCategory(input, env, fetcher = fetch, options = {}) {
+  if (!options.cache) return searchByNearbyCategoryUncached(input, env, fetcher);
+  const key = `kakao:cat:${JSON.stringify({
+    lat: input.center_lat.toFixed(4),
+    lng: input.center_lng.toFixed(4),
+    radius: input.radius_m ?? 2e3,
+    categories: input.categories ?? null,
+    filter: input.subcategory_filter ?? null
+  })}`;
+  const cached = await options.cache.getOrSetWithStatus(key, TTL.announcements, async () => {
+    const result = await searchByNearbyCategoryUncached(input, env, fetcher);
+    return result.summary.total > 0 ? result : null;
+  });
+  if (cached.value) return { ...cached.value, metadata: { ...cached.value.metadata, cache_hit: cached.hit } };
+  return searchByNearbyCategoryUncached(input, env, fetcher);
+}
+async function searchByNearbyCategoryUncached(input, env, fetcher = fetch) {
+  const radiusM = Math.min(Math.max(input.radius_m ?? 2e3, 0), 2e4);
+  const metadata = {
+    cache_hit: false,
+    collected_at: nowIso(),
+    data_source: "kakao_category",
+    warnings: [],
+    truncated: false
+  };
+  const result = {
+    center: { lat: input.center_lat, lng: input.center_lng },
+    radius_m: radiusM,
+    results: {},
+    summary: { total: 0, by_category: {} },
+    metadata
+  };
+  const coordinateWarning = assertKoreaCoordinate(input.center_lat, input.center_lng);
+  if (coordinateWarning) {
+    metadata.warnings?.push(coordinateWarning);
+    return result;
+  }
+  if (!env.KAKAO_REST_API_KEY) {
+    metadata.warnings?.push("KAKAO_REST_API_KEY is missing.");
+    return result;
+  }
+  const resolvedCategories = (input.categories ?? ["school", "subway", "mart_large"]).map((categoryInput) => ({ original: categoryInput, category: resolveCategory(categoryInput) })).filter(({ original, category }) => {
+    if (!category) metadata.warnings?.push(`Unknown category: ${original}`);
+    return Boolean(category);
+  }).map(({ category }) => category);
+  for (const category of resolvedCategories) {
+    const documents = await fetchAllPages(category.kakao_code, input.center_lat, input.center_lng, radiusM, env, fetcher, metadata);
+    const filterContains = input.subcategory_filter?.category_name_contains ?? category.filter?.category_name_contains;
+    const places = documents.filter((doc) => filterContains ? doc.category_name.includes(filterContains) : true).map((doc) => normalizePlace(doc, input.center_lat, input.center_lng)).filter((place, index, array) => array.findIndex((other) => other.kakao_place_id === place.kakao_place_id) === index).sort((a, b) => a.distance_m - b.distance_m);
+    result.results[category.id] = places;
+    result.summary.by_category[category.id] = places.length;
+    result.summary.total += places.length;
+  }
+  if (metadata.warnings?.length === 0) delete metadata.warnings;
+  return result;
+}
+async function fetchAllPages(kakaoCode, lat, lng, radiusM, env, fetcher, metadata) {
+  const documents = [];
+  for (let page = 1; page <= 3; page += 1) {
+    const url = new URL("https://dapi.kakao.com/v2/local/search/category.json");
+    url.searchParams.set("category_group_code", kakaoCode);
+    url.searchParams.set("x", String(lng));
+    url.searchParams.set("y", String(lat));
+    url.searchParams.set("radius", String(radiusM));
+    url.searchParams.set("sort", "distance");
+    url.searchParams.set("page", String(page));
+    url.searchParams.set("size", "15");
+    const response = await fetcher(url.toString(), {
+      headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` }
+    });
+    if (!response.ok) throw new Error(`Kakao category API failed: HTTP ${response.status}`);
+    const payload = await readJsonResponse(response);
+    documents.push(...payload.documents ?? []);
+    if (payload.meta?.is_end !== false) break;
+    if (page === 3) {
+      metadata.truncated = true;
+      metadata.warnings ??= [];
+      metadata.warnings.push("Kakao Local API returned the maximum 45 results for at least one query; additional farther results may have been truncated.");
+    }
+  }
+  if (documents.length >= 45) {
+    metadata.truncated = true;
+    metadata.warnings ??= [];
+    const warning = "Kakao Local API returned the maximum 45 results for at least one query; additional farther results may have been truncated.";
+    if (!metadata.warnings.includes(warning)) metadata.warnings.push(warning);
+  }
+  return documents;
+}
+function normalizePlace(doc, centerLat, centerLng) {
+  const lat = Number(doc.y);
+  const lng = Number(doc.x);
+  const distanceM = doc.distance && doc.distance.length > 0 ? Number(doc.distance) : haversineMeters({ lat: centerLat, lng: centerLng }, { lat, lng });
+  return {
+    name: doc.place_name,
+    lat,
+    lng,
+    distance_m: Math.round(distanceM),
+    distance_label: distanceLabel(distanceM),
+    address: doc.road_address_name || doc.address_name,
+    ...doc.road_address_name ? { road_address: doc.road_address_name } : {},
+    kakao_place_id: doc.id,
+    kakao_category_name: doc.category_name
+  };
+}
+
+// src/tools/nearby-keyword.ts
+var KAKAO_GRID_CONCURRENCY = 6;
+async function searchByNearbyKeyword(input, env, fetcher = fetch, options = {}) {
+  if (!options.cache) return searchByNearbyKeywordUncached(input, env, fetcher);
+  const key = `kakao:kw:${JSON.stringify({
+    lat: input.center_lat.toFixed(4),
+    lng: input.center_lng.toFixed(4),
+    radius: input.radius_m ?? 2e3,
+    query: input.query?.trim() ?? null,
+    preset: input.preset ?? null,
+    filter: input.category_filter ?? null,
+    dedupe: input.deduplicate_by ?? null,
+    grid: input.grid ?? false
+  })}`;
+  const cached = await options.cache.getOrSetWithStatus(key, TTL.announcements, async () => {
+    const result = await collectNearbyKeywordResults(input, env, fetcher);
+    return result.summary.total_found > 0 ? result : null;
+  });
+  if (cached.value) return applyPagination(cached.value, input, cached.hit);
+  return searchByNearbyKeywordUncached(input, env, fetcher);
+}
+async function searchByNearbyKeywordUncached(input, env, fetcher = fetch) {
+  const result = await collectNearbyKeywordResults(input, env, fetcher);
+  return applyPagination(result, input, false);
+}
+async function collectNearbyKeywordResults(input, env, fetcher = fetch) {
+  const radiusM = Math.min(Math.max(input.radius_m ?? 2e3, 0), 2e4);
+  const metadata = {
+    cache_hit: false,
+    collected_at: nowIso(),
+    data_source: "kakao_keyword",
+    warnings: [],
+    truncated: false
+  };
+  const preset = input.preset ? keywordSearchPresets[input.preset] : void 0;
+  if (input.preset && !preset) metadata.warnings?.push(`Unknown preset: ${input.preset}`);
+  const query = input.query?.trim() || preset?.query || "";
+  const filterApplied = input.category_filter ?? preset?.category_filter ?? null;
+  const deduplicateBy = input.deduplicate_by ?? preset?.deduplicate_by ?? null;
+  if (input.query?.trim() && isShortNoisyKeyword(query)) {
+    metadata.warnings?.push(`Short keyword "${query}" can return noisy or incomplete Kakao results. Prefer a more specific place type, brand+district, or preset when possible.`);
+  }
+  const result = {
+    center: { lat: input.center_lat, lng: input.center_lng },
+    radius_m: radiusM,
+    query,
+    filter_applied: filterApplied,
+    deduplicate_by: deduplicateBy,
+    results: [],
+    summary: { total_found: 0, after_filter: 0, after_dedupe: 0 },
+    metadata
+  };
+  const coordinateWarning = assertKoreaCoordinate(input.center_lat, input.center_lng);
+  if (coordinateWarning) {
+    metadata.warnings?.push(coordinateWarning);
+    return result;
+  }
+  if (!query) {
+    metadata.warnings?.push("Either query or preset is required.");
+    return result;
+  }
+  if (!env.KAKAO_REST_API_KEY) {
+    metadata.warnings?.push("KAKAO_REST_API_KEY is missing.");
+    return result;
+  }
+  const documents = input.grid ? await fetchGridCells(query, input.center_lat, input.center_lng, radiusM, env, fetcher, metadata) : await fetchAllPages2(query, input.center_lat, input.center_lng, radiusM, env, fetcher, metadata);
+  result.summary.total_found = documents.length;
+  const filtered = documents.filter((doc) => matchesFilter(doc.category_name, filterApplied));
+  result.summary.after_filter = filtered.length;
+  const normalized = filtered.map((doc) => normalizePlace2(doc, input.center_lat, input.center_lng)).filter((place) => place.distance_m <= radiusM).sort((a, b) => a.distance_m - b.distance_m);
+  const deduped = deduplicate(normalized, deduplicateBy);
+  result.results = deduped;
+  result.summary.after_dedupe = deduped.length;
+  if (metadata.warnings?.length === 0) delete metadata.warnings;
+  return result;
+}
+function applyPagination(result, input, cacheHit) {
+  const limit = normalizeLimit(input.limit);
+  const offset = normalizeOffset(input.offset);
+  const total = result.results.length;
+  const returned = limit === void 0 ? result.results.slice(offset) : result.results.slice(offset, offset + limit);
+  const consumedCount = offset + returned.length;
+  const omittedCount = Math.max(0, total - consumedCount);
+  const hasMore = consumedCount < total;
+  const metadata = {
+    ...result.metadata,
+    cache_hit: cacheHit,
+    returned_count: returned.length,
+    omitted_count: omittedCount,
+    offset,
+    has_more: hasMore,
+    next_offset: hasMore ? consumedCount : null,
+    truncated: Boolean(result.metadata.truncated) || hasMore,
+    ...limit !== void 0 ? { limit, result_limit: limit } : {}
+  };
+  if (omittedCount > 0) {
+    metadata.warnings ??= [];
+    metadata.warnings.push(`search_by_nearby_keyword returned ${returned.length} of ${total} distance-sorted results; use a higher limit or narrower filter for more candidates.`);
+  }
+  if (metadata.warnings?.length === 0) delete metadata.warnings;
+  return {
+    ...result,
+    results: returned,
+    metadata
+  };
+}
+function normalizeLimit(limit) {
+  if (limit === void 0) return void 0;
+  if (!Number.isFinite(limit)) return void 0;
+  return Math.min(200, Math.max(1, Math.floor(limit)));
+}
+function normalizeOffset(offset) {
+  if (offset === void 0) return 0;
+  if (!Number.isFinite(offset)) return 0;
+  return Math.max(0, Math.floor(offset));
+}
+function isShortNoisyKeyword(query) {
+  const compact = query.replace(/\s+/g, "");
+  if (!compact) return false;
+  if (compact.length <= 2) return true;
+  return compact.length <= 3 && /^[A-Za-z0-9]+$/.test(compact);
+}
+async function fetchAllPages2(query, lat, lng, radiusM, env, fetcher, metadata) {
+  const documents = [];
+  for (let page = 1; page <= 3; page += 1) {
+    const url = new URL("https://dapi.kakao.com/v2/local/search/keyword.json");
+    url.searchParams.set("query", query);
+    url.searchParams.set("x", String(lng));
+    url.searchParams.set("y", String(lat));
+    url.searchParams.set("radius", String(radiusM));
+    url.searchParams.set("sort", "distance");
+    url.searchParams.set("page", String(page));
+    url.searchParams.set("size", "15");
+    const response = await fetcher(url.toString(), {
+      headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` }
+    });
+    if (!response.ok) throw new Error(`Kakao keyword API failed: HTTP ${response.status}`);
+    const payload = await readJsonResponse(response);
+    documents.push(...payload.documents ?? []);
+    if (payload.meta?.is_end !== false) break;
+    if (page === 3) {
+      metadata.truncated = true;
+      metadata.warnings ??= [];
+      metadata.warnings.push("Kakao Local API returned the maximum 45 results for at least one query; additional farther results may have been truncated.");
+    }
+  }
+  if (documents.length >= 45) {
+    metadata.truncated = true;
+    metadata.warnings ??= [];
+    const warning = "Kakao Local API returned the maximum 45 results for at least one query; additional farther results may have been truncated.";
+    if (!metadata.warnings.includes(warning)) metadata.warnings.push(warning);
+  }
+  return documents;
+}
+async function fetchGridCells(query, lat, lng, radiusM, env, fetcher, metadata) {
+  const radiusKm = radiusM / 1e3;
+  const cellKm = 1.25;
+  const dLat = 1 / 111;
+  const dLng = 1 / (111 * Math.cos(lat * Math.PI / 180));
+  const steps = Math.max(1, Math.ceil(radiusKm / cellKm));
+  const rects = [];
+  const seen = /* @__PURE__ */ new Map();
+  for (let i = -steps; i < steps; i += 1) {
+    for (let j = -steps; j < steps; j += 1) {
+      const south = lat + i * cellKm * dLat;
+      const north = lat + (i + 1) * cellKm * dLat;
+      const west = lng + j * cellKm * dLng;
+      const east = lng + (j + 1) * cellKm * dLng;
+      rects.push(`${west},${south},${east},${north}`);
+    }
+  }
+  const cellResults = await mapWithConcurrency(rects, KAKAO_GRID_CONCURRENCY, async (rect) => fetchGridCell(query, rect, env, fetcher));
+  let cellsTruncated = 0;
+  for (const result of cellResults) {
+    for (const doc of result.documents) {
+      if (!seen.has(doc.id)) seen.set(doc.id, doc);
+    }
+    if (result.truncated) cellsTruncated += 1;
+  }
+  if (cellsTruncated > 0) {
+    metadata.truncated = true;
+    metadata.warnings ??= [];
+    metadata.warnings.push(`Grid mode: ${cellsTruncated} cell(s) still hit the 45-result cap; narrow cell size or radius for exhaustive coverage in very dense areas.`);
+  }
+  return [...seen.values()];
+}
+async function fetchGridCell(query, rect, env, fetcher) {
+  const documents = [];
+  let truncated = false;
+  for (let page = 1; page <= 3; page += 1) {
+    const url = new URL("https://dapi.kakao.com/v2/local/search/keyword.json");
+    url.searchParams.set("query", query);
+    url.searchParams.set("rect", rect);
+    url.searchParams.set("page", String(page));
+    url.searchParams.set("size", "15");
+    const response = await fetcher(url.toString(), { headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` } });
+    if (!response.ok) throw new Error(`Kakao keyword API failed: HTTP ${response.status}`);
+    const payload = await readJsonResponse(response);
+    documents.push(...payload.documents ?? []);
+    if (payload.meta?.is_end !== false) break;
+    if (page === 3) truncated = true;
+  }
+  return { documents, truncated };
+}
+async function mapWithConcurrency(items, concurrency, mapper) {
+  const results = new Array(items.length);
+  let next = 0;
+  const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+    while (next < items.length) {
+      const current = next;
+      next += 1;
+      results[current] = await mapper(items[current]);
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+function matchesFilter(categoryName, filter) {
+  if (!filter) return true;
+  const includes = filter.include_contains ?? [];
+  const excludes = filter.exclude_contains ?? [];
+  return includes.every((needle) => categoryName.includes(needle)) && !excludes.some((needle) => categoryName.includes(needle));
+}
+function deduplicate(places, deduplicateBy) {
+  if (!deduplicateBy) return places;
+  const seen = /* @__PURE__ */ new Set();
+  const deduped = [];
+  for (const place of places) {
+    const key = deduplicateBy === "name" ? place.name : place.address;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    deduped.push(place);
+  }
+  return deduped;
+}
+function normalizePlace2(doc, centerLat, centerLng) {
+  const lat = Number(doc.y);
+  const lng = Number(doc.x);
+  const distanceM = doc.distance && doc.distance.length > 0 ? Number(doc.distance) : haversineMeters({ lat: centerLat, lng: centerLng }, { lat, lng });
+  return {
+    name: doc.place_name,
+    lat,
+    lng,
+    distance_m: Math.round(distanceM),
+    distance_label: distanceLabel(distanceM),
+    address: doc.road_address_name || doc.address_name,
+    ...doc.road_address_name ? { road_address: doc.road_address_name } : {},
+    kakao_place_id: doc.id,
+    kakao_category_name: doc.category_name
+  };
+}
+
+// src/providers/applyhome.ts
+var APT_ENDPOINT = "https://api.odcloud.kr/api/ApplyhomeInfoDetailSvc/v1/getAPTLttotPblancDetail";
+var RETRY_DELAYS_MS = [25, 50];
+var SUBSCRPT_AREA_CODE_NAMES = {
+  "100": "\uC11C\uC6B8",
+  "200": "\uBD80\uC0B0",
+  "300": "\uB300\uC804",
+  "312": "\uCDA9\uB0A8",
+  "400": "\uC778\uCC9C",
+  "500": "\uAD11\uC8FC",
+  "600": "\uB300\uAD6C",
+  "700": "\uC6B8\uC0B0",
+  "800": "\uC138\uC885",
+  "900": "\uACBD\uAE30"
+};
+async function fetchApplyHomeAptAnnouncements(query, env, fetcher = fetch) {
+  const serviceKey = env.DATA_GO_KR_SERVICE_KEY;
+  if (!serviceKey) {
+    return { rows: [], sources: [], warnings: ["DATA_GO_KR_SERVICE_KEY is missing."] };
+  }
+  const perPage = query.perPage ?? 100;
+  let page = query.page ?? 1;
+  const rows = [];
+  const sources = [];
+  const warnings = [];
+  while (true) {
+    const url = buildApplyHomeAptUrl({ ...query, page, perPage }, serviceKey);
+    sources.push(redactServiceKeyInUrl(url.toString(), serviceKey));
+    let response = await fetcher(url.toString(), { headers: { Accept: "application/json" } });
+    if (!response.ok && response.status === 400 && query.regionCode && !query.regionName && SUBSCRPT_AREA_CODE_NAMES[query.regionCode]) {
+      const regionName = SUBSCRPT_AREA_CODE_NAMES[query.regionCode];
+      warnings.push(`ApplyHome APT region code condition returned HTTP 400; retried with region name ${regionName}.`);
+      const fallbackUrl = buildApplyHomeAptUrl({ ...query, regionCode: void 0, regionName, page, perPage }, serviceKey);
+      sources.push(redactServiceKeyInUrl(fallbackUrl.toString(), serviceKey));
+      response = await fetchWithRetry(fallbackUrl.toString(), fetcher);
+    } else if (!response.ok) {
+      response = await retryAfterInitialResponse(url.toString(), fetcher, response);
+    }
+    if (!response.ok) {
+      warnings.push(`ApplyHome APT API failed: HTTP ${response.status}`);
+      break;
+    }
+    const payload = await readJsonResponse(response);
+    const pageRows = Array.isArray(payload.data) ? payload.data : [];
+    rows.push(...pageRows);
+    const totalCount = Number(payload.totalCount ?? pageRows.length);
+    const responsePerPage = Number(payload.perPage ?? perPage);
+    const responsePage = Number(payload.page ?? page);
+    if (responsePage * responsePerPage >= totalCount || pageRows.length === 0) break;
+    page += 1;
+  }
+  return { rows, sources, warnings };
+}
+async function fetchWithRetry(url, fetcher) {
+  const response = await fetcher(url, { headers: { Accept: "application/json" } });
+  return retryAfterInitialResponse(url, fetcher, response);
+}
+async function retryAfterInitialResponse(url, fetcher, initialResponse) {
+  let response = initialResponse;
+  for (const delayMs of RETRY_DELAYS_MS) {
+    if (response.ok) return response;
+    await sleep(delayMs);
+    response = await fetcher(url, { headers: { Accept: "application/json" } });
+  }
+  return response;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function buildApplyHomeAptUrl(query, serviceKey) {
+  const url = new URL(APT_ENDPOINT);
+  url.searchParams.set("page", String(query.page));
+  url.searchParams.set("perPage", String(query.perPage));
+  url.searchParams.set("cond[RCRIT_PBLANC_DE::GTE]", query.dateFrom);
+  if (query.dateTo) url.searchParams.set("cond[RCRIT_PBLANC_DE::LTE]", query.dateTo);
+  if (query.regionCode) url.searchParams.set("cond[SUBSCRPT_AREA_CODE::EQ]", query.regionCode);
+  if (query.regionName) url.searchParams.set("cond[SUBSCRPT_AREA_CODE_NM::EQ]", query.regionName);
+  if (query.applyAddress) url.searchParams.set("cond[HSSPLY_ADRES::LIKE]", query.applyAddress);
+  if (query.houseName) url.searchParams.set("cond[HOUSE_NM::LIKE]", query.houseName);
+  url.searchParams.set("serviceKey", serviceKey);
+  return url;
+}
+function redactServiceKeyInUrl(sourceUrl, serviceKey) {
+  const variants = /* @__PURE__ */ new Set();
+  if (serviceKey) {
+    variants.add(serviceKey);
+    variants.add(encodeURIComponent(serviceKey));
+    try {
+      variants.add(decodeURIComponent(serviceKey));
+    } catch {
+    }
+  }
+  let redacted = sourceUrl.replace(/([?&]serviceKey=)[^&]*/g, "$1{SERVICE_KEY}");
+  for (const variant of variants) {
+    if (!variant) continue;
+    redacted = redacted.split(variant).join("{SERVICE_KEY}");
+  }
+  return redacted;
+}
+
+// src/providers/kakao-region.ts
+async function getRegionNameForCoordinate(point, env, fetcher = fetch) {
+  if (!env.KAKAO_REST_API_KEY) {
+    return { warning: "KAKAO_REST_API_KEY is missing; coordinate/radius region sampling is unavailable." };
+  }
+  const url = new URL("https://dapi.kakao.com/v2/local/geo/coord2regioncode.json");
+  url.searchParams.set("x", String(point.lng));
+  url.searchParams.set("y", String(point.lat));
+  const response = await fetcher(url.toString(), {
+    headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` }
+  });
+  if (!response.ok) {
+    return { warning: `Kakao coord2regioncode failed: HTTP ${response.status}` };
+  }
+  const payload = await readJsonResponse(response);
+  const document = payload.documents?.find((item) => item.region_type === "B") ?? payload.documents?.[0];
+  if (!document) return { warning: "Kakao coord2regioncode returned no region document." };
+  const parts = [document.region_1depth_name, document.region_2depth_name, document.region_3depth_name, document.region_4depth_name].map((part) => part?.trim()).filter((part) => Boolean(part));
+  return parts.length ? { regionName: parts.join(" ") } : { warning: "Kakao coord2regioncode region document had no region names." };
+}
+function expandRegionNameQueries(regionName) {
+  const parts = regionName.split(/\s+/).filter(Boolean);
+  const queries = /* @__PURE__ */ new Set();
+  if (parts.length >= 3) queries.add(parts.slice(0, 3).join(" "));
+  if (parts.length >= 2) queries.add(parts.slice(0, 2).join(" "));
+  queries.add(regionName);
+  return [...queries];
+}
+
+// src/resolve/name.ts
+var SIM_MIN = 0.7;
+var GAP = 0.1;
+var MAX_CANDIDATES = 5;
+var BRAND_MAP = [
+  [/skview/g, "sk\uBDF0"],
+  [/푸르지오|prugio/g, "prugio"],
+  [/아이파크|ipark/g, "ipark"],
+  [/힐스테이트|hillstate/g, "hillstate"],
+  [/래미안/g, "\uB798\uBBF8\uC548"],
+  [/캐슬|castle/g, "castle"],
+  [/자이|xi/g, "xi"],
+  [/위브|weve/g, "weve"],
+  [/sk뷰/g, "sk\uBDF0"],
+  [/뷰|view/g, "view"],
+  [/이편한세상|e편한세상/g, "\uC774\uD3B8\uD55C\uC138\uC0C1"],
+  [/the/g, "\uB354"]
+];
+var SIDE_TOKENS = /(아파트|apt|견본주택|모델하우스|분양사무소)/g;
+var ROMAN = [
+  [/Ⅹ|ⅹ/g, "10"],
+  [/Ⅸ|ⅸ/g, "9"],
+  [/Ⅷ|ⅷ/g, "8"],
+  [/Ⅶ|ⅶ/g, "7"],
+  [/Ⅵ|ⅵ/g, "6"],
+  [/Ⅴ|ⅴ/g, "5"],
+  [/Ⅳ|ⅳ/g, "4"],
+  [/Ⅲ|ⅲ/g, "3"],
+  [/Ⅱ|ⅱ/g, "2"],
+  [/Ⅰ|ⅰ/g, "1"]
+];
+var ALPHA_KO = {
+  a: "\uC5D0\uC774",
+  b: "\uBE44",
+  c: "\uC528",
+  d: "\uB514",
+  e: "\uC774",
+  f: "\uC5D0\uD504",
+  g: "\uC9C0",
+  h: "\uC5D0\uC774\uCE58",
+  i: "\uC544\uC774",
+  j: "\uC81C\uC774",
+  k: "\uCF00\uC774",
+  l: "\uC5D8",
+  m: "\uC5E0",
+  n: "\uC5D4",
+  o: "\uC624",
+  p: "\uD53C",
+  q: "\uD050",
+  r: "\uC54C",
+  s: "\uC5D0\uC2A4",
+  t: "\uD2F0",
+  u: "\uC720",
+  v: "\uBE0C\uC774",
+  w: "\uB354\uBE14\uC720",
+  x: "\uC5D1\uC2A4",
+  y: "\uC640\uC774",
+  z: "\uC9C0"
+};
+function normalizeComplexName(name) {
+  let n = name.toLowerCase();
+  for (const [re, rep] of ROMAN) n = n.replace(re, rep);
+  n = n.replace(/\([^)]*\)/g, "");
+  n = n.replace(/[\s\-·.,()[\]{}]/g, "");
+  n = n.replace(/[a-z](?=\d+bl)/g, "");
+  for (const [re, rep] of BRAND_MAP) n = n.replace(re, rep);
+  n = n.replace(/(?<![a-z])[a-z](?![a-z])/g, (ch) => ALPHA_KO[ch] ?? ch);
+  n = n.replace(SIDE_TOKENS, "");
+  return n;
+}
+var CHO = ["\u3131", "\u3132", "\u3134", "\u3137", "\u3138", "\u3139", "\u3141", "\u3142", "\u3143", "\u3145", "\u3146", "\u3147", "\u3148", "\u3149", "\u314A", "\u314B", "\u314C", "\u314D", "\u314E"];
+var JUNG = ["\u314F", "\u3150", "\u3151", "\u3152", "\u3153", "\u3154", "\u3155", "\u3156", "\u3157", "\u3158", "\u3159", "\u315A", "\u315B", "\u315C", "\u315D", "\u315E", "\u315F", "\u3160", "\u3161", "\u3162", "\u3163"];
+var JONG = ["", "\u3131", "\u3132", "\u3133", "\u3134", "\u3135", "\u3136", "\u3137", "\u3139", "\u313A", "\u313B", "\u313C", "\u313D", "\u313E", "\u313F", "\u3140", "\u3141", "\u3142", "\u3144", "\u3145", "\u3146", "\u3147", "\u3148", "\u314A", "\u314B", "\u314C", "\u314D", "\u314E"];
+function decomposeJamo(text3) {
+  let out = "";
+  for (const ch of text3) {
+    const code = ch.charCodeAt(0);
+    if (code >= 44032 && code <= 55203) {
+      const offset = code - 44032;
+      const cho = Math.floor(offset / 588);
+      const jung = Math.floor(offset % 588 / 28);
+      const jong = offset % 28;
+      out += CHO[cho] + JUNG[jung] + JONG[jong];
+    } else {
+      out += ch;
+    }
+  }
+  return out;
+}
+function complexNameSimilarity(a, b, opts = {}) {
+  const normalizedA = opts.aNormalized ? a : normalizeComplexName(a);
+  const normalizedB = opts.bNormalized ? b : normalizeComplexName(b);
+  const na = decomposeJamo(normalizedA);
+  const nb = decomposeJamo(normalizedB);
+  if (!na && !nb) return 1;
+  if (!na || !nb) return 0;
+  if (na === nb) return 1;
+  const dist = levenshtein(na, nb);
+  const editSim = 1 - dist / Math.max(na.length, nb.length);
+  const [shorter, longer] = na.length <= nb.length ? [na, nb] : [nb, na];
+  const containSim = longer.includes(shorter) ? 0.9 + 0.1 * (shorter.length / longer.length) : 0;
+  const diceSim = reorderedNameDiceSimilarity(normalizedA, normalizedB);
+  const sim = Math.max(editSim, containSim, diceSim);
+  return capNumericMismatchSimilarity(normalizedA, normalizedB, sim);
+}
+function reorderedNameDiceSimilarity(a, b) {
+  const minLen = Math.min(a.length, b.length);
+  const maxLen = Math.max(a.length, b.length);
+  if (minLen < 6 || minLen / maxLen < 0.6) return 0;
+  return diceSimilarity(charNgrams(a, 2), charNgrams(b, 2));
+}
+function charNgrams(value, n) {
+  if (value.length <= n) return [value];
+  const grams = [];
+  for (let i = 0; i <= value.length - n; i += 1) {
+    grams.push(value.slice(i, i + n));
+  }
+  return grams;
+}
+function diceSimilarity(a, b) {
+  if (a.length === 0 && b.length === 0) return 1;
+  if (a.length === 0 || b.length === 0) return 0;
+  const counts = /* @__PURE__ */ new Map();
+  for (const gram of a) counts.set(gram, (counts.get(gram) ?? 0) + 1);
+  let intersection = 0;
+  for (const gram of b) {
+    const count = counts.get(gram) ?? 0;
+    if (count <= 0) continue;
+    intersection += 1;
+    counts.set(gram, count - 1);
+  }
+  return 2 * intersection / (a.length + b.length);
+}
+function capNumericMismatchSimilarity(a, b, sim) {
+  const aNumbers = numericTokens(a);
+  const bNumbers = numericTokens(b);
+  if (aNumbers.length === 0 || bNumbers.length === 0) return sim;
+  if (aNumbers.join(",") === bNumbers.join(",")) return sim;
+  return Math.min(sim, SIM_MIN - 0.01);
+}
+function numericTokens(value) {
+  return [...value.matchAll(/\d+/g)].map((match) => match[0]);
+}
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i = 0; i <= m; i += 1) dp[i][0] = i;
+  for (let j = 0; j <= n; j += 1) dp[0][j] = j;
+  for (let i = 1; i <= m; i += 1) {
+    for (let j = 1; j <= n; j += 1) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+    }
+  }
+  return dp[m][n];
+}
+function scoreAndDecide(query, items) {
+  const nq = normalizeComplexName(query);
+  const scored = items.filter((it) => it.code && it.name).map((it) => ({
+    code: it.code,
+    name: it.name,
+    ...it.address_road ? { address_road: it.address_road } : {},
+    sim: complexNameSimilarity(it.name, nq, { bNormalized: true })
+  })).sort((a, b) => b.sim - a.sim);
+  const top = scored[0];
+  if (!top || top.sim < SIM_MIN) {
+    return { status: "not_found", candidates: scored.slice(0, MAX_CANDIDATES) };
+  }
+  if (top.sim >= 0.9999) {
+    return { status: "confirmed", code: top.code, name: top.name, match: "exact", sim: top.sim, candidates: scored.slice(0, MAX_CANDIDATES) };
+  }
+  const second = scored[1];
+  const gap = second ? top.sim - second.sim : top.sim;
+  if (gap < GAP) {
+    return { status: "ambiguous", candidates: scored.slice(0, MAX_CANDIDATES) };
+  }
+  return { status: "confirmed", code: top.code, name: top.name, match: "approximate", sim: top.sim, candidates: scored.slice(0, MAX_CANDIDATES) };
+}
+
+// src/tools/presale-announcements.ts
+var MAX_GEOCODE_CALLS = 200;
+var MAX_PROVIDER_QUERIES = 30;
+var DEFAULT_PROVIDER_CONCURRENCY = 6;
+var DEFAULT_PROVIDER_TIMEOUT_MS = 8e3;
+var MAX_METADATA_SOURCES = 5;
+var DEFAULT_GEOCODE_CONCURRENCY = 6;
+var DEFAULT_GEOCODE_TIMEOUT_MS = 5e3;
+var DEFAULT_GEOCODE_DEADLINE_MS = 75e3;
+function normalizeApplyHomeAptRow(row, today = /* @__PURE__ */ new Date()) {
+  const announcement = {
+    announcement_id: text(row.PBLANC_NO),
+    house_manage_no: text(row.HOUSE_MANAGE_NO),
+    type: "apt",
+    type_label: "APT \uC77C\uBC18\uBD84\uC591",
+    name: text(row.HOUSE_NM),
+    address: text(row.HSSPLY_ADRES),
+    region: {
+      ...optionalText(row.SUBSCRPT_AREA_CODE) ? { sido_code: optionalText(row.SUBSCRPT_AREA_CODE) } : {},
+      ...optionalText(row.SUBSCRPT_AREA_CODE_NM) ? { sido_name: optionalText(row.SUBSCRPT_AREA_CODE_NM) } : {},
+      ...parseSigungu(text(row.HSSPLY_ADRES)) ? { sigungu: parseSigungu(text(row.HSSPLY_ADRES)) } : {}
+    },
+    dates: buildDates(row, today),
+    regulations: {
+      ...optionalBool(row.SPECLT_RDN_EARTH_AT) !== void 0 ? { speculation_overheat: optionalBool(row.SPECLT_RDN_EARTH_AT) } : {},
+      ...optionalText(row.MDAT_TRGET_AREA_SECD) ? { adjustment_target: optionalText(row.MDAT_TRGET_AREA_SECD) } : {},
+      ...optionalBool(row.PARCPRC_ULS_AT) !== void 0 ? { price_ceiling: optionalBool(row.PARCPRC_ULS_AT) } : {},
+      ...optionalBool(row.IMPRMN_BSNS_AT) !== void 0 ? { improvement_project: optionalBool(row.IMPRMN_BSNS_AT) } : {},
+      ...optionalBool(row.PUBLIC_HOUSE_EARTH_AT) !== void 0 ? { public_house_district: optionalBool(row.PUBLIC_HOUSE_EARTH_AT) } : {},
+      ...optionalBool(row.LRSCL_BLDLND_AT) !== void 0 ? { large_scale_district: optionalBool(row.LRSCL_BLDLND_AT) } : {},
+      ...optionalBool(row.NPLN_PRVOPR_PUBLIC_HOUSE_AT) !== void 0 ? { metropolitan_private: optionalBool(row.NPLN_PRVOPR_PUBLIC_HOUSE_AT) } : {},
+      ...optionalBool(row.PUBLIC_HOUSE_SPCLM_APPLC_APT) !== void 0 ? { public_house_special: optionalBool(row.PUBLIC_HOUSE_SPCLM_APPLC_APT) } : {}
+    },
+    status: calculatePresaleStatus(row, today)
+  };
+  addOptional(announcement, "address_zip", row.HSSPLY_ZIP);
+  addOptionalNumber(announcement, "total_units", row.TOT_SUPLY_HSHLDCO);
+  addOptional(announcement, "developer", row.BSNS_MBY_NM);
+  addOptional(announcement, "constructor", row.CNSTRCT_ENTRPS_NM);
+  addOptional(announcement, "contact_tel", row.MDHS_TELNO);
+  addOptional(announcement, "homepage_url", row.HMPG_ADRES);
+  addOptional(announcement, "newspaper", row.NSPRC_NM);
+  addOptional(announcement, "house_type", row.HOUSE_SECD_NM);
+  addOptional(announcement, "detail_type", row.HOUSE_DTL_SECD_NM);
+  addOptional(announcement, "rent_type", row.RENT_SECD_NM);
+  addOptional(announcement, "official_url", row.PBLANC_URL);
+  return announcement;
+}
+function calculatePresaleStatus(row, today = /* @__PURE__ */ new Date()) {
+  const day = dateOnly(today);
+  const subscriptionStart = minDate([row.SPSPLY_RCEPT_BGNDE, row.GNRL_RNK1_CRSPAREA_RCPTDE, row.GNRL_RNK1_ETC_GG_RCPTDE, row.GNRL_RNK1_ETC_AREA_RCPTDE, row.GNRL_RNK2_CRSPAREA_RCPTDE, row.GNRL_RNK2_ETC_GG_RCPTDE, row.GNRL_RNK2_ETC_AREA_RCPTDE]);
+  const subscriptionEnd = maxDate([row.SPSPLY_RCEPT_ENDDE, row.GNRL_RNK1_CRSPAREA_ENDDE, row.GNRL_RNK1_ETC_GG_ENDDE, row.GNRL_RNK1_ETC_AREA_ENDDE, row.GNRL_RNK2_CRSPAREA_ENDDE, row.GNRL_RNK2_ETC_GG_ENDDE, row.GNRL_RNK2_ETC_AREA_ENDDE]);
+  const contractStart = parseDate(row.CNTRCT_CNCLS_BGNDE);
+  const contractEnd = parseDate(row.CNTRCT_CNCLS_ENDDE);
+  if (!subscriptionStart && !subscriptionEnd && !contractStart && !contractEnd) return "\uC0C1\uD0DC\uBBF8\uC0C1";
+  if (subscriptionStart && day < subscriptionStart) return "\uBD84\uC591\uC608\uC815";
+  if (subscriptionStart && subscriptionEnd && day >= subscriptionStart && day <= subscriptionEnd) return "\uBD84\uC591\uC911";
+  if (contractStart && contractEnd && day >= contractStart && day <= contractEnd) return "\uACC4\uC57D\uC9C4\uD589";
+  if (contractEnd && day > contractEnd) return "\uBD84\uC591\uC644\uB8CC";
+  if (subscriptionEnd && day > subscriptionEnd) return "\uCCAD\uC57D\uC644\uB8CC";
+  return "\uC0C1\uD0DC\uBBF8\uC0C1";
+}
+async function searchPresaleAnnouncements(input, env, deps = {}) {
+  const today = deps.today ?? /* @__PURE__ */ new Date();
+  const monthsBack = clampInt(input.months_back ?? 24, 1, 180);
+  const radiusKm = clampInt(input.radius_km ?? 5, 1, 20);
+  const dateRange = resolveDateRange(input, today, monthsBack);
+  const warnings = [];
+  const sources = [];
+  const bestEffortRadius = input.center_lat !== void 0 && input.center_lng !== void 0;
+  let providerQueryDiscoveredCount = 0;
+  let providerQueryCount = 0;
+  let providerQueryOmittedCount = 0;
+  let providerCacheHits = 0;
+  let providerQueryFailedCount = 0;
+  let providerQueryTimeoutCount = 0;
+  let geocodeStats = emptyGeocodeStats(deps);
+  const resultLimit = normalizeResultLimit(input.limit);
+  const baseResult = () => {
+    const sourceCount = sources.length;
+    const metadataSources = sources.slice(0, MAX_METADATA_SOURCES);
+    if (sourceCount > metadataSources.length) {
+      pushUnique(warnings, `ApplyHome sources trimmed to ${metadataSources.length} representative URL(s); source_count=${sourceCount}.`);
+    }
+    return {
+      input: buildInput(input, radiusKm, monthsBack, dateRange),
+      announcements: [],
+      unlocated_announcements: [],
+      summary: { total_found: 0, geocoded: 0, within_radius: bestEffortRadius ? 0 : null, unlocated: 0, by_status: {} },
+      metadata: {
+        cache_hit: false,
+        collected_at: nowIso(),
+        data_source: "applyhome_apt",
+        date_from: dateRange.dateFrom,
+        ...dateRange.dateTo ? { date_to: dateRange.dateTo } : {},
+        best_effort_radius: bestEffortRadius,
+        sources: metadataSources,
+        source_count: sourceCount,
+        provider_query_count: providerQueryCount,
+        provider_query_discovered_count: providerQueryDiscoveredCount,
+        provider_query_omitted_count: providerQueryOmittedCount,
+        provider_query_truncated: providerQueryOmittedCount > 0,
+        provider_query_failed_count: providerQueryFailedCount,
+        provider_query_timeout_count: providerQueryTimeoutCount,
+        partial: providerQueryFailedCount > 0 || geocodeStats.timeoutCount > 0 || geocodeStats.skippedCount > 0,
+        geocode_attempted_count: geocodeStats.attemptedCount,
+        geocode_timeout_count: geocodeStats.timeoutCount,
+        geocode_skipped_count: geocodeStats.skippedCount,
+        geocode_deadline_ms: geocodeStats.deadlineMs,
+        geocode_concurrency: geocodeStats.concurrency,
+        geocode_timeout_ms: geocodeStats.timeoutMs,
+        returned_count: 0,
+        omitted_count: 0,
+        result_limit: resultLimit,
+        truncated: false,
+        ...warnings.length ? { warnings } : {}
+      }
+    };
+  };
+  if (!input.house_name && !input.apply_address && !input.region_codes?.length && !bestEffortRadius) {
+    warnings.push("At least one search criterion is required: house_name, region_codes, apply_address, or center coordinates.");
+    return baseResult();
+  }
+  if (bestEffortRadius) {
+    warnings.push("Coordinate/radius ApplyHome search is best-effort because ApplyHome does not support radius search; boundary legal-dong omissions are possible.");
+  }
+  const discoveredProviderQueries = await buildProviderQueries(input, env, deps, dateRange, radiusKm, warnings);
+  providerQueryDiscoveredCount = discoveredProviderQueries.length;
+  const providerQueries = discoveredProviderQueries.slice(0, MAX_PROVIDER_QUERIES);
+  providerQueryCount = providerQueries.length;
+  providerQueryOmittedCount = Math.max(0, discoveredProviderQueries.length - providerQueries.length);
+  if (providerQueryOmittedCount > 0) {
+    warnings.push(`\uBC95\uC815\uB3D9 ${discoveredProviderQueries.length}\uAC1C \uC911 ${providerQueries.length}\uAC1C\uB9CC \uC870\uD68C\uD588\uC2B5\uB2C8\uB2E4. \uBC18\uACBD \uACBD\uACC4\uC758 \uBD84\uC591 \uACF5\uACE0\uAC00 \uB204\uB77D\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`);
+  }
+  const rawRows = [];
+  const providerResults = await mapWithConcurrency2(providerQueries, normalizeConcurrency(deps.providerConcurrency), (query) => fetchApplyHomeAptAnnouncementsCached(query, env, deps));
+  for (const { result: providerResult, cacheHit, timedOut, failed } of providerResults) {
+    if (cacheHit) providerCacheHits += 1;
+    if (timedOut) providerQueryTimeoutCount += 1;
+    if (failed) providerQueryFailedCount += 1;
+    rawRows.push(...providerResult.rows);
+    sources.push(...providerResult.sources);
+    warnings.push(...providerResult.warnings);
+  }
+  const uniqueRows = dedupeRows(rawRows);
+  let announcements = uniqueRows.map((row) => normalizeApplyHomeAptRow(row, today));
+  announcements = applyPostFilters(announcements, input);
+  const result = baseResult();
+  if (bestEffortRadius && input.center_lat !== void 0 && input.center_lng !== void 0) {
+    const center = { lat: input.center_lat, lng: input.center_lng };
+    const filtered = await geocodeAndFilterByRadius(announcements, center, radiusKm, env, deps, warnings);
+    geocodeStats = filtered.stats;
+    result.metadata.geocode_attempted_count = geocodeStats.attemptedCount;
+    result.metadata.geocode_timeout_count = geocodeStats.timeoutCount;
+    result.metadata.geocode_skipped_count = geocodeStats.skippedCount;
+    result.metadata.geocode_deadline_ms = geocodeStats.deadlineMs;
+    result.metadata.geocode_concurrency = geocodeStats.concurrency;
+    result.metadata.geocode_timeout_ms = geocodeStats.timeoutMs;
+    result.metadata.partial = result.metadata.partial || geocodeStats.timeoutCount > 0 || geocodeStats.skippedCount > 0;
+    if (warnings.length) result.metadata.warnings = warnings;
+    result.announcements = filtered.announcements;
+    result.unlocated_announcements = filtered.unlocated;
+    result.summary.geocoded = filtered.geocoded;
+    result.summary.within_radius = filtered.announcements.length;
+    result.summary.unlocated = filtered.unlocated.length;
+  } else {
+    result.announcements = announcements;
+  }
+  const fullAnnouncements = result.announcements;
+  result.summary.total_found = fullAnnouncements.length;
+  result.summary.by_status = summarizeStatus(fullAnnouncements);
+  result.announcements = fullAnnouncements.slice(0, resultLimit);
+  const omittedCount = Math.max(0, fullAnnouncements.length - result.announcements.length);
+  if (omittedCount > 0) {
+    result.metadata.truncated = true;
+    result.metadata.warnings = [...result.metadata.warnings ?? [], `search_presale_announcements returned ${result.announcements.length} of ${fullAnnouncements.length} announcements; increase limit or narrow filters for more candidates.`];
+  }
+  result.metadata.returned_count = result.announcements.length;
+  result.metadata.omitted_count = omittedCount;
+  result.metadata.cache_hit = providerQueryCount > 0 && providerCacheHits === providerQueryCount;
+  attachHouseNameNotFoundHint(result, input, dateRange.dateFrom);
+  return result;
+}
+async function fetchApplyHomeAptAnnouncementsCached(query, env, deps) {
+  if (!deps.cache) {
+    const fetched = await fetchApplyHomeProviderQuery(query, env, deps);
+    return { ...fetched, cacheHit: false };
+  }
+  const key = `applyhome:apt:${stableQueryKey(query)}`;
+  const cached = deps.cache.getOrSetWithStatusIf ? await deps.cache.getOrSetWithStatusIf(
+    key,
+    TTL.announcements,
+    () => fetchApplyHomeProviderQuery(query, env, deps),
+    (value) => !value.failed && !value.timedOut
+  ) : await deps.cache.getOrSetWithStatus(
+    key,
+    TTL.announcements,
+    () => fetchApplyHomeProviderQuery(query, env, deps)
+  );
+  return { ...cached.value, cacheHit: cached.hit };
+}
+async function fetchApplyHomeProviderQuery(query, env, deps) {
+  const timeoutMs = normalizeTimeoutMs(deps.providerTimeoutMs);
+  try {
+    const result = await withTimeout(fetchApplyHomeAptAnnouncements(query, env, deps.fetcher), timeoutMs);
+    const failed = result.warnings.some((warning) => warning.startsWith("ApplyHome APT API failed:"));
+    return { result, failed, timedOut: false };
+  } catch (error) {
+    const timedOut = error instanceof Error && error.message === "PROVIDER_TIMEOUT";
+    const warning = timedOut ? `ApplyHome provider query timed out after ${timeoutMs}ms: ${describeApplyHomeQuery(query)}.` : `ApplyHome provider query failed: ${error instanceof Error ? error.message : String(error)}.`;
+    return { result: { rows: [], sources: [], warnings: [warning] }, failed: true, timedOut };
+  }
+}
+function stableQueryKey(query) {
+  return JSON.stringify({
+    dateFrom: query.dateFrom,
+    dateTo: query.dateTo ?? "",
+    regionCode: query.regionCode ?? "",
+    regionName: query.regionName ?? "",
+    applyAddress: query.applyAddress ?? "",
+    houseName: query.houseName ?? "",
+    page: query.page ?? 1,
+    perPage: query.perPage ?? 100
+  });
+}
+async function mapWithConcurrency2(items, concurrency, mapper) {
+  const results = new Array(items.length);
+  let next = 0;
+  const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+    while (next < items.length) {
+      const current = next;
+      next += 1;
+      results[current] = await mapper(items[current]);
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+function normalizeConcurrency(value) {
+  if (value === void 0 || !Number.isFinite(value)) return DEFAULT_PROVIDER_CONCURRENCY;
+  return Math.min(10, Math.max(1, Math.floor(value)));
+}
+function normalizeTimeoutMs(value) {
+  if (value === void 0 || !Number.isFinite(value)) return DEFAULT_PROVIDER_TIMEOUT_MS;
+  return Math.min(3e4, Math.max(1, Math.floor(value)));
+}
+function normalizeGeocodeConcurrency(value) {
+  if (value === void 0 || !Number.isFinite(value)) return DEFAULT_GEOCODE_CONCURRENCY;
+  return Math.min(12, Math.max(1, Math.floor(value)));
+}
+function normalizeGeocodeTimeoutMs(value) {
+  if (value === void 0 || !Number.isFinite(value)) return DEFAULT_GEOCODE_TIMEOUT_MS;
+  return Math.min(3e4, Math.max(1, Math.floor(value)));
+}
+function normalizeGeocodeDeadlineMs(value) {
+  if (value === void 0 || !Number.isFinite(value)) return DEFAULT_GEOCODE_DEADLINE_MS;
+  return Math.min(18e4, Math.max(1, Math.floor(value)));
+}
+function normalizeResultLimit(value) {
+  if (value === void 0 || !Number.isFinite(value)) return 30;
+  return Math.min(100, Math.max(1, Math.floor(value)));
+}
+async function withTimeout(promise, timeoutMs) {
+  let timeoutId;
+  const timeout = new Promise((_resolve, reject) => {
+    timeoutId = setTimeout(() => reject(new Error("PROVIDER_TIMEOUT")), timeoutMs);
+  });
+  try {
+    return await Promise.race([promise, timeout]);
+  } finally {
+    if (timeoutId !== void 0) clearTimeout(timeoutId);
+  }
+}
+function describeApplyHomeQuery(query) {
+  return query.houseName ?? query.applyAddress ?? query.regionName ?? query.regionCode ?? "all";
+}
+function pushUnique(values, value) {
+  if (!values.includes(value)) values.push(value);
+}
+function attachHouseNameNotFoundHint(result, input, dateFrom) {
+  if (!input.house_name || result.summary.total_found > 0) return;
+  const warning = "house_name \uAC80\uC0C9 \uACB0\uACFC\uAC00 0\uAC74\uC785\uB2C8\uB2E4. \uB2E8\uC9C0\uBA85 \uD45C\uAE30\uAC00 \uCCAD\uC57D\uD648\uACFC \uB2E4\uB97C \uC218 \uC788\uC73C\uB2C8 get_address \u2192 get_region_code \uD6C4 \uC9C0\uC5ED/\uBC18\uACBD \uAC80\uC0C9\uC73C\uB85C \uC7AC\uC870\uD68C\uD558\uC138\uC694.";
+  const warnings = result.metadata.warnings ?? [];
+  if (!warnings.includes(warning)) result.metadata.warnings = [...warnings, warning];
+  result.next = {
+    reason: "HOUSE_NAME_NOT_FOUND",
+    message: "\uB2E8\uC9C0\uBA85\uB9CC\uC73C\uB85C \uCCAD\uC57D\uD648 HOUSE_NM LIKE \uAC80\uC0C9\uC774 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uC7A5\uC18C\uBA85\uC73C\uB85C \uC8FC\uC18C/\uC88C\uD45C\uB97C \uBA3C\uC800 \uD655\uC815\uD55C \uB4A4, \uBC95\uC815\uB3D9/\uBC18\uACBD \uAE30\uBC18\uC73C\uB85C \uC7AC\uC870\uD68C\uD558\uACE0 \uACB0\uACFC\uB97C \uB2E8\uC9C0\uBA85\uC73C\uB85C \uD544\uD130\uB9C1\uD558\uC138\uC694.",
+    suggested_tool_chain: ["get_address", "get_region_code", "search_presale_announcements"],
+    get_address: { query: input.house_name },
+    get_region_code: { query: "<address from get_address>" },
+    search_presale_announcements: {
+      recommended_args: {
+        center_lat: "<lat from get_address>",
+        center_lng: "<lng from get_address>",
+        radius_km: input.radius_km ?? 5,
+        date_from: dateFrom,
+        move_in_from: "2018-01"
+      },
+      note: "PDF 13\uD398\uC774\uC9C0 \uAC19\uC740 \uC2DC\uC7A5\uAD8C \uAC80\uC99D\uC740 \uB2E8\uC9C0\uBA85 \uB2E8\uAC74 \uC870\uD68C\uBCF4\uB2E4 \uC0AC\uC5C5\uC9C0 \uC911\uC2EC \uC88C\uD45C+\uBC18\uACBD 5km+move_in_from=2018-01 \uBC29\uC2DD\uC73C\uB85C \uD6C4\uBCF4\uAD70\uC744 \uB9CC\uB4E4\uACE0, \uACF5\uACE0 \uBAA9\uB85D\uC758 \uC138\uB300\uC218\xB7\uC77C\uC815\xB7\uC704\uCE58 \uAE30\uC900\uC73C\uB85C \uD6C4\uC18D \uAC80\uC99D\uC744 \uC774\uC5B4\uAC00\uB294 \uD3B8\uC774 \uC548\uC804\uD569\uB2C8\uB2E4."
+    }
+  };
+}
+async function buildProviderQueries(input, env, deps, dateRange, radiusKm, warnings) {
+  const base = { dateFrom: dateRange.dateFrom, ...dateRange.dateTo ? { dateTo: dateRange.dateTo } : {} };
+  if (input.house_name) return [{ ...base, houseName: input.house_name }];
+  if (input.region_codes?.length) return input.region_codes.map((regionCode) => ({ ...base, regionCode }));
+  if (input.apply_address) return [{ ...base, applyAddress: input.apply_address }];
+  if (input.center_lat !== void 0 && input.center_lng !== void 0) {
+    const points = samplePoints({ lat: input.center_lat, lng: input.center_lng }, radiusKm);
+    const resolver = deps.regionResolver ?? ((point) => getRegionNameForCoordinate(point, env, deps.fetcher));
+    const querySet = /* @__PURE__ */ new Set();
+    for (const point of points) {
+      const resolved = await resolver(point);
+      if (resolved.warning) warnings.push(resolved.warning);
+      if (resolved.regionName) {
+        for (const query of expandRegionNameQueries(resolved.regionName)) {
+          querySet.add(query);
+        }
+      }
+    }
+    return [...querySet].map((applyAddress) => ({ ...base, applyAddress }));
+  }
+  return [{ ...base }];
+}
+function emptyGeocodeStats(deps) {
+  return {
+    attemptedCount: 0,
+    timeoutCount: 0,
+    skippedCount: 0,
+    deadlineMs: normalizeGeocodeDeadlineMs(deps.geocodeDeadlineMs),
+    concurrency: normalizeGeocodeConcurrency(deps.geocodeConcurrency),
+    timeoutMs: normalizeGeocodeTimeoutMs(deps.geocodeTimeoutMs)
+  };
+}
+async function geocodeAndFilterByRadius(announcements, center, radiusKm, env, deps, warnings) {
+  const geocoder = deps.geocoder ?? (async (address) => {
+    const result = await getGeocode({ address }, env, deps.fetcher, { skipRegionCode: true, ...deps.cache ? { cache: deps.cache } : {} });
+    return "lat" in result ? result : {};
+  });
+  const within = [];
+  const unlocated = [];
+  let geocoded = 0;
+  const stats = emptyGeocodeStats(deps);
+  const startedAt = Date.now();
+  const deadlineAt = startedAt + stats.deadlineMs;
+  let next = 0;
+  const workers = Array.from({ length: Math.min(stats.concurrency, announcements.length) }, async () => {
+    while (true) {
+      const current = next;
+      next += 1;
+      const announcement = announcements[current];
+      if (!announcement) return;
+      if (stats.attemptedCount >= MAX_GEOCODE_CALLS || Date.now() >= deadlineAt) {
+        stats.skippedCount += 1;
+        unlocated.push(announcement);
+        continue;
+      }
+      stats.attemptedCount += 1;
+      let resolved = null;
+      try {
+        const remainingMs = Math.max(1, deadlineAt - Date.now());
+        resolved = await withTimeout(resolvePresaleLocation(announcement, geocoder, env, deps.fetcher ?? fetch), Math.min(stats.timeoutMs, remainingMs));
+      } catch (error) {
+        if (error instanceof Error && error.message === "PROVIDER_TIMEOUT") {
+          stats.timeoutCount += 1;
+          warnings.push(`Presale geocoding timed out after ${stats.timeoutMs}ms: ${announcement.name}.`);
+        } else {
+          warnings.push(`Presale geocoding failed: ${announcement.name} (${error instanceof Error ? error.message : String(error)}).`);
+        }
+      }
+      if (!resolved) {
+        unlocated.push(announcement);
+        continue;
+      }
+      geocoded += 1;
+      const distanceM = haversineMeters(center, { lat: resolved.lat, lng: resolved.lng });
+      if (distanceM <= radiusKm * 1e3) {
+        within.push({
+          ...announcement,
+          lat: resolved.lat,
+          lng: resolved.lng,
+          distance_m: distanceM,
+          distance_label: distanceLabel(distanceM),
+          location_confidence: resolved.confidence,
+          location_source: resolved.source
+        });
+      }
+    }
+  });
+  await Promise.all(workers);
+  if (announcements.length > MAX_GEOCODE_CALLS) {
+    warnings.push(`Coordinate-mode geocoding is capped at ${MAX_GEOCODE_CALLS} announcements; narrow the radius or use apply_address/region_codes for exhaustive results.`);
+  }
+  if (stats.skippedCount > 0) {
+    warnings.push(`Presale geocoding deadline ${stats.deadlineMs}ms reached; ${stats.skippedCount} announcements were moved to unlocated_announcements without geocoding.`);
+  }
+  if (unlocated.length) {
+    warnings.push(
+      `${unlocated.length} announcements could not be geocoded/located and were moved to unlocated_announcements: ${summarizeAnnouncementNames(unlocated)}.`
+    );
+  }
+  within.sort((a, b) => (a.distance_m ?? Number.MAX_SAFE_INTEGER) - (b.distance_m ?? Number.MAX_SAFE_INTEGER));
+  return { announcements: within, unlocated, geocoded, stats };
+}
+function summarizeAnnouncementNames(announcements, limit = 5) {
+  const names = announcements.slice(0, limit).map((announcement) => announcement.name);
+  const remaining = announcements.length - names.length;
+  return remaining > 0 ? `${names.join(", ")} \uC678 ${remaining}\uAC74` : names.join(", ");
+}
+async function resolvePresaleLocation(announcement, geocoder, env, fetcher) {
+  const geo = await geocoder(announcement.address);
+  if ("lat" in geo && "lng" in geo && isTrustworthyGeocode(announcement.address, geo)) {
+    return { lat: geo.lat, lng: geo.lng, confidence: "exact", source: "naver_geocode" };
+  }
+  const kakao = await resolveLocationByKakaoKeyword(announcement, env, fetcher);
+  if (kakao) return { ...kakao, confidence: "kakao_keyword", source: "kakao_keyword" };
+  if (typeof geo.lat !== "number" || typeof geo.lng !== "number") {
+    const dongAddress = extractDongLevelAddress(announcement.address);
+    if (dongAddress && dongAddress !== announcement.address) {
+      const dongGeo = await geocoder(dongAddress);
+      if ("lat" in dongGeo && "lng" in dongGeo && isValidCoordinate(dongGeo.lat, dongGeo.lng)) {
+        return { lat: dongGeo.lat, lng: dongGeo.lng, confidence: "dong_fallback", source: "dong_fallback" };
+      }
+    }
+  }
+  return null;
+}
+function isTrustworthyGeocode(address, geo) {
+  if (typeof geo.lat !== "number" || typeof geo.lng !== "number") return false;
+  if (!isValidCoordinate(geo.lat, geo.lng)) return false;
+  if (geo.confidence && geo.confidence !== "exact") return false;
+  if (isBlockStyleAddress(address)) return isPreciseAddressHit(geo.normalized_address ?? "");
+  return true;
+}
+function isValidCoordinate(lat, lng) {
+  return Number.isFinite(lat) && Number.isFinite(lng) && !(lat === 0 && lng === 0);
+}
+function isBlockStyleAddress(value) {
+  return /(?:^|[\s-])(?:[A-Z]?\d+\s*)?BL\b|블록|지구/u.test(value.toUpperCase());
+}
+function isPreciseAddressHit(value) {
+  return /(?:동|읍|면|가|리)\s+산?\d+(?:-\d+)?\b/u.test(value) || /(?:로|길)\s*\d+(?:-\d+)?\b/u.test(value);
+}
+async function resolveLocationByKakaoKeyword(announcement, env, fetcher) {
+  if (!env.KAKAO_REST_API_KEY) return null;
+  const queryVariants = buildKakaoQueryVariants(announcement.name);
+  const candidates = [];
+  for (const query of queryVariants) {
+    const docs = await searchKakaoKeyword(query, env, fetcher);
+    candidates.push(...docs);
+  }
+  const best = pickBestKakaoCandidate(announcement, candidates);
+  if (!best?.x || !best.y) return null;
+  const lat = Number(best.y);
+  const lng = Number(best.x);
+  return isValidCoordinate(lat, lng) ? { lat, lng } : null;
+}
+async function searchKakaoKeyword(query, env, fetcher) {
+  const url = new URL("https://dapi.kakao.com/v2/local/search/keyword.json");
+  url.searchParams.set("query", query);
+  url.searchParams.set("page", "1");
+  url.searchParams.set("size", "10");
+  const response = await fetcher(url.toString(), { headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` } });
+  if (!response.ok) return [];
+  const payload = await readJsonResponse(response);
+  return payload.documents ?? [];
+}
+function buildKakaoQueryVariants(name) {
+  const stripped = name.replace(/\([^)]*\)/g, " ").replace(/견본주택|모델하우스|분양사무소/gu, " ");
+  const withoutBlockPrefix = stripped.replace(/\b[A-Z](?=\d+\s*BL\b)/giu, "");
+  const withoutBlock = withoutBlockPrefix.replace(/\b\d+\s*BL\b/giu, " ");
+  return uniqueNonEmpty([
+    stripped,
+    withoutBlockPrefix,
+    withoutBlock,
+    stripped.replace(/2/g, "\u2161").replace(/3/g, "\u2162"),
+    stripped.replace(/[ⅠⅡⅢⅣⅤⅥⅦⅧⅨⅩ]/gu, "")
+  ]);
+}
+function pickBestKakaoCandidate(announcement, candidates) {
+  const normalizedName = normalizeComplexName(announcement.name);
+  const deduped = dedupeKakaoCandidates(candidates);
+  const filtered = deduped.filter((candidate) => candidate.place_name && candidate.x && candidate.y).filter((candidate) => !/견본주택|모델하우스|분양사무소|중개/u.test(`${candidate.place_name ?? ""} ${candidate.category_name ?? ""}`)).filter((candidate) => /아파트|오피스텔|주거시설/u.test(`${candidate.place_name ?? ""} ${candidate.category_name ?? ""}`)).map((candidate) => ({
+    candidate,
+    sim: complexNameSimilarity(candidate.place_name ?? "", normalizedName, { bNormalized: true }),
+    regionHit: candidate.address_name && sameSigungu(announcement.address, candidate.address_name) ? 1 : 0
+  })).filter((scored) => scored.sim >= 0.7).sort((a, b) => b.regionHit - a.regionHit || b.sim - a.sim || (a.candidate.place_name ?? "").localeCompare(b.candidate.place_name ?? ""));
+  const first = filtered[0];
+  const second = filtered[1];
+  if (!first) return null;
+  if (second && first.regionHit === second.regionHit && first.sim - second.sim < 0.1) return null;
+  return first.candidate;
+}
+function dedupeKakaoCandidates(candidates) {
+  const seen = /* @__PURE__ */ new Set();
+  const deduped = [];
+  for (const candidate of candidates) {
+    const key = candidate.id || `${candidate.place_name ?? ""}:${candidate.address_name ?? ""}:${candidate.x ?? ""}:${candidate.y ?? ""}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    deduped.push(candidate);
+  }
+  return deduped;
+}
+function sameSigungu(left, right) {
+  const l = sigunguKey(left);
+  const r = sigunguKey(right);
+  return Boolean(l && r && l === r);
+}
+function sigunguKey(address) {
+  const parts = address.split(/\s+/).filter(Boolean);
+  if (parts.length < 2) return void 0;
+  const sido = parts[0];
+  if (!sido) return void 0;
+  if (parts[1]?.endsWith("\uC2DC") && parts[2]?.endsWith("\uAD6C")) return `${sido} ${parts[1]} ${parts[2]}`;
+  return parts[1] ? `${sido} ${parts[1]}` : void 0;
+}
+function uniqueNonEmpty(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const value of values) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    if (!normalized || seen.has(normalized)) continue;
+    seen.add(normalized);
+    result.push(normalized);
+  }
+  return result;
+}
+function extractDongLevelAddress(address) {
+  const tokens = address.split(/\s+/).filter(Boolean);
+  const collected = [];
+  for (const token of tokens) {
+    const cleaned = token.replace(/[(),]/g, "");
+    collected.push(cleaned);
+    if (/[동읍면]$/.test(cleaned) && collected.length >= 3) {
+      return collected.join(" ");
+    }
+  }
+  return void 0;
+}
+function applyPostFilters(announcements, input) {
+  let filtered = announcements;
+  if (input.status_filter?.length) {
+    filtered = filtered.filter((announcement) => input.status_filter?.includes(announcement.status));
+  }
+  if (input.move_in_from || input.move_in_to) {
+    const from = normalizeMonth(input.move_in_from);
+    const to = normalizeMonth(input.move_in_to);
+    filtered = filtered.filter((announcement) => {
+      const moveIn = normalizeMonth(announcement.dates.expected_move_in);
+      if (!moveIn) return false;
+      if (from && moveIn < from) return false;
+      if (to && moveIn > to) return false;
+      return true;
+    });
+  }
+  return filtered;
+}
+function samplePoints(center, radiusKm) {
+  const points = [center];
+  const outerBearings = radiusKm <= 2 ? [0, 90, 180, 270] : [0, 45, 90, 135, 180, 225, 270, 315];
+  for (const bearing of outerBearings) {
+    points.push(destinationPoint(center, radiusKm, bearing));
+  }
+  if (radiusKm > 3) {
+    for (const bearing of [0, 90, 180, 270]) {
+      points.push(destinationPoint(center, radiusKm / 2, bearing));
+    }
+  }
+  return points;
+}
+function destinationPoint(center, distanceKm, bearingDeg) {
+  const radiusKmEarth = 6371;
+  const distanceRatio = distanceKm / radiusKmEarth;
+  const bearing = bearingDeg * Math.PI / 180;
+  const lat1 = center.lat * Math.PI / 180;
+  const lng1 = center.lng * Math.PI / 180;
+  const lat2 = Math.asin(Math.sin(lat1) * Math.cos(distanceRatio) + Math.cos(lat1) * Math.sin(distanceRatio) * Math.cos(bearing));
+  const lng2 = lng1 + Math.atan2(Math.sin(bearing) * Math.sin(distanceRatio) * Math.cos(lat1), Math.cos(distanceRatio) - Math.sin(lat1) * Math.sin(lat2));
+  return { lat: lat2 * 180 / Math.PI, lng: lng2 * 180 / Math.PI };
+}
+function buildInput(input, radiusKm, monthsBack, dateRange) {
+  return {
+    ...input.center_lat !== void 0 && input.center_lng !== void 0 ? { center: { lat: input.center_lat, lng: input.center_lng } } : {},
+    radius_km: radiusKm,
+    months_back: monthsBack,
+    ...input.year ? { year: input.year } : {},
+    date_from: dateRange.dateFrom,
+    ...dateRange.dateTo ? { date_to: dateRange.dateTo } : {},
+    ...input.move_in_from ? { move_in_from: input.move_in_from } : {},
+    ...input.move_in_to ? { move_in_to: input.move_in_to } : {},
+    ...input.region_codes ? { region_codes: input.region_codes } : {},
+    ...input.apply_address ? { apply_address: input.apply_address } : {},
+    ...input.house_name ? { house_name: input.house_name } : {},
+    limit: normalizeResultLimit(input.limit),
+    type: "apt"
+  };
+}
+function resolveDateRange(input, today, monthsBack) {
+  if (input.year) return { dateFrom: `${input.year}-01-01`, dateTo: `${input.year}-12-31` };
+  const explicitFrom = parseDate(input.date_from);
+  const explicitTo = parseDate(input.date_to);
+  return { dateFrom: explicitFrom ?? formatDate(addMonths(today, -monthsBack)), ...explicitTo ? { dateTo: explicitTo } : {} };
+}
+function buildDates(row, today) {
+  const dates = {
+    ...optionalText(row.RCRIT_PBLANC_DE) ? { announcement: optionalText(row.RCRIT_PBLANC_DE) } : {},
+    ...optionalText(row.SPSPLY_RCEPT_BGNDE) ? { special_start: optionalText(row.SPSPLY_RCEPT_BGNDE) } : {},
+    ...optionalText(row.SPSPLY_RCEPT_ENDDE) ? { special_end: optionalText(row.SPSPLY_RCEPT_ENDDE) } : {},
+    ...optionalText(row.PRZWNER_PRESNATN_DE) ? { winner_announcement: optionalText(row.PRZWNER_PRESNATN_DE) } : {},
+    ...optionalText(row.CNTRCT_CNCLS_BGNDE) ? { contract_start: optionalText(row.CNTRCT_CNCLS_BGNDE) } : {},
+    ...optionalText(row.CNTRCT_CNCLS_ENDDE) ? { contract_end: optionalText(row.CNTRCT_CNCLS_ENDDE) } : {},
+    ...optionalText(row.MVN_PREARNGE_YM) ? { expected_move_in: optionalText(row.MVN_PREARNGE_YM) } : {},
+    subscription: {
+      general: {
+        ...optionalText(row.GNRL_RNK1_CRSPAREA_RCPTDE) ? { rank1_local_start: optionalText(row.GNRL_RNK1_CRSPAREA_RCPTDE) } : {},
+        ...optionalText(row.GNRL_RNK1_CRSPAREA_ENDDE) ? { rank1_local_end: optionalText(row.GNRL_RNK1_CRSPAREA_ENDDE) } : {},
+        ...optionalText(row.GNRL_RNK1_ETC_GG_RCPTDE) ? { rank1_gg_start: optionalText(row.GNRL_RNK1_ETC_GG_RCPTDE) } : {},
+        ...optionalText(row.GNRL_RNK1_ETC_GG_ENDDE) ? { rank1_gg_end: optionalText(row.GNRL_RNK1_ETC_GG_ENDDE) } : {},
+        ...optionalText(row.GNRL_RNK1_ETC_AREA_RCPTDE) ? { rank1_etc_start: optionalText(row.GNRL_RNK1_ETC_AREA_RCPTDE) } : {},
+        ...optionalText(row.GNRL_RNK1_ETC_AREA_ENDDE) ? { rank1_etc_end: optionalText(row.GNRL_RNK1_ETC_AREA_ENDDE) } : {},
+        ...optionalText(row.GNRL_RNK2_CRSPAREA_RCPTDE) ? { rank2_local_start: optionalText(row.GNRL_RNK2_CRSPAREA_RCPTDE) } : {},
+        ...optionalText(row.GNRL_RNK2_CRSPAREA_ENDDE) ? { rank2_local_end: optionalText(row.GNRL_RNK2_CRSPAREA_ENDDE) } : {},
+        ...optionalText(row.GNRL_RNK2_ETC_GG_RCPTDE) ? { rank2_gg_start: optionalText(row.GNRL_RNK2_ETC_GG_RCPTDE) } : {},
+        ...optionalText(row.GNRL_RNK2_ETC_GG_ENDDE) ? { rank2_gg_end: optionalText(row.GNRL_RNK2_ETC_GG_ENDDE) } : {},
+        ...optionalText(row.GNRL_RNK2_ETC_AREA_RCPTDE) ? { rank2_etc_start: optionalText(row.GNRL_RNK2_ETC_AREA_RCPTDE) } : {},
+        ...optionalText(row.GNRL_RNK2_ETC_AREA_ENDDE) ? { rank2_etc_end: optionalText(row.GNRL_RNK2_ETC_AREA_ENDDE) } : {}
+      }
+    }
+  };
+  dates.days_until_move_in = monthDiffFromToday(row.MVN_PREARNGE_YM, today);
+  dates.days_until_close = dayDiff(row.GNRL_RNK2_CRSPAREA_ENDDE ?? row.SPSPLY_RCEPT_ENDDE, today);
+  return dates;
+}
+function dedupeRows(rows) {
+  const seen = /* @__PURE__ */ new Set();
+  return rows.filter((row) => {
+    const key = `${text(row.PBLANC_NO)}:${text(row.HOUSE_MANAGE_NO)}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+}
+function summarizeStatus(announcements) {
+  return announcements.reduce((acc, announcement) => {
+    acc[announcement.status] = (acc[announcement.status] ?? 0) + 1;
+    return acc;
+  }, {});
+}
+function parseSigungu(address) {
+  const parts = address.split(/\s+/).filter(Boolean);
+  if (parts.length < 2) return void 0;
+  if (parts[1]?.endsWith("\uC2DC") && parts[2]?.endsWith("\uAD6C")) return `${parts[1]} ${parts[2]}`;
+  return parts[1];
+}
+function addOptional(target, key, value) {
+  const normalized = optionalText(value);
+  if (normalized) target[String(key)] = normalized;
+}
+function addOptionalNumber(target, key, value) {
+  const normalized = optionalNumber(value);
+  if (normalized !== void 0) target[String(key)] = normalized;
+}
+function text(value) {
+  return optionalText(value) ?? "";
+}
+function optionalText(value) {
+  if (value === void 0 || value === null) return void 0;
+  const textValue = String(value).trim();
+  return textValue.length ? textValue : void 0;
+}
+function optionalNumber(value) {
+  const maybeText = optionalText(value);
+  if (!maybeText) return void 0;
+  const number = Number(maybeText.replace(/,/g, ""));
+  return Number.isFinite(number) ? number : void 0;
+}
+function optionalBool(value) {
+  const maybeText = optionalText(value);
+  if (!maybeText) return void 0;
+  if (maybeText === "Y") return true;
+  if (maybeText === "N") return false;
+  return void 0;
+}
+function minDate(values) {
+  const dates = values.map(parseDate).filter((value) => Boolean(value)).sort();
+  return dates[0];
+}
+function maxDate(values) {
+  const dates = values.map(parseDate).filter((value) => Boolean(value)).sort();
+  return dates.at(-1);
+}
+function parseDate(value) {
+  const raw = optionalText(value);
+  if (!raw) return void 0;
+  const match = raw.match(/^(\d{4})-?(\d{2})-?(\d{2})$/);
+  return match ? `${match[1]}-${match[2]}-${match[3]}` : void 0;
+}
+function normalizeMonth(value) {
+  const raw = optionalText(value);
+  if (!raw) return void 0;
+  const match = raw.match(/^(\d{4})-?(\d{2})$/);
+  return match ? `${match[1]}${match[2]}` : void 0;
+}
+function dateOnly(date) {
+  return date.toISOString().slice(0, 10);
+}
+function formatDate(date) {
+  return date.toISOString().slice(0, 10);
+}
+function addMonths(date, months) {
+  const copy = new Date(date.getTime());
+  copy.setUTCMonth(copy.getUTCMonth() + months);
+  return copy;
+}
+function dayDiff(value, today) {
+  const parsed2 = parseDate(value);
+  if (!parsed2) return null;
+  const target = (/* @__PURE__ */ new Date(`${parsed2}T00:00:00Z`)).getTime();
+  const current = (/* @__PURE__ */ new Date(`${dateOnly(today)}T00:00:00Z`)).getTime();
+  return Math.ceil((target - current) / 864e5);
+}
+function monthDiffFromToday(value, today) {
+  const raw = optionalText(value);
+  if (!raw) return null;
+  const match = raw.match(/^(\d{4})(\d{2})$/);
+  if (!match) return null;
+  return dayDiff(`${match[1]}-${match[2]}-01`, today);
+}
+function clampInt(value, min, max) {
+  return Math.min(Math.max(Math.trunc(value), min), max);
+}
+
+// src/providers/applyhome-detail.ts
+var BASE_URL = "https://api.odcloud.kr/api/ApplyhomeInfoDetailSvc/v1/";
+var RETRY_DELAYS_MS2 = [25, 50];
+var DETAIL_ENDPOINTS = {
+  apt: "getAPTLttotPblancMdl",
+  urbty: "getUrbtyOfctlLttotPblancMdl",
+  remndr: "getRemndrLttotPblancMdl",
+  opt: "getOPTLttotPblancMdl",
+  pbl_pvt_rent: "getPblPvtRentLttotPblancMdl"
+};
+async function fetchAnnouncementDetail(query, env, fetcher = fetch) {
+  const serviceKey = env.DATA_GO_KR_SERVICE_KEY;
+  if (!serviceKey) {
+    return { rows: [], sources: [], warnings: ["DATA_GO_KR_SERVICE_KEY is missing."] };
+  }
+  const perPage = query.perPage ?? 100;
+  let page = query.page ?? 1;
+  const rows = [];
+  const sources = [];
+  const warnings = [];
+  while (true) {
+    const url = buildDetailUrl({ ...query, page, perPage }, serviceKey);
+    sources.push(redactServiceKeyInUrl(url.toString(), serviceKey));
+    const response = await fetchWithRetry2(url.toString(), fetcher);
+    if (!response.ok) {
+      warnings.push(`ApplyHome detail API failed: HTTP ${response.status}`);
+      break;
+    }
+    const payload = await readJsonResponse(response);
+    const pageRows = Array.isArray(payload.data) ? payload.data : [];
+    rows.push(...pageRows);
+    const totalCount = Number(payload.totalCount ?? pageRows.length);
+    const responsePerPage = Number(payload.perPage ?? perPage);
+    const responsePage = Number(payload.page ?? page);
+    if (responsePage * responsePerPage >= totalCount || pageRows.length === 0) break;
+    page += 1;
+  }
+  return { rows, sources, warnings };
+}
+async function fetchWithRetry2(url, fetcher) {
+  let response = await fetcher(url, { headers: { Accept: "application/json" } });
+  for (const delayMs of RETRY_DELAYS_MS2) {
+    if (response.ok) return response;
+    await sleep2(delayMs);
+    response = await fetcher(url, { headers: { Accept: "application/json" } });
+  }
+  return response;
+}
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function buildDetailUrl(query, serviceKey) {
+  const url = new URL(BASE_URL + DETAIL_ENDPOINTS[query.type]);
+  url.searchParams.set("page", String(query.page));
+  url.searchParams.set("perPage", String(query.perPage));
+  url.searchParams.set("cond[PBLANC_NO::EQ]", query.announcementId);
+  url.searchParams.set("cond[HOUSE_MANAGE_NO::EQ]", query.houseManageNo);
+  url.searchParams.set("serviceKey", serviceKey);
+  return url;
+}
+
+// src/tools/announcement-detail.ts
+var PYEONG_PER_SQM = 3.3058;
+function normalizeUnitTypeRow(row, type) {
+  const houseTy = optionalText2(row.HOUSE_TY);
+  const tp = optionalText2(row.TP);
+  const typeName = houseTy ?? tp ?? "";
+  const exclusiveArea = optionalNumber2(row.EXCLUSE_AR) ?? parseAreaFromTypeName(typeName) ?? null;
+  const supplyArea = optionalNumber2(row.SUPLY_AR) ?? null;
+  const supplyUnits = resolveSupplyUnits(row, type);
+  const maxPrice = optionalNumber2(row.LTTOT_TOP_AMOUNT) ?? optionalNumber2(row.SUPLY_AMOUNT) ?? null;
+  return {
+    model_no: optionalText2(row.MODEL_NO) ?? null,
+    type_name: typeName,
+    exclusive_area_sqm: exclusiveArea,
+    supply_area_sqm: supplyArea,
+    pyeong: supplyArea !== null && supplyArea > 0 ? roundToTwo(supplyArea / PYEONG_PER_SQM) : null,
+    supply_units: supplyUnits,
+    max_price_10k: maxPrice
+  };
+}
+async function getAnnouncementDetail(input, env, deps = {}) {
+  const type = input.type ?? "apt";
+  if (!deps.cache) return getAnnouncementDetailUncached(input, env, deps, false);
+  const key = `cheongyak:detail:${type}:${input.house_manage_no}:${input.announcement_id}`;
+  const cached = await deps.cache.getOrSetWithStatus(key, TTL.announcementDetail, async () => {
+    const result = await getAnnouncementDetailUncached(input, env, deps, false);
+    return "error" in result ? null : result;
+  });
+  if (cached.value) return { ...cached.value, metadata: { ...cached.value.metadata, cache_hit: cached.hit } };
+  return getAnnouncementDetailUncached(input, env, deps, false);
+}
+async function getAnnouncementDetailUncached(input, env, deps, cacheHit) {
+  const type = input.type ?? "apt";
+  const sources = [];
+  if (!env.DATA_GO_KR_SERVICE_KEY) {
+    return errorResult2(input, type, "AUTH_MISSING", "[AUTH_MISSING] DATA_GO_KR_SERVICE_KEY \uD658\uACBD\uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.", sources, cacheHit);
+  }
+  const provider = await fetchAnnouncementDetail(
+    { houseManageNo: input.house_manage_no, announcementId: input.announcement_id, type },
+    env,
+    deps.fetcher
+  );
+  sources.push(...provider.sources);
+  if (provider.rows.length === 0) {
+    return errorResult2(input, type, "NOT_FOUND", "[NOT_FOUND] \uC774 \uACF5\uACE0\uC758 \uC8FC\uD0DD\uD615\uBCC4 \uC0C1\uC138\uAC00 \uC870\uD68C\uB418\uC9C0 \uC54A\uC74C. \uBA74\uC801 \uCD94\uC815\xB7\uC0DD\uC131 \uAE08\uC9C0.", sources, cacheHit, provider.warnings);
+  }
+  const unitTypes = provider.rows.map((row) => normalizeUnitTypeRow(row, type)).filter((unit) => unit.type_name.length > 0);
+  if (unitTypes.length === 0) {
+    return errorResult2(input, type, "NOT_FOUND", "[NOT_FOUND] \uC774 \uACF5\uACE0\uC758 \uC8FC\uD0DD\uD615\uBCC4 \uC0C1\uC138\uAC00 \uC870\uD68C\uB418\uC9C0 \uC54A\uC74C. \uBA74\uC801 \uCD94\uC815\xB7\uC0DD\uC131 \uAE08\uC9C0.", sources, cacheHit, provider.warnings);
+  }
+  return {
+    house_manage_no: input.house_manage_no,
+    announcement_id: input.announcement_id,
+    type,
+    unit_types: unitTypes,
+    summary: {
+      total_unit_types: unitTypes.length,
+      total_units: unitTypes.reduce((acc, unit) => acc + (unit.supply_units ?? 0), 0)
+    },
+    metadata: {
+      cache_hit: cacheHit,
+      collected_at: nowIso(),
+      data_source: "cheongyak_mdl",
+      sources,
+      ...provider.warnings.length ? { warnings: provider.warnings } : {}
+    }
+  };
+}
+function errorResult2(input, type, error, message, sources, cacheHit, warnings = []) {
+  return {
+    house_manage_no: input.house_manage_no,
+    announcement_id: input.announcement_id,
+    type,
+    error,
+    message,
+    metadata: {
+      cache_hit: cacheHit,
+      collected_at: nowIso(),
+      data_source: "cheongyak_mdl",
+      sources,
+      ...warnings.length ? { warnings } : {}
+    }
+  };
+}
+function resolveSupplyUnits(row, type) {
+  if (type === "apt" || type === "remndr") {
+    const general = optionalNumber2(row.SUPLY_HSHLDCO) ?? null;
+    const special = optionalNumber2(row.SPSPLY_HSHLDCO) ?? null;
+    return general === null && special === null ? null : (general ?? 0) + (special ?? 0);
+  }
+  if (type === "pbl_pvt_rent") {
+    return optionalNumber2(row.SUPLY_HSHLDCO) ?? null;
+  }
+  return optionalNumber2(row.SUPLY_HSHLDCO) ?? null;
+}
+function parseAreaFromTypeName(value) {
+  if (!value) return void 0;
+  const match = value.match(/(\d+(?:\.\d+)?)/);
+  if (!match?.[1]) return void 0;
+  const number = Number(match[1]);
+  return Number.isFinite(number) ? number : void 0;
+}
+function optionalText2(value) {
+  if (value === void 0 || value === null) return void 0;
+  const text3 = String(value).trim();
+  return text3.length ? text3 : void 0;
+}
+function optionalNumber2(value) {
+  const text3 = optionalText2(value);
+  if (!text3) return void 0;
+  const number = Number(text3.replace(/,/g, ""));
+  return Number.isFinite(number) ? number : void 0;
+}
+function roundToTwo(value) {
+  return Math.round(value * 100) / 100;
+}
+
+// src/providers/kapt.ts
+var LIST_BASE = "https://apis.data.go.kr/1613000/AptListService3";
+var INFO_BASE = "https://apis.data.go.kr/1613000/AptBasisInfoServiceV4";
+async function fetchLegaldongAptList(bjdCode, env, fetcher = fetch) {
+  return fetchAptList(`${LIST_BASE}/getLegaldongAptList3`, "bjdCode", bjdCode, env, fetcher);
+}
+async function fetchSigunguAptList(sigunguCode, env, fetcher = fetch) {
+  return fetchAptList(`${LIST_BASE}/getSigunguAptList3`, "sigunguCode", sigunguCode, env, fetcher);
+}
+async function fetchAptList(endpoint, codeParam, codeValue, env, fetcher) {
+  const serviceKey = env.DATA_GO_KR_SERVICE_KEY;
+  if (!serviceKey) return { data: [], sources: [], error: "DATA_GO_KR_SERVICE_KEY is missing." };
+  const items = [];
+  const sources = [];
+  let pageNo = 1;
+  const numOfRows = 100;
+  let resultCode;
+  let resultMsg;
+  while (true) {
+    const url = new URL(endpoint);
+    url.searchParams.set(codeParam, codeValue);
+    url.searchParams.set("pageNo", String(pageNo));
+    url.searchParams.set("numOfRows", String(numOfRows));
+    url.searchParams.set("serviceKey", serviceKey);
+    sources.push(redactServiceKeyInUrl(url.toString(), serviceKey));
+    const response = await fetcher(url.toString(), { headers: { Accept: "application/json" } });
+    if (!response.ok) return { data: items, sources, error: `Apt list API failed: HTTP ${response.status}` };
+    const payload = await readJsonResponse(response);
+    resultCode = payload.response?.header?.resultCode;
+    resultMsg = payload.response?.header?.resultMsg;
+    if (resultCode && resultCode !== "00") {
+      return { data: items, sources, resultCode, resultMsg, error: `API resultCode ${resultCode}` };
+    }
+    const pageItems = normalizeListItems(payload.response?.body?.items);
+    items.push(...pageItems);
+    const totalCount = Number(payload.response?.body?.totalCount ?? items.length);
+    if (pageItems.length === 0 || pageNo * numOfRows >= totalCount) break;
+    pageNo += 1;
+  }
+  return { data: items, sources, resultCode, resultMsg };
+}
+function normalizeListItems(items) {
+  if (!items) return [];
+  if (Array.isArray(items)) return items;
+  const inner = items.item;
+  if (!inner) return [];
+  return Array.isArray(inner) ? inner : [inner];
+}
+async function fetchAptBasisInfo(kaptCode, env, fetcher = fetch) {
+  return fetchAptItem(`${INFO_BASE}/getAphusBassInfoV4`, kaptCode, env, fetcher);
+}
+async function fetchAptDetailInfo(kaptCode, env, fetcher = fetch) {
+  return fetchAptItem(`${INFO_BASE}/getAphusDtlInfoV4`, kaptCode, env, fetcher);
+}
+async function fetchAptItem(endpoint, kaptCode, env, fetcher) {
+  const serviceKey = env.DATA_GO_KR_SERVICE_KEY;
+  if (!serviceKey) return { data: null, sources: [], error: "DATA_GO_KR_SERVICE_KEY is missing." };
+  const url = new URL(endpoint);
+  url.searchParams.set("kaptCode", kaptCode);
+  url.searchParams.set("serviceKey", serviceKey);
+  const sources = [redactServiceKeyInUrl(url.toString(), serviceKey)];
+  const response = await fetcher(url.toString(), { headers: { Accept: "application/json" } });
+  if (!response.ok) return { data: null, sources, error: `Apt info API failed: HTTP ${response.status}` };
+  const payload = await readJsonResponse(response);
+  const resultCode = payload.response?.header?.resultCode;
+  const resultMsg = payload.response?.header?.resultMsg;
+  if (resultCode && resultCode !== "00") {
+    return { data: null, sources, resultCode, resultMsg, error: `API resultCode ${resultCode}` };
+  }
+  return { data: payload.response?.body?.item ?? null, sources, resultCode, resultMsg };
+}
+
+// src/tools/address.ts
+async function getAddress(input, env, fetcher = fetch, options = {}) {
+  const query = normalizeWhitespace(input.query);
+  if (!options.cache) return getAddressUncached({ ...input, query }, env, fetcher);
+  const key = `kakao:address:${JSON.stringify({ query, size: input.size ?? 5, lat: input.center_lat ?? null, lng: input.center_lng ?? null })}`;
+  const cached = await options.cache.getOrSetWithStatus(key, TTL.region, async () => {
+    const result = await getAddressUncached({ ...input, query }, env, fetcher);
+    return result.results.length > 0 ? result : null;
+  });
+  if (cached.value) return { ...cached.value, metadata: { ...cached.value.metadata, cache_hit: cached.hit } };
+  return getAddressUncached({ ...input, query }, env, fetcher);
+}
+async function getAddressUncached(input, env, fetcher) {
+  const query = normalizeWhitespace(input.query);
+  const metadata = { cache_hit: false, collected_at: nowIso(), data_source: "kakao_keyword", warnings: [] };
+  const result = { query, results: [], summary: { total_found: 0 }, metadata };
+  if (!query) {
+    metadata.warnings?.push("query is required.");
+    return result;
+  }
+  if (!env.KAKAO_REST_API_KEY) {
+    metadata.warnings?.push("KAKAO_REST_API_KEY is missing.");
+    return result;
+  }
+  const url = new URL("https://dapi.kakao.com/v2/local/search/keyword.json");
+  url.searchParams.set("query", query);
+  url.searchParams.set("size", String(Math.min(Math.max(input.size ?? 5, 1), 15)));
+  if (input.center_lat !== void 0 && input.center_lng !== void 0) {
+    url.searchParams.set("x", String(input.center_lng));
+    url.searchParams.set("y", String(input.center_lat));
+    url.searchParams.set("sort", "distance");
+  }
+  const response = await fetcher(url.toString(), { headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` } });
+  if (!response.ok) throw new Error(`Kakao keyword API failed: HTTP ${response.status}`);
+  const payload = await readJsonResponse(response);
+  result.results = (payload.documents ?? []).map((doc) => normalizeCandidate(doc, input.center_lat, input.center_lng));
+  result.summary.total_found = result.results.length;
+  addAddressWarnings(result, metadata);
+  if (metadata.warnings?.length === 0) delete metadata.warnings;
+  return result;
+}
+function addAddressWarnings(result, metadata) {
+  if (result.results.length === 0) {
+    metadata.warnings?.push("No Kakao keyword candidates found. Retry with alternate brand/roman numeral/number spacing variants or a nearby station/legal-dong query.");
+    return;
+  }
+  if (result.results.some((candidate) => isModelHouseCandidate(candidate))) {
+    metadata.warnings?.push("Some get_address candidates look like model houses/sales offices, not the actual complex site. Verify the candidate category/address before using it as the project location.");
+  }
+}
+function isModelHouseCandidate(candidate) {
+  return /견본주택|모델하우스|분양사무소|홍보관|sales office/i.test(`${candidate.name} ${candidate.kakao_category_name}`);
+}
+function normalizeCandidate(doc, centerLat, centerLng) {
+  const lat = Number(doc.y);
+  const lng = Number(doc.x);
+  const distanceM = doc.distance ? Number(doc.distance) : centerLat !== void 0 && centerLng !== void 0 ? haversineMeters({ lat: centerLat, lng: centerLng }, { lat, lng }) : void 0;
+  return {
+    name: doc.place_name,
+    address: doc.address_name,
+    ...doc.road_address_name ? { road_address: doc.road_address_name } : {},
+    lat,
+    lng,
+    ...distanceM !== void 0 ? { distance_m: Math.round(distanceM), distance_label: distanceLabel(distanceM) } : {},
+    kakao_place_id: doc.id,
+    kakao_category_name: doc.category_name
+  };
+}
+
+// src/tools/region-code.ts
+var APPLYHOME_BY_SIDO = {
+  "11": "100",
+  // 서울
+  "26": "200",
+  // 부산
+  "27": "200",
+  // 대구
+  "28": "200",
+  // 인천
+  "29": "200",
+  // 광주
+  "30": "300",
+  // 대전
+  "31": "200",
+  // 울산
+  "36": "300",
+  // 세종
+  "41": "410",
+  // 경기
+  "42": "420",
+  // 강원
+  "43": "360",
+  // 충북
+  "44": "312",
+  // 충남
+  "45": "500",
+  // 전북
+  "46": "500",
+  // 전남
+  "47": "600",
+  // 경북
+  "48": "600",
+  // 경남
+  "50": "500",
+  // 제주
+  "51": "420",
+  // 강원특별자치도
+  "52": "500"
+  // 전북특별자치도
+};
+async function getRegionCode(input, env, fetcher = fetch, options = {}) {
+  const query = normalizeWhitespace(input.query);
+  if (!options.cache) return getRegionCodeUncached({ query }, env, fetcher);
+  const key = `region:code:${query}`;
+  const cached = await options.cache.getOrSetWithStatus(key, TTL.region, async () => {
+    const result = await getRegionCodeUncached({ query }, env, fetcher);
+    return "full_code" in result ? result : null;
+  });
+  if (cached.value && "full_code" in cached.value) return { ...cached.value, metadata: { ...cached.value.metadata, cache_hit: cached.hit } };
+  return getRegionCodeUncached({ query }, env, fetcher);
+}
+async function getRegionCodeUncached(input, env, fetcher) {
+  const query = normalizeWhitespace(input.query);
+  const metadata = { cache_hit: false, collected_at: nowIso(), data_source: "kakao_address" };
+  if (!query) return { query, error: "INVALID_QUERY", message: "query is required.", metadata };
+  if (!env.KAKAO_REST_API_KEY) return { query, error: "KAKAO_AUTH_MISSING", message: "KAKAO_REST_API_KEY is missing.", metadata };
+  const direct = await searchAddress(query, env, fetcher);
+  if (direct) return buildSuccess(query, direct, metadata, "address");
+  const placeAddress = await searchKeywordAddress(query, env, fetcher);
+  if (placeAddress) {
+    const viaPlace = await searchAddress(placeAddress, env, fetcher);
+    if (viaPlace) return buildSuccess(query, viaPlace, metadata, "keyword_fallback");
+  }
+  return { query, error: "NOT_FOUND", message: "[NOT_FOUND] \uBC95\uC815\uB3D9\uCF54\uB4DC\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.", metadata };
+}
+async function searchAddress(query, env, fetcher) {
+  const url = new URL("https://dapi.kakao.com/v2/local/search/address.json");
+  url.searchParams.set("query", query);
+  url.searchParams.set("analyze_type", "similar");
+  url.searchParams.set("size", "1");
+  const response = await fetcher(url.toString(), { headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` } });
+  if (!response.ok) throw new Error(`Kakao address API failed: HTTP ${response.status}`);
+  const payload = await readJsonResponse(response);
+  const doc = payload.documents?.[0];
+  return doc?.address?.b_code ? doc : null;
+}
+async function searchKeywordAddress(query, env, fetcher) {
+  const url = new URL("https://dapi.kakao.com/v2/local/search/keyword.json");
+  url.searchParams.set("query", query);
+  url.searchParams.set("size", "1");
+  const response = await fetcher(url.toString(), { headers: { Authorization: `KakaoAK ${env.KAKAO_REST_API_KEY}` } });
+  if (!response.ok) return null;
+  const payload = await readJsonResponse(response);
+  return payload.documents?.[0]?.address_name ?? null;
+}
+function buildSuccess(query, doc, metadata, via) {
+  const fullCode = doc.address.b_code;
+  const sidoCode = fullCode.slice(0, 2);
+  const regionName = [doc.address?.region_1depth_name, doc.address?.region_2depth_name, doc.address?.region_3depth_name].map((part) => part?.trim()).filter((part) => Boolean(part)).join(" ");
+  return {
+    query,
+    full_code: fullCode,
+    sigungu_code: fullCode.slice(0, 5),
+    sido_code: sidoCode,
+    ...APPLYHOME_BY_SIDO[sidoCode] ? { applyhome_code: APPLYHOME_BY_SIDO[sidoCode] } : {},
+    region_name: regionName || doc.address?.address_name || doc.address_name || query,
+    ...doc.address_name ? { address_name: doc.address_name } : {},
+    ...doc.y ? { lat: Number(doc.y) } : {},
+    ...doc.x ? { lng: Number(doc.x) } : {},
+    resolved_via: via,
+    metadata
+  };
+}
+
+// src/resolve/locate.ts
+async function resolveComplexLocation(query, env, deps = {}) {
+  const warnings = [];
+  const trimmed = query.trim();
+  if (!trimmed) return { status: "not_found", query, message: "[NOT_FOUND] \uBE48 \uAC80\uC0C9\uC5B4\uC785\uB2C8\uB2E4.", warnings };
+  if (!env.KAKAO_REST_API_KEY) return { status: "auth_missing", query, message: "[AUTH_MISSING] KAKAO_REST_API_KEY \uD658\uACBD\uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.", warnings };
+  const addressFn = deps.addressFn ?? ((q) => getAddress({ query: q, size: 5 }, env, deps.fetcher ?? fetch, deps.cache ? { cache: deps.cache } : {}));
+  const regionFn = deps.regionFn ?? ((q) => getRegionCode({ query: q }, env, deps.fetcher ?? fetch, deps.cache ? { cache: deps.cache } : {}));
+  const addressResult = await addressFn(trimmed);
+  const hits = addressResult.results ?? [];
+  if (hits.length === 0) {
+    return { status: "not_found", query, message: "[NOT_FOUND] \uC8FC\uC18C \uD6C4\uBCF4\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB2E8\uC9C0\uBA85/\uC8FC\uC18C\uB97C \uD655\uC778\uD558\uC138\uC694.", warnings };
+  }
+  const top = hits[0];
+  const isResidential = /주거시설|아파트|오피스텔/.test(top.kakao_category_name);
+  if (!isResidential) {
+    warnings.push(`\uCD5C\uC0C1\uC704 \uD6C4\uBCF4 \uCE74\uD14C\uACE0\uB9AC\uAC00 \uC8FC\uAC70\uC2DC\uC124\uC774 \uC544\uB2D9\uB2C8\uB2E4(${top.kakao_category_name}). \uB2E8\uC9C0\uBA85\uC774 \uBAA8\uD638\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`);
+  }
+  const { umd, jibun } = parseUmdJibun(top.address);
+  const dongLevel = umd ? top.address.replace(/\s*\S+$/, "") : top.address;
+  let region = await regionFn(dongLevel);
+  if (!("full_code" in region) && dongLevel !== top.address) {
+    region = await regionFn(top.address);
+  }
+  if (!("full_code" in region)) {
+    return { status: "region_failed", query, message: `[REGION_FAILED] \uC8FC\uC18C(${top.address})\uC5D0\uC11C \uBC95\uC815\uB3D9\uCF54\uB4DC\uB97C \uC5BB\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.`, warnings };
+  }
+  const candidates = hits.slice(0, 5).map((h) => ({
+    name: h.name,
+    address: h.address,
+    ...h.road_address ? { road_address: h.road_address } : {},
+    lat: h.lat,
+    lng: h.lng,
+    category: h.kakao_category_name
+  }));
+  return {
+    status: "resolved",
+    query,
+    kakao_place_name: top.name,
+    address: top.address,
+    ...top.road_address ? { road_address: top.road_address } : {},
+    ...umd ? { umd } : {},
+    ...jibun ? { jibun } : {},
+    full_code: region.full_code,
+    sigungu_code: region.sigungu_code,
+    sido_code: region.sido_code,
+    ...region.applyhome_code ? { applyhome_code: region.applyhome_code } : {},
+    region_name: region.region_name,
+    lat: top.lat,
+    lng: top.lng,
+    is_residential: isResidential,
+    candidates,
+    warnings
+  };
+}
+function parseUmdJibun(address) {
+  const match = address.match(/(\S+(?:동|읍|면|가|리))\s+(산?\d+(?:-\d+)?)/);
+  if (!match) return {};
+  return { umd: match[1], jibun: match[2] };
+}
+
+// src/tools/complex-info.ts
+async function getComplexInfo(input, env, deps = {}) {
+  if (!deps.cache) return getComplexInfoUncached(input, env, deps);
+  const keyId = input.kapt_code?.trim() || (input.complex_query ? `q:${normalizeComplexName(input.complex_query)}` : `${input.bjd_code}:${normalizeComplexName(input.complex_name ?? "")}`);
+  const key = `kapt:info:${keyId}:${input.detail ? "d" : "b"}`;
+  const cached = await deps.cache.getOrSetWithStatus(key, TTL.complexInfo, async () => {
+    const result = await getComplexInfoUncached(input, env, deps);
+    return "error" in result ? null : result;
+  });
+  if (cached.value && !("error" in cached.value)) return { ...cached.value, metadata: { ...cached.value.metadata, cache_hit: cached.hit } };
+  return getComplexInfoUncached(input, env, deps);
+}
+async function getComplexInfoUncached(input, env, deps = {}) {
+  const sources = [];
+  const fetcher = deps.fetcher;
+  if (!env.DATA_GO_KR_SERVICE_KEY) {
+    return errorResult3("config_error", "API \uC778\uC99D\uD0A4 \uBBF8\uC124\uC815", sources);
+  }
+  if (!input.kapt_code && !input.complex_query && !(input.bjd_code && input.complex_name)) {
+    return errorResult3("invalid_input", "kapt_code, complex_query, \uB610\uB294 (bjd_code+complex_name) \uC911 \uD558\uB098\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4", sources);
+  }
+  let kaptCode = input.kapt_code?.trim();
+  let resolvedFrom = "kapt_code";
+  let matchKind;
+  let resolvedName;
+  let resolvedLocation;
+  let bjdCode = input.bjd_code;
+  let complexName = input.complex_name;
+  if (!kaptCode && input.complex_query) {
+    const located = await resolveComplexLocation(input.complex_query, env, {
+      ...fetcher ? { fetcher } : {},
+      ...deps.cache ? { cache: deps.cache } : {}
+    });
+    if (located.status !== "resolved") {
+      return errorResult3(located.status === "auth_missing" ? "config_error" : "NOT_FOUND", located.message, sources);
+    }
+    bjdCode = located.full_code;
+    complexName = input.complex_name ?? located.kakao_place_name;
+    resolvedLocation = {
+      address: located.address,
+      umd: located.umd,
+      jibun: located.jibun,
+      full_code: located.full_code,
+      sigungu_code: located.sigungu_code,
+      kakao_place_name: located.kakao_place_name,
+      warnings: located.warnings
+    };
+  }
+  if (!kaptCode && bjdCode && complexName) {
+    const resolution = await resolveKaptCode(bjdCode, complexName, env, fetcher, sources);
+    if ("error" in resolution) return resolution;
+    kaptCode = resolution.kaptCode;
+    resolvedName = resolution.name;
+    matchKind = resolution.match;
+    resolvedFrom = input.complex_query ? "complex_query" : "bjd_code+name";
+  }
+  if (!kaptCode) {
+    return errorResult3("NOT_FOUND", "[NOT_FOUND] \uB2E8\uC9C0\uB97C \uD2B9\uC815\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC815\uBCF4 \uC0DD\uC131 \uAE08\uC9C0.", sources);
+  }
+  const basisResult = await fetchAptBasisInfo(kaptCode, env, fetcher);
+  sources.push(...basisResult.sources);
+  if (basisResult.error && !basisResult.data) {
+    if (basisResult.resultCode && basisResult.resultCode !== "00") {
+      return errorResult3("api_error", `K-apt \uAE30\uBCF8\uC815\uBCF4 \uC870\uD68C \uC2E4\uD328 (resultCode ${basisResult.resultCode})`, sources);
+    }
+    return errorResult3("network_error", `K-apt \uAE30\uBCF8\uC815\uBCF4 \uC870\uD68C \uC2E4\uD328: ${basisResult.error}`, sources);
+  }
+  if (!basisResult.data) {
+    return errorResult3("NOT_FOUND", "[NOT_FOUND] \uD574\uB2F9 \uB2E8\uC9C0\uC758 \uAE30\uBCF8\uC815\uBCF4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uC815\uBCF4 \uC0DD\uC131 \uAE08\uC9C0.", sources);
+  }
+  const basic = mapBasic(basisResult.data);
+  let detail = null;
+  const derived = {};
+  if (input.detail) {
+    const detailResult = await fetchAptDetailInfo(kaptCode, env, fetcher);
+    sources.push(...detailResult.sources);
+    if (detailResult.data) {
+      detail = mapDetail(detailResult.data);
+      const totalParking = (detail.parking_ground ?? 0) + (detail.parking_underground ?? 0);
+      if (basic.total_units && basic.total_units > 0 && totalParking > 0) {
+        derived.parking_per_unit = Math.round(totalParking / basic.total_units * 100) / 100;
+      }
+    }
+  }
+  return {
+    kapt_code: kaptCode,
+    name: resolvedName ?? toText(basisResult.data.kaptName) ?? kaptCode,
+    resolved_from: resolvedFrom,
+    ...matchKind ? { match: matchKind } : {},
+    ...resolvedLocation ? { resolved_location: resolvedLocation } : {},
+    basic,
+    detail,
+    derived,
+    metadata: {
+      cache_hit: false,
+      collected_at: nowIso(),
+      data_source: "kapt_basis_info_v4",
+      sources,
+      note: "\uC900\uACF5\uB144\uB3C4=\uC0AC\uC6A9\uC2B9\uC778\uC77C \uAE30\uC900. \uB2E8\uC9C0\uBA85 \uB9E4\uCE6D\uC740 best-effort"
+    }
+  };
+}
+async function resolveKaptCode(bjdCode, complexName, env, fetcher, sources) {
+  const legaldong = await fetchLegaldongAptList(bjdCode, env, fetcher);
+  sources.push(...legaldong.sources);
+  let decision = scoreAndDecide(complexName, toNameCandidates(legaldong.data));
+  if (decision.status === "not_found") {
+    const sigunguCode = bjdCode.slice(0, 5);
+    const sigungu = await fetchSigunguAptList(sigunguCode, env, fetcher);
+    sources.push(...sigungu.sources);
+    const widened = scoreAndDecide(complexName, toNameCandidates(sigungu.data));
+    if (widened.status !== "not_found") decision = widened;
+  }
+  if (decision.status === "not_found") {
+    return errorResult3("NOT_FOUND", "[NOT_FOUND] \uD574\uB2F9 \uBC95\uC815\uB3D9\uC5D0\uC11C \uB2E8\uC9C0 \uBBF8\uBC1C\uACAC. \uC815\uBCF4 \uC0DD\uC131 \uAE08\uC9C0", sources);
+  }
+  if (decision.status === "ambiguous") {
+    const err = errorResult3("AMBIGUOUS", "[NEEDS_DISAMBIGUATION] \uB2E8\uC9C0 \uD2B9\uC815 \uBD88\uAC00 \u2014 \uBA54\uD0C0\uC815\uBCF4 \uC0DD\uC131 \uAE08\uC9C0", sources);
+    err.candidates = decision.candidates.map((c) => ({
+      kapt_code: c.code,
+      name: c.name,
+      ...c.address_road ? { address_road: c.address_road } : {},
+      sim: Math.round(c.sim * 1e3) / 1e3
+    }));
+    return err;
+  }
+  return { kaptCode: decision.code, name: decision.name, match: decision.match };
+}
+function toNameCandidates(items) {
+  const out = [];
+  for (const item of items) {
+    const code = toText(item.kaptCode);
+    const name = toText(item.kaptName);
+    if (!code || !name) continue;
+    out.push({ code, name, ...toText(item.doroJuso) ? { address_road: toText(item.doroJuso) } : {} });
+  }
+  return out;
+}
+function mapBasic(item) {
+  const useDate = toText(item.kaptUsedate);
+  const buildYear = useDate && useDate.length >= 4 ? Number(useDate.slice(0, 4)) : null;
+  return {
+    build_year: buildYear !== null && Number.isFinite(buildYear) ? buildYear : null,
+    use_approval_date: useDate ?? null,
+    total_units: toNumber(item.kaptdaCnt),
+    dong_count: toNumber(item.kaptDongCnt),
+    constructor: toText(item.kaptBcompany) ?? null,
+    developer: toText(item.kaptAcompany) ?? null,
+    sale_type: toText(item.codeSaleNm) ?? null,
+    heat_type: toText(item.codeHeatNm) ?? null,
+    mgmt_type: toText(item.codeMgrNm) ?? null,
+    hall_type: toText(item.codeHallNm) ?? null,
+    complex_category: toText(item.codeAptNm) ?? null,
+    top_floor: toNumber(item.kaptTopFloor),
+    base_floor: toNumber(item.kaptBaseFloor),
+    total_floor_area: toNumber(item.kaptTarea),
+    private_area_sum: toNumber(item.privArea),
+    ho_count: toNumber(item.hoCnt),
+    unit_mix: {
+      under_60: toNumber(item.kaptMparea60),
+      _60_85: toNumber(item.kaptMparea85),
+      _85_135: toNumber(item.kaptMparea135),
+      over_135: toNumber(item.kaptMparea136)
+    },
+    address_jibun: toText(item.kaptAddr) ?? null,
+    address_road: toText(item.doroJuso) ?? null,
+    bjd_code: toText(item.bjdCode) ?? null,
+    office_tel: toText(item.kaptTel) ?? null,
+    homepage: toText(item.kaptUrl) ?? null
+  };
+}
+function mapDetail(item) {
+  return {
+    parking_ground: toNumber(item.kaptdPcnt),
+    parking_underground: toNumber(item.kaptdPcntu),
+    elevator_count: toNumber(item.kaptdEcnt),
+    cctv_count: toNumber(item.kaptdCccnt),
+    subway_line: toText(item.subwayLine) ?? null,
+    subway_station: toText(item.subwayStation) ?? null,
+    subway_walk_min: toText(item.kaptdWtimesub) ?? null,
+    bus_walk_min: toText(item.kaptdWtimebus) ?? null,
+    welfare_facility: toText(item.welfareFacility) ?? null,
+    convenient_facility: toText(item.convenientFacility) ?? null,
+    education_facility: toText(item.educationFacility) ?? null,
+    ev_charger_ground: toNumber(item.groundElChargerCnt),
+    ev_charger_underground: toNumber(item.undergroundElChargerCnt),
+    structure: toText(item.codeStr) ?? null,
+    water_supply: toText(item.codeWsupply) ?? null,
+    home_network: toText(item.codeNet) ?? null,
+    use_yn: toText(item.useYn) ?? null
+  };
+}
+function errorResult3(error, message, sources) {
+  return {
+    error,
+    message,
+    metadata: { cache_hit: false, collected_at: nowIso(), data_source: "kapt_basis_info_v4", sources }
+  };
+}
+function toText(value) {
+  if (value === void 0 || value === null) return void 0;
+  const text3 = String(value).trim();
+  return text3.length ? text3 : void 0;
+}
+function toNumber(value) {
+  const text3 = toText(value);
+  if (!text3) return null;
+  const num = Number(text3.replace(/,/g, ""));
+  return Number.isFinite(num) ? num : null;
+}
+
+// src/tools/complex-trades.ts
+var PYEONG_PER_SQM2 = 3.3058;
+var DEFAULT_SUPPLY_RATIO = 0.752;
+var DEFAULT_MOLIT_NUM_OF_ROWS = 1e3;
+var MOLIT_PAGE_CONCURRENCY = 4;
+var ENDPOINTS = {
+  sale: {
+    url: "https://apis.data.go.kr/1613000/RTMSDataSvcAptTrade/getRTMSDataSvcAptTrade",
+    dataSource: "molit_apt_trade"
+  },
+  resale: {
+    url: "https://apis.data.go.kr/1613000/RTMSDataSvcSilvTrade/getRTMSDataSvcSilvTrade",
+    dataSource: "molit_apt_resale"
+  },
+  rent: {
+    url: "https://apis.data.go.kr/1613000/RTMSDataSvcAptRent/getRTMSDataSvcAptRent",
+    dataSource: "molit_apt_rent"
+  }
+};
+var ALL_TRADE_TYPES = ["sale", "rent", "resale"];
+var PRIMARY_TYPE_ORDER = ["sale", "resale", "rent"];
+async function getComplexTrades(input, env, deps = {}) {
+  const tradeType = input.trade_type ?? "sale";
+  let resolved = input;
+  let resolveWarnings = [];
+  if (!input.region_code && input.complex_query) {
+    const located = await resolveComplexLocation(input.complex_query, env, {
+      ...deps.fetcher ? { fetcher: deps.fetcher } : {},
+      ...deps.cache ? { cache: deps.cache } : {}
+    });
+    if (located.status !== "resolved") {
+      return errorResult4(input, tradeType, located.status === "auth_missing" ? "AUTH_MISSING" : "NOT_FOUND", located.message, [], located.warnings, false);
+    }
+    resolveWarnings = located.warnings;
+    resolved = {
+      ...input,
+      region_code: located.sigungu_code,
+      // Auto-build a 법정동+지번 filter when the resolver parsed them; keep any
+      // explicit complex_filter the caller provided.
+      ...input.complex_filter ? {} : located.umd && located.jibun ? { complex_filter: { umd: located.umd, jibun: located.jibun, jibun_match: "bonbun", apt_name: located.kakao_place_name } } : {}
+    };
+  }
+  if (!resolved.region_code) {
+    return errorResult4(input, tradeType, "INVALID_INPUT", "region_code \uB610\uB294 complex_query \uC911 \uD558\uB098\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.", [], [], false);
+  }
+  if (tradeType === "all") {
+    return withResolveWarnings(await getComplexTradesAll(resolved, env, deps), resolveWarnings);
+  }
+  if (!deps.cache) return withResolveWarnings(await getComplexTradesUncached(resolved, env, deps, false), resolveWarnings);
+  const key = `molit:trades:${tradeType}:${resolved.region_code}:${resolved.year_month}:${resolved.num_of_rows ?? DEFAULT_MOLIT_NUM_OF_ROWS}`;
+  const cached = await deps.cache.getOrSetWithStatus(key, TTL.trades, async () => {
+    const provider = await fetchMolitTrades(resolved, env, deps.fetcher, tradeType);
+    return provider.api_error ? null : provider;
+  });
+  if (cached.value) return withResolveWarnings(buildResult(resolved, tradeType, cached.value, cached.hit), resolveWarnings);
+  return withResolveWarnings(await getComplexTradesUncached(resolved, env, deps, false), resolveWarnings);
+}
+function withResolveWarnings(result, warnings) {
+  if (warnings.length === 0) return result;
+  const merged = [...result.metadata.warnings ?? [], ...warnings];
+  return { ...result, metadata: { ...result.metadata, warnings: merged } };
+}
+async function getComplexTradesUncached(input, env, deps, cacheHit) {
+  const tradeType = normalizeSingleTradeType(input.trade_type);
+  const provider = await fetchMolitTrades(input, env, deps.fetcher, tradeType);
+  if (provider.api_error) {
+    return errorResult4(input, tradeType, provider.api_error.code === "03" ? "NOT_FOUND" : "API_ERROR", provider.api_error.message, provider.sources, provider.warnings, cacheHit);
+  }
+  return buildResult(input, tradeType, provider, cacheHit);
+}
+async function getComplexTradesAll(input, env, deps) {
+  const settled = await Promise.allSettled(
+    ALL_TRADE_TYPES.map(async (tradeType) => {
+      const singleInput = { ...input, trade_type: tradeType };
+      const result = deps.cache ? await getComplexTrades(singleInput, env, deps) : await getComplexTradesUncached(singleInput, env, deps, false);
+      return [tradeType, result];
+    })
+  );
+  const results = {};
+  const warnings = [];
+  for (let index = 0; index < settled.length; index += 1) {
+    const tradeType = ALL_TRADE_TYPES[index];
+    const item = settled[index];
+    if (item.status === "fulfilled") {
+      const [, result] = item.value;
+      results[tradeType] = result;
+      if (result.metadata.warnings) warnings.push(...result.metadata.warnings);
+    } else {
+      const message = item.reason instanceof Error ? item.reason.message : String(item.reason);
+      warnings.push(`MOLIT ${tradeType} fetch rejected: ${message}`);
+      results[tradeType] = errorResult4(input, tradeType, "API_ERROR", `[API_ERROR] ${message}`, [], [], false);
+    }
+  }
+  const primaryType = PRIMARY_TYPE_ORDER.find((tradeType) => {
+    const result = results[tradeType];
+    return result && !("error" in result) && result.summary.sample_count > 0;
+  }) ?? null;
+  const sources = ALL_TRADE_TYPES.flatMap((tradeType) => results[tradeType]?.metadata.sources ?? []);
+  const returnedCount = ALL_TRADE_TYPES.reduce((sum, tradeType) => sum + metadataCount(results[tradeType], "returned_count"), 0);
+  const omittedCount = ALL_TRADE_TYPES.reduce((sum, tradeType) => sum + metadataCount(results[tradeType], "omitted_count"), 0);
+  const truncated = ALL_TRADE_TYPES.some((tradeType) => Boolean(results[tradeType]?.metadata.truncated));
+  return {
+    trade_type: "all",
+    region_code: input.region_code ?? "",
+    year_month: input.year_month,
+    filter_applied: normalizeFilter(input.complex_filter),
+    results,
+    primary_type: primaryType,
+    metadata: {
+      cache_hit: ALL_TRADE_TYPES.every((tradeType) => Boolean(results[tradeType]?.metadata.cache_hit)),
+      collected_at: nowIso(),
+      data_sources: ALL_TRADE_TYPES.map((tradeType) => ENDPOINTS[tradeType].dataSource),
+      sources,
+      ...warnings.length ? { warnings } : {},
+      returned_count: returnedCount,
+      omitted_count: omittedCount,
+      truncated,
+      source_count: sources.length
+    }
+  };
+}
+async function fetchMolitTrades(input, env, fetcher = fetch, tradeType) {
+  if (!env.DATA_GO_KR_SERVICE_KEY) {
+    return { rows: [], total_count: 0, sources: [], warnings: ["DATA_GO_KR_SERVICE_KEY is missing."], api_error: { code: "AUTH_MISSING", message: "[AUTH_MISSING] DATA_GO_KR_SERVICE_KEY \uD658\uACBD\uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." } };
+  }
+  const serviceKey = env.DATA_GO_KR_SERVICE_KEY;
+  const numOfRows = input.num_of_rows ?? DEFAULT_MOLIT_NUM_OF_ROWS;
+  const fetchPage = async (pageNo) => {
+    const url = new URL(ENDPOINTS[tradeType].url);
+    url.searchParams.set("serviceKey", serviceKey);
+    url.searchParams.set("LAWD_CD", input.region_code ?? "");
+    url.searchParams.set("DEAL_YMD", input.year_month);
+    url.searchParams.set("pageNo", String(pageNo));
+    url.searchParams.set("numOfRows", String(numOfRows));
+    const source = redactServiceKeyInUrl(url.toString(), serviceKey);
+    const response = await fetcher(url.toString(), {
+      headers: {
+        Accept: "application/xml,text/xml,*/*",
+        // MOLIT real-transaction API returns "400 Request Blocked" for requests
+        // with no/curl User-Agent; a browser-like UA is required.
+        "User-Agent": "Mozilla/5.0 (compatible; presale-mcp/1.0)"
+      }
+    });
+    if (!response.ok) {
+      return { rows: [], total_count: 0, sources: [source], warnings: [], page_no: pageNo, num_of_rows: numOfRows, api_error: { code: String(response.status), message: `MOLIT real transaction API failed: HTTP ${response.status}` } };
+    }
+    const xml = await response.text();
+    const parsed2 = parseMolitXml(xml);
+    if (parsed2.resultCode && parsed2.resultCode !== "000") {
+      return { rows: [], total_count: parsed2.totalCount ?? 0, sources: [source], warnings: [], page_no: pageNo, num_of_rows: parsed2.numOfRows ?? numOfRows, api_error: { code: parsed2.resultCode, message: `[${parsed2.resultCode}] ${parsed2.resultMsg || "MOLIT API error"}` } };
+    }
+    return {
+      rows: parsed2.items,
+      total_count: parsed2.totalCount ?? parsed2.items.length,
+      sources: [source],
+      warnings: [],
+      page_no: parsed2.pageNo ?? pageNo,
+      num_of_rows: parsed2.numOfRows ?? numOfRows
+    };
+  };
+  const first = await fetchPage(1);
+  if (first.api_error) return first;
+  const totalCount = first.total_count;
+  const totalPages = Math.max(1, Math.ceil(totalCount / Math.max(1, first.num_of_rows)));
+  const restPages = Array.from({ length: Math.max(0, totalPages - 1) }, (_, index) => index + 2);
+  const rest = await mapWithConcurrency3(restPages, MOLIT_PAGE_CONCURRENCY, fetchPage);
+  const apiError = rest.find((page) => page.api_error);
+  if (apiError) return apiError;
+  const pages = [first, ...rest];
+  return {
+    rows: pages.flatMap((page) => page.rows),
+    total_count: totalCount,
+    sources: pages.flatMap((page) => page.sources),
+    warnings: pages.flatMap((page) => page.warnings)
+  };
+}
+function buildResult(input, tradeType, provider, cacheHit) {
+  const normalizedRows = provider.rows.map((row) => normalizeTradeRow(row, tradeType)).filter((item) => item !== null);
+  const ownershipExcludedCount = tradeType === "resale" && normalizeResaleOwnership(input.resale_ownership) === "presale_only" ? normalizedRows.filter((item) => isOccupancyRightResale(item)).length : 0;
+  const normalizedAll = tradeType === "resale" && normalizeResaleOwnership(input.resale_ownership) === "presale_only" ? normalizedRows.filter((item) => !isOccupancyRightResale(item)) : normalizedRows;
+  const warnings = [
+    ...provider.warnings,
+    ...ownershipExcludedCount > 0 ? [`MOLIT resale returned ${ownershipExcludedCount} occupancy-right rows excluded by resale_ownership=presale_only; use resale_ownership='all' to include them.`] : []
+  ];
+  if (provider.total_count === 0 || normalizedAll.length === 0) {
+    return errorResult4(input, tradeType, "NOT_FOUND", "[NOT_FOUND] \uD574\uB2F9 \uC9C0\uC5ED\xB7\uAE30\uAC04 \uC2E4\uAC70\uB798 \uC5C6\uC74C. \uC2DC\uC138 \uCD94\uC815\xB7\uC0DD\uC131 \uAE08\uC9C0", provider.sources, warnings, cacheHit);
+  }
+  const filterApplied = normalizeFilter(input.complex_filter);
+  const matchResults = filterApplied ? normalizedAll.map((item) => ({ item, match: matchComplexFilter(item, filterApplied) })) : normalizedAll.map((item) => ({ item, match: { matched: true, viaNameFallback: false } }));
+  const filteredItems = matchResults.filter(({ match }) => match.matched).map(({ item }) => item);
+  const usedNameFallback = matchResults.some(({ match }) => match.matched && match.viaNameFallback);
+  const limit = normalizeLimit2(input.limit);
+  const items = filteredItems.slice(0, limit);
+  const summaryItems = tradeType === "resale" ? filteredItems.filter((item) => !isOccupancyRightResale(item)) : filteredItems;
+  let filterNote = "\uBC95\uC815\uB3D9+\uC9C0\uBC88 best-effort \uB9E4\uCE6D. \uB2E4\uC9C0\uBC88 \uB300\uB2E8\uC9C0\xB7\uD45C\uAE30\uCC28\uB85C \uB204\uB77D \uAC00\uB2A5";
+  if (usedNameFallback) {
+    filterNote += " [name fallback] MOLIT \uBE14\uB85D\uD615 \uC9C0\uBC88 \uD589\uC744 \uB2E8\uC9C0\uBA85 \uC5C4\uACA9 \uB9E4\uCE6D\uC73C\uB85C \uD3EC\uD568";
+  }
+  if (filterApplied && filteredItems.length === 0 && normalizedAll.length > 0) {
+    filterNote += " [PARTIAL] \uC9C0\uC815 \uB2E8\uC9C0 \uBBF8\uBC1C\uACAC \u2014 \uC2DC\uC138 \uC0DD\uC131 \uAE08\uC9C0";
+  }
+  const omittedCount = Math.max(0, filteredItems.length - items.length);
+  return {
+    trade_type: tradeType,
+    region_code: input.region_code ?? "",
+    year_month: input.year_month,
+    filter_applied: filterApplied,
+    total_count: provider.total_count,
+    filtered_count: filteredItems.length,
+    items,
+    summary: summarize(summaryItems, tradeType),
+    ...tradeType === "resale" ? { summary_by_ownership: summarizeResaleByOwnership(filteredItems) } : {},
+    metadata: {
+      cache_hit: cacheHit,
+      collected_at: nowIso(),
+      data_source: ENDPOINTS[tradeType].dataSource,
+      sources: provider.sources,
+      ...warnings.length ? { warnings } : {},
+      area_note: "\uBA74\uC801\xB7\uD3C9\uB2F9\uAC00\uB294 \uC804\uC6A9\uBA74\uC801 \uAE30\uC900",
+      filter_note: filterNote,
+      returned_count: items.length,
+      omitted_count: omittedCount,
+      truncated: omittedCount > 0,
+      source_count: provider.sources.length
+    }
+  };
+}
+function normalizeTradeRow(row, tradeType) {
+  if (row.cdealType === "O") return null;
+  const aptName = text2(row.aptNm);
+  const dong = text2(row.umdNm);
+  const jibun = text2(row.jibun);
+  const area = numberValue(row.excluUseAr);
+  const tradeDate = buildTradeDate(row.dealYear, row.dealMonth, row.dealDay);
+  if (!aptName || !dong || !jibun || area === void 0 || !tradeDate) return null;
+  const base = {
+    apt_name: aptName,
+    dong,
+    jibun,
+    area_sqm: area,
+    floor: numberValue(row.floor) ?? null,
+    trade_date: tradeDate
+  };
+  if (tradeType === "rent") {
+    const deposit = numberValue(row.deposit);
+    const monthlyRent = numberValue(row.monthlyRent);
+    if (deposit === void 0 || monthlyRent === void 0) return null;
+    return {
+      ...base,
+      ...text2(row.aptSeq) ? { apt_seq: text2(row.aptSeq) } : {},
+      deposit_10k: deposit,
+      monthly_rent_10k: monthlyRent,
+      lease_type: monthlyRent === 0 ? "\uC804\uC138" : "\uC6D4\uC138",
+      build_year: numberValue(row.buildYear) ?? null,
+      ...text2(row.contractType) ? { contract_type: text2(row.contractType) } : {}
+    };
+  }
+  const price = numberValue(row.dealAmount);
+  if (price === void 0) return null;
+  const pyeongPrice = area > 0 ? Math.round(price / (area / PYEONG_PER_SQM2)) : null;
+  const supplyEst = area > 0 ? Math.round(price / (area / DEFAULT_SUPPLY_RATIO / PYEONG_PER_SQM2)) : null;
+  const priceFields = {
+    price_10k: price,
+    pyeong_price: pyeongPrice,
+    pyeong_price_supply_est: supplyEst,
+    supply_ratio_assumed: DEFAULT_SUPPLY_RATIO,
+    area_basis: "\uC804\uC6A9\uBA74\uC801"
+  };
+  if (tradeType === "resale") {
+    return {
+      ...base,
+      ...priceFields,
+      ...text2(row.ownershipGbn) ? { ownership_gbn: text2(row.ownershipGbn) } : {},
+      ...text2(row.dealingGbn) ? { deal_type: text2(row.dealingGbn) } : {},
+      ...text2(row.slerGbn) ? { seller: text2(row.slerGbn) } : {},
+      ...text2(row.buyerGbn) ? { buyer: text2(row.buyerGbn) } : {}
+    };
+  }
+  return {
+    ...base,
+    ...priceFields,
+    build_year: numberValue(row.buildYear) ?? null,
+    ...text2(row.dealingGbn) ? { deal_type: text2(row.dealingGbn) } : {},
+    ...text2(row.slerGbn) ? { seller: text2(row.slerGbn) } : {},
+    ...text2(row.buyerGbn) ? { buyer: text2(row.buyerGbn) } : {},
+    ...text2(row.landLeaseholdGbn) ? { land_leasehold: text2(row.landLeaseholdGbn) } : {}
+  };
+}
+function summarize(items, tradeType) {
+  if (tradeType === "rent") {
+    const rentItems = items;
+    const deposits = rentItems.map((item) => item.deposit_10k);
+    const monthly = rentItems.map((item) => item.monthly_rent_10k);
+    return {
+      median_deposit_10k: median(deposits),
+      min_deposit_10k: deposits.length ? Math.min(...deposits) : null,
+      max_deposit_10k: deposits.length ? Math.max(...deposits) : null,
+      monthly_rent_avg_10k: monthly.length ? Math.round(monthly.reduce((a, b) => a + b, 0) / monthly.length) : null,
+      jeonse_ratio_pct: null,
+      sample_count: items.length
+    };
+  }
+  return summarizePriceTrades(items);
+}
+function summarizePriceTrades(items) {
+  const prices = items.map((item) => item.price_10k);
+  const pyeongPrices = items.map((item) => item.pyeong_price).filter((value) => value !== null);
+  return {
+    median_price_10k: median(prices),
+    min_price_10k: prices.length ? Math.min(...prices) : null,
+    max_price_10k: prices.length ? Math.max(...prices) : null,
+    median_pyeong_price: median(pyeongPrices),
+    sample_count: items.length
+  };
+}
+function summarizeResaleByOwnership(items) {
+  const resaleItems = items.filter((item) => isResaleTradeItem(item));
+  return {
+    presale: summarizePriceTrades(resaleItems.filter((item) => item.ownership_gbn === "\uBD84")),
+    occupancy_right: summarizePriceTrades(resaleItems.filter((item) => item.ownership_gbn === "\uC785")),
+    other: summarizePriceTrades(resaleItems.filter((item) => item.ownership_gbn !== "\uBD84" && item.ownership_gbn !== "\uC785"))
+  };
+}
+function isResaleTradeItem(item) {
+  return "price_10k" in item && !("build_year" in item);
+}
+function isOccupancyRightResale(item) {
+  return isResaleTradeItem(item) && item.ownership_gbn === "\uC785";
+}
+function normalizeFilter(filter) {
+  if (!filter) return null;
+  const jibun = Array.isArray(filter.jibun) ? filter.jibun : [filter.jibun];
+  return {
+    umd: filter.umd,
+    jibun,
+    jibun_match: filter.jibun_match ?? "exact",
+    ...filter.apt_name ? { apt_name: filter.apt_name } : {}
+  };
+}
+function matchComplexFilter(item, filter) {
+  if (!sameLegalDong(item.dong, filter.umd)) return { matched: false, viaNameFallback: false };
+  const itemJibun = normalizeJibun(item.jibun);
+  const jibunMatches = filter.jibun.some((candidate) => {
+    const normalized = normalizeJibun(candidate);
+    if (filter.jibun_match === "bonbun") return bonbun(itemJibun) === bonbun(normalized);
+    return itemJibun === normalized;
+  });
+  if (jibunMatches) {
+    if (filter.apt_name && !isCompatibleComplexName(item.apt_name, filter.apt_name)) return { matched: false, viaNameFallback: false };
+    return { matched: true, viaNameFallback: false };
+  }
+  if (filter.apt_name && isBlockStyleJibun(itemJibun) && isStrictComplexNameMatch(item.apt_name, filter.apt_name)) {
+    return { matched: true, viaNameFallback: true };
+  }
+  return { matched: false, viaNameFallback: false };
+}
+function sameLegalDong(itemDong, filterDong) {
+  const item = normalizeLegalDong(itemDong);
+  const filter = normalizeLegalDong(filterDong);
+  if (!item || !filter) return false;
+  if (item === filter) return true;
+  return legalDongLeaf(item) === legalDongLeaf(filter);
+}
+function normalizeLegalDong(value) {
+  return value.trim().replace(/\s+/g, " ");
+}
+function legalDongLeaf(value) {
+  const tokens = value.split(" ").filter(Boolean);
+  return tokens[tokens.length - 1] ?? value;
+}
+function isCompatibleComplexName(itemName, filterName) {
+  const item = normalizeComplexName(itemName);
+  const filter = normalizeComplexName(filterName);
+  return item.includes(filter) || filter.includes(item);
+}
+function isStrictComplexNameMatch(itemName, filterName) {
+  const item = normalizeComplexName(itemName);
+  const filter = normalizeComplexName(filterName);
+  if (item.length < 6 || filter.length < 6) return false;
+  if (item === filter) return true;
+  return complexNameSimilarity(item, filter, { aNormalized: true, bNormalized: true }) >= 0.96;
+}
+function isBlockStyleJibun(jibun) {
+  return /[a-zA-Z가-힣]/.test(jibun);
+}
+function normalizeLimit2(limit) {
+  if (limit === void 0) return 30;
+  if (!Number.isFinite(limit)) return 30;
+  return Math.min(100, Math.max(1, Math.floor(limit)));
+}
+function normalizeSingleTradeType(tradeType) {
+  return tradeType === "rent" || tradeType === "resale" ? tradeType : "sale";
+}
+function normalizeResaleOwnership(value) {
+  return value === "all" ? "all" : "presale_only";
+}
+function metadataCount(result, key) {
+  if (!result || "error" in result) return 0;
+  return result.metadata[key];
+}
+async function mapWithConcurrency3(items, concurrency, mapper) {
+  const results = new Array(items.length);
+  let next = 0;
+  const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+    while (next < items.length) {
+      const current = next;
+      next += 1;
+      results[current] = await mapper(items[current]);
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+function parseMolitXml(xml) {
+  return {
+    resultCode: firstTag(xml, "resultCode"),
+    resultMsg: firstTag(xml, "resultMsg"),
+    items: [...xml.matchAll(/<item>([\s\S]*?)<\/item>/g)].map((match) => parseItem(match[1] ?? "")),
+    totalCount: numberValue(firstTag(xml, "totalCount")),
+    pageNo: numberValue(firstTag(xml, "pageNo")),
+    numOfRows: numberValue(firstTag(xml, "numOfRows"))
+  };
+}
+function parseItem(xml) {
+  const row = {};
+  for (const match of xml.matchAll(/<([A-Za-z0-9_]+)>([\s\S]*?)<\/\1>/g)) {
+    const key = match[1];
+    if (!key) continue;
+    row[key] = decodeXml(match[2] ?? "").trim();
+  }
+  return row;
+}
+function firstTag(xml, tag) {
+  const escaped = tag.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const match = xml.match(new RegExp(`<${escaped}>([\\s\\S]*?)<\\/${escaped}>`));
+  return match?.[1] ? decodeXml(match[1]).trim() : void 0;
+}
+function errorResult4(input, tradeType, error, message, sources, warnings, cacheHit) {
+  const dataSource = tradeType === "all" ? "molit_real_transactions" : ENDPOINTS[tradeType].dataSource;
+  return {
+    trade_type: tradeType,
+    region_code: input.region_code ?? "",
+    year_month: input.year_month,
+    error,
+    message,
+    metadata: {
+      cache_hit: cacheHit,
+      collected_at: nowIso(),
+      data_source: dataSource,
+      sources,
+      ...warnings.length ? { warnings } : {}
+    }
+  };
+}
+function median(values) {
+  if (values.length === 0) return null;
+  const sorted = [...values].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  if (sorted.length % 2 === 1) return sorted[mid] ?? null;
+  const left = sorted[mid - 1];
+  const right = sorted[mid];
+  return left === void 0 || right === void 0 ? null : Math.round((left + right) / 2);
+}
+function buildTradeDate(year, month, day) {
+  if (!year || !month || !day) return null;
+  return `${year.padStart(4, "0")}-${month.padStart(2, "0")}-${day.padStart(2, "0")}`;
+}
+function text2(value) {
+  return (value ?? "").trim();
+}
+function numberValue(value) {
+  const normalized = text2(value).replace(/,/g, "");
+  if (!normalized) return void 0;
+  const n = Number(normalized);
+  return Number.isFinite(n) ? n : void 0;
+}
+function normalizeJibun(value) {
+  return value.replace(/\s+/g, "").replace(/^산/u, "");
+}
+function bonbun(value) {
+  return value.split("-")[0] ?? value;
+}
+function decodeXml(value) {
+  return value.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+}
+
+// src/providers/naver-staticmap.ts
+var ENDPOINT = "https://maps.apigw.ntruss.com/map-static/v2/raster";
+var STATIC_MAP_MAX_MARKERS = 20;
+var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, Math.round(n)));
+function buildStaticMapUrl(req, env) {
+  const url = new URL(ENDPOINT);
+  url.searchParams.set("w", String(clamp(req.width, 1, 1024)));
+  url.searchParams.set("h", String(clamp(req.height, 1, 1024)));
+  url.searchParams.set("maptype", req.maptype ?? "basic");
+  if (req.scale) url.searchParams.set("scale", String(req.scale));
+  if (req.format) url.searchParams.set("format", req.format);
+  const markers = (req.markers ?? []).slice(0, STATIC_MAP_MAX_MARKERS);
+  if (markers.length > 0) {
+    for (const m of markers) {
+      const parts = [`type:d`, `size:${m.size ?? "mid"}`];
+      if (m.color) parts.push(`color:${m.color}`);
+      if (m.label && m.size !== "tiny") parts.push(`label:${m.label}`);
+      parts.push(`pos:${fmt(m.lng)} ${fmt(m.lat)}`);
+      url.searchParams.append("markers", parts.join("|"));
+    }
+  } else if (req.center) {
+    url.searchParams.set("center", `${fmt(req.center.lng)},${fmt(req.center.lat)}`);
+    url.searchParams.set("level", String(clamp(req.level ?? 16, 0, 20)));
+  }
+  return url.toString();
+}
+async function fetchStaticMap(req, env, fetcher = fetch) {
+  if (!env.NAVER_MAPS_CLIENT_ID || !env.NAVER_MAPS_CLIENT_SECRET) {
+    return { error: "NAVER_AUTH_MISSING" };
+  }
+  const url = buildStaticMapUrl(req, env);
+  const response = await fetcher(url, {
+    headers: {
+      "x-ncp-apigw-api-key-id": env.NAVER_MAPS_CLIENT_ID,
+      "x-ncp-apigw-api-key": env.NAVER_MAPS_CLIENT_SECRET
+    }
+  });
+  if (!response.ok) {
+    return { error: `STATIC_MAP_API_ERROR`, status: response.status };
+  }
+  const mimeType = response.headers.get("content-type") ?? "image/jpeg";
+  const buf = new Uint8Array(await response.arrayBuffer());
+  return { base64: toBase64(buf), mimeType, bytes: buf.byteLength };
+}
+function fmt(n) {
+  return Number(n.toFixed(7)).toString();
+}
+function toBase64(bytes) {
+  let binary = "";
+  const chunk = 32768;
+  for (let i = 0; i < bytes.length; i += chunk) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+  }
+  return btoa(binary);
+}
+
+// src/tools/static-map.ts
+function levelForRadius(radiusM) {
+  if (radiusM <= 250) return 17;
+  if (radiusM <= 500) return 16;
+  if (radiusM <= 1e3) return 15;
+  if (radiusM <= 2e3) return 14;
+  if (radiusM <= 4e3) return 13;
+  if (radiusM <= 8e3) return 12;
+  return 11;
+}
+async function getStaticMap(input, env, deps = {}) {
+  const metadata = { cache_hit: false, collected_at: nowIso(), data_source: "naver_static_map" };
+  const warnings = [];
+  const markers = input.markers ?? [];
+  if (markers.length === 0 && !input.center) {
+    return { error: "INVALID_INPUT", message: "markers \uB610\uB294 center \uC911 \uD558\uB098\uB294 \uD544\uC694\uD569\uB2C8\uB2E4.", metadata };
+  }
+  if (!env.NAVER_MAPS_CLIENT_ID || !env.NAVER_MAPS_CLIENT_SECRET) {
+    return { error: "NAVER_AUTH_MISSING", message: "NAVER_MAPS_CLIENT_ID/SECRET \uD658\uACBD\uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.", metadata };
+  }
+  const maptype = input.maptype ?? "basic";
+  const width = input.width ?? 700;
+  const height = input.height ?? 500;
+  let trimmed = markers;
+  if (markers.length > STATIC_MAP_MAX_MARKERS) {
+    trimmed = markers.slice(0, STATIC_MAP_MAX_MARKERS);
+    warnings.push(`\uC815\uC801\uC9C0\uB3C4\uB294 \uB9C8\uCEE4 \uCD5C\uB300 ${STATIC_MAP_MAX_MARKERS}\uAC1C\uAE4C\uC9C0\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. ${markers.length}\uAC1C \uC911 \uC55E ${STATIC_MAP_MAX_MARKERS}\uAC1C\uB9CC \uD45C\uC2DC\uD569\uB2C8\uB2E4.`);
+  }
+  if (input.radius_m) {
+    warnings.push("\uC815\uC801\uC9C0\uB3C4\uC5D0\uB294 \uBC18\uACBD \uC6D0\uC744 \uADF8\uB9B4 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBC18\uACBD\uC740 \uC90C \uB808\uBCA8 \uACB0\uC815\uC5D0\uB9CC \uC0AC\uC6A9\uB429\uB2C8\uB2E4.");
+  }
+  const useCenter = trimmed.length === 0 && input.center;
+  const level = input.level ?? (input.radius_m ? levelForRadius(input.radius_m) : 16);
+  const result = await fetchStaticMap(
+    {
+      width,
+      height,
+      maptype,
+      ...useCenter ? { center: input.center, level } : {},
+      ...trimmed.length > 0 ? { markers: trimmed.map((m) => ({ lat: m.lat, lng: m.lng, ...m.label ? { label: m.label } : {}, ...m.color ? { color: m.color } : {} })) } : {}
+    },
+    env,
+    deps.fetcher
+  );
+  if ("error" in result) {
+    return {
+      error: result.error === "NAVER_AUTH_MISSING" ? "NAVER_AUTH_MISSING" : "STATIC_MAP_API_ERROR",
+      message: result.error === "NAVER_AUTH_MISSING" ? "\uC778\uC99D\uD0A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." : `\uC815\uC801\uC9C0\uB3C4 API \uC624\uB958 (HTTP ${result.status ?? "?"})`,
+      metadata
+    };
+  }
+  return {
+    image: { base64: result.base64, mimeType: result.mimeType },
+    marker_count: trimmed.length,
+    maptype,
+    warnings,
+    metadata
+  };
+}
+
+// src/tool-metadata.ts
+var SERVICE_DISPLAY_NAME = "Presale Remote MCP(\uBD84\uC591\uAC00 \uBD84\uC11D MCP)";
+var readOnlyAnnotations = (title) => ({
+  title,
+  readOnlyHint: true,
+  destructiveHint: false,
+  openWorldHint: true,
+  idempotentHint: true
+});
+var TOOL_METADATA = {
+  get_geocode: {
+    title: "Geocode Address",
+    description: `${SERVICE_DISPLAY_NAME} geocodes a Korean road-name or lot-number address into latitude/longitude with Naver Geocoding, and adds Kakao legal-dong region_code when available.`,
+    annotations: readOnlyAnnotations("Geocode Address")
+  },
+  search_by_nearby_category: {
+    title: "Search Nearby Category",
+    description: `${SERVICE_DISPLAY_NAME} searches categorized nearby POIs around coordinates with Kakao Local category search, such as schools, subway stations, and large marts. Use keyword search for apartments or officetels.`,
+    annotations: readOnlyAnnotations("Search Nearby Category")
+  },
+  search_by_nearby_keyword: {
+    title: "Search Nearby Keyword",
+    description: `${SERVICE_DISPLAY_NAME} searches nearby places by Kakao Local keyword around coordinates. Supports apartment/officetel/library presets, category filters, dedupe, distance limit, offset pagination, and grid mode for dense or wide-radius searches that need better recall. If has_more is true, continue with next_offset.`,
+    annotations: readOnlyAnnotations("Search Nearby Keyword")
+  },
+  search_presale_announcements: {
+    title: "Search Presale Announcements",
+    description: `${SERVICE_DISPLAY_NAME} searches ApplyHome APT presale announcements by region, address, house_name, date, move-in month, or best-effort coordinate radius. If house_name returns no results, retry via address/region/coordinate search using get_address and get_region_code hints.`,
+    annotations: readOnlyAnnotations("Search Presale Announcements")
+  },
+  get_announcement_detail: {
+    title: "Get Announcement Detail",
+    description: `${SERVICE_DISPLAY_NAME} retrieves ApplyHome APT announcement unit-type details by house_manage_no and announcement_id, including exclusive area, supply area, pyeong, and supplied units. It does not calculate presale price or premium.`,
+    annotations: readOnlyAnnotations("Get Announcement Detail")
+  },
+  get_complex_info: {
+    title: "Get Complex Info",
+    description: `${SERVICE_DISPLAY_NAME} retrieves K-apt apartment complex metadata regardless of unit count. Provide kapt_code, bjd_code plus complex_name, or complex_query for automatic location and K-apt code resolution. Ambiguous or unregistered complexes return candidates or NOT_FOUND without guessing.`,
+    annotations: readOnlyAnnotations("Get Complex Info")
+  },
+  get_complex_trades: {
+    title: "Get Complex Trades",
+    description: `${SERVICE_DISPLAY_NAME} retrieves MOLIT apartment sale, resale, rent, or all three trade types by region_code and year_month, with optional complex_query or legal-dong/jibun filters. For resale, resale_ownership can include occupancy-right rows separately from presale rights. It returns NOT_FOUND or PARTIAL when trades cannot be confirmed and does not estimate prices.`,
+    annotations: readOnlyAnnotations("Get Complex Trades")
+  },
+  get_address: {
+    title: "Get Address Candidates",
+    description: `${SERVICE_DISPLAY_NAME} converts a place or apartment name into Kakao Local address candidates with coordinates. Use this helper when only a complex name is known before geocoding, region lookup, or complex-specific calls.`,
+    annotations: readOnlyAnnotations("Get Address Candidates")
+  },
+  get_region_code: {
+    title: "Get Region Code",
+    description: `${SERVICE_DISPLAY_NAME} resolves an address or region name into legal-dong full_code, sigungu_code, and ApplyHome sido code using Kakao address search. Use full_code for get_complex_info and sigungu_code for get_complex_trades.`,
+    annotations: readOnlyAnnotations("Get Region Code")
+  },
+  get_static_map: {
+    title: "Get Static Map",
+    description: `${SERVICE_DISPLAY_NAME} creates a Naver Static Map image for markers, center, radius-based zoom, and map type. It returns an image directly and does not store map payloads.`,
+    annotations: readOnlyAnnotations("Get Static Map")
+  }
+};
+
+// src/tool-input-schemas.ts
+import { z } from "zod";
+var emptyToUndefined = (value) => value === "" || value === null ? void 0 : value;
+var requiredNumber = (description) => z.preprocess(emptyToUndefined, z.coerce.number()).describe(description);
+var searchNearbyKeywordInputShape = {
+  center_lat: requiredNumber("\uAC80\uC0C9 \uC911\uC2EC \uC704\uB3C4"),
+  center_lng: requiredNumber("\uAC80\uC0C9 \uC911\uC2EC \uACBD\uB3C4"),
+  radius_m: z.preprocess(emptyToUndefined, z.coerce.number().int().min(0).max(2e4).default(2e3)).describe("\uAC80\uC0C9 \uBC18\uACBD \uBBF8\uD130. \uCD5C\uB300 20000"),
+  query: z.string().optional().describe("\uC9C1\uC811 \uAC80\uC0C9 \uD0A4\uC6CC\uB4DC. preset \uBBF8\uC0AC\uC6A9 \uC2DC \uD544\uC218"),
+  preset: z.enum(["apartment", "officetel", "library"]).optional().describe("\uBBF8\uB9AC \uC815\uC758\uB41C \uAC80\uC0C9 preset"),
+  category_filter: z.object({
+    include_contains: z.array(z.string()).optional(),
+    exclude_contains: z.array(z.string()).optional()
+  }).optional().describe("\uCE74\uCE74\uC624 category_name \uAE30\uBC18 \uD3EC\uD568/\uC81C\uC678 \uD544\uD130"),
+  deduplicate_by: z.enum(["name", "address"]).optional().describe("\uC911\uBCF5 \uC81C\uAC70 \uAE30\uC900"),
+  grid: z.boolean().optional().describe("true\uBA74 \uBC18\uACBD\uC744 rect \uACA9\uC790(\uC57D 1.25km \uC140)\uB85C \uBD84\uD560\uD574 \uAC01 \uC140\uC744 \uAC80\uC0C9\xB7\uD569\uC9D1\uD569\uD569\uB2C8\uB2E4. \uCE74\uCE74\uC624 \uD0A4\uC6CC\uB4DC \uAC80\uC0C9\uC774 \uAC70\uB9AC\uC21C \uCD5C\uB300 ~45\uAC74\uB9CC \uC8FC\uB294 \uD55C\uACC4\uB97C \uC6B0\uD68C\uD574 \uBC00\uC9D1 \uC9C0\uC5ED(\uC608: 5km \uB0B4 \uC544\uD30C\uD2B8 \uB2E4\uC218)\uC744 \uB204\uB77D \uC5C6\uC774 \uC218\uC9D1\uD569\uB2C8\uB2E4. \uD638\uCD9C \uC218\uAC00 \uB298\uC5B4\uB098\uB2C8 \uB113\uC740 \uBC18\uACBD \uC804\uC218 \uC218\uC9D1\uC5D0\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694."),
+  limit: z.preprocess(emptyToUndefined, z.coerce.number().int().min(1).max(200).default(50)).describe("\uAC70\uB9AC\uC21C \uC815\uB82C\xB7\uC911\uBCF5\uC81C\uAC70 \uD6C4 \uBC18\uD658\uD560 \uCD5C\uB300 \uC7A5\uC18C \uC218. \uAE30\uBCF8 50, \uCD5C\uB300 200"),
+  offset: z.preprocess(emptyToUndefined, z.coerce.number().int().min(0).default(0)).describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uC2DC\uC791 \uC704\uCE58. has_more=true\uC774\uBA74 next_offset\uC73C\uB85C \uC774\uC5B4 \uC870\uD68C\uD569\uB2C8\uB2E4. \uAE30\uBCF8 0")
+};
+
+// src/tool-output-schemas.ts
+import { z as z2 } from "zod";
+var nullableNumber = z2.number().nullable().optional();
+var optionalNumber3 = z2.number().optional();
+var toolMetadataSchema = z2.object({
+  cache_hit: z2.boolean(),
+  collected_at: z2.string(),
+  data_source: z2.string().optional(),
+  data_sources: z2.array(z2.string()).optional(),
+  providers_tried: z2.array(z2.string()).optional(),
+  sources: z2.array(z2.string()).optional(),
+  warnings: z2.array(z2.string()).optional(),
+  truncated: z2.boolean().optional(),
+  fallback_suggestion: z2.string().optional(),
+  area_note: z2.string().optional(),
+  filter_note: z2.string().optional(),
+  returned_count: z2.number().optional(),
+  omitted_count: z2.number().optional(),
+  result_limit: z2.number().optional(),
+  limit: z2.number().optional(),
+  offset: z2.number().optional(),
+  has_more: z2.boolean().optional(),
+  next_offset: z2.number().nullable().optional(),
+  source_count: z2.number().optional()
+});
+var placeResultSchema = z2.object({
+  name: z2.string(),
+  lat: z2.number(),
+  lng: z2.number(),
+  distance_m: z2.number(),
+  distance_label: z2.string(),
+  address: z2.string(),
+  road_address: z2.string().optional(),
+  kakao_place_id: z2.string(),
+  kakao_category_name: z2.string()
+});
+var addressCandidateSchema = placeResultSchema.extend({
+  distance_m: z2.number().optional(),
+  distance_label: z2.string().optional()
+});
+var keywordFilterSchema = z2.object({
+  include_contains: z2.array(z2.string()).optional(),
+  exclude_contains: z2.array(z2.string()).optional()
+});
+var tradeFilterSchema = z2.object({
+  umd: z2.string(),
+  jibun: z2.array(z2.string()),
+  jibun_match: z2.enum(["exact", "bonbun"]),
+  apt_name: z2.string().optional()
+});
+var tradeItemSchema = z2.object({
+  apt_name: z2.string(),
+  dong: z2.string(),
+  jibun: z2.string(),
+  area_sqm: z2.number(),
+  floor: z2.number().nullable(),
+  trade_date: z2.string(),
+  price_10k: z2.number().optional(),
+  pyeong_price: nullableNumber,
+  pyeong_price_supply_est: nullableNumber,
+  supply_ratio_assumed: z2.number().optional(),
+  area_basis: z2.literal("\uC804\uC6A9\uBA74\uC801").optional(),
+  build_year: z2.number().nullable().optional(),
+  deal_type: z2.string().optional(),
+  seller: z2.string().optional(),
+  buyer: z2.string().optional(),
+  land_leasehold: z2.string().optional(),
+  ownership_gbn: z2.string().optional(),
+  apt_seq: z2.string().optional(),
+  deposit_10k: z2.number().optional(),
+  monthly_rent_10k: z2.number().optional(),
+  lease_type: z2.enum(["\uC804\uC138", "\uC6D4\uC138"]).optional(),
+  contract_type: z2.string().optional()
+});
+var tradeSummarySchema = z2.object({
+  median_price_10k: z2.number().nullable().optional(),
+  min_price_10k: z2.number().nullable().optional(),
+  max_price_10k: z2.number().nullable().optional(),
+  median_pyeong_price: z2.number().nullable().optional(),
+  median_deposit_10k: z2.number().nullable().optional(),
+  min_deposit_10k: z2.number().nullable().optional(),
+  max_deposit_10k: z2.number().nullable().optional(),
+  monthly_rent_avg_10k: z2.number().nullable().optional(),
+  jeonse_ratio_pct: z2.null().optional(),
+  sample_count: z2.number()
+});
+var resaleOwnershipSummarySchema = z2.object({
+  presale: tradeSummarySchema,
+  occupancy_right: tradeSummarySchema,
+  other: tradeSummarySchema
+});
+var complexTradesNestedErrorSchema = z2.object({
+  trade_type: z2.enum(["sale", "resale", "rent", "all"]),
+  region_code: z2.string(),
+  year_month: z2.string(),
+  error: z2.enum(["AUTH_MISSING", "NOT_FOUND", "API_ERROR", "PARSE_ERROR", "INVALID_INPUT"]),
+  message: z2.string(),
+  metadata: toolMetadataSchema.extend({
+    data_source: z2.string(),
+    sources: z2.array(z2.string())
+  })
+});
+var complexTradesSingleSuccessSchema = z2.object({
+  trade_type: z2.enum(["sale", "resale", "rent"]),
+  region_code: z2.string(),
+  year_month: z2.string(),
+  filter_applied: tradeFilterSchema.nullable(),
+  total_count: z2.number(),
+  filtered_count: z2.number(),
+  items: z2.array(tradeItemSchema),
+  summary: tradeSummarySchema,
+  summary_by_ownership: resaleOwnershipSummarySchema.optional(),
+  metadata: toolMetadataSchema.extend({
+    data_source: z2.string(),
+    sources: z2.array(z2.string()),
+    area_note: z2.string(),
+    filter_note: z2.string(),
+    returned_count: z2.number(),
+    omitted_count: z2.number(),
+    truncated: z2.boolean(),
+    source_count: z2.number()
+  })
+});
+var complexBasicSchema = z2.object({
+  build_year: z2.number().nullable(),
+  use_approval_date: z2.string().nullable(),
+  total_units: z2.number().nullable(),
+  dong_count: z2.number().nullable(),
+  constructor: z2.string().nullable(),
+  developer: z2.string().nullable(),
+  sale_type: z2.string().nullable(),
+  heat_type: z2.string().nullable(),
+  mgmt_type: z2.string().nullable(),
+  hall_type: z2.string().nullable(),
+  complex_category: z2.string().nullable(),
+  top_floor: z2.number().nullable(),
+  base_floor: z2.number().nullable(),
+  total_floor_area: z2.number().nullable(),
+  private_area_sum: z2.number().nullable(),
+  ho_count: z2.number().nullable(),
+  unit_mix: z2.object({
+    under_60: z2.number().nullable(),
+    _60_85: z2.number().nullable(),
+    _85_135: z2.number().nullable(),
+    over_135: z2.number().nullable()
+  }),
+  address_jibun: z2.string().nullable(),
+  address_road: z2.string().nullable(),
+  bjd_code: z2.string().nullable(),
+  office_tel: z2.string().nullable(),
+  homepage: z2.string().nullable()
+});
+var complexDetailSchema = z2.object({
+  parking_ground: z2.number().nullable(),
+  parking_underground: z2.number().nullable(),
+  elevator_count: z2.number().nullable(),
+  cctv_count: z2.number().nullable(),
+  subway_line: z2.string().nullable(),
+  subway_station: z2.string().nullable(),
+  subway_walk_min: z2.string().nullable(),
+  bus_walk_min: z2.string().nullable(),
+  welfare_facility: z2.string().nullable(),
+  convenient_facility: z2.string().nullable(),
+  education_facility: z2.string().nullable(),
+  ev_charger_ground: z2.number().nullable(),
+  ev_charger_underground: z2.number().nullable(),
+  structure: z2.string().nullable(),
+  water_supply: z2.string().nullable(),
+  home_network: z2.string().nullable(),
+  use_yn: z2.string().nullable()
+});
+var getGeocodeOutputShape = {
+  address: z2.string(),
+  lat: z2.number(),
+  lng: z2.number(),
+  normalized_address: z2.string(),
+  address_type: z2.enum(["road", "jibun", "approximate"]),
+  matched_provider: z2.literal("naver"),
+  road_address: z2.string().optional(),
+  region: z2.object({
+    sido: z2.string().optional(),
+    sigungu: z2.string().optional(),
+    eupmyeondong: z2.string().optional(),
+    jibun: z2.string().optional()
+  }),
+  region_code: z2.string().optional(),
+  confidence: z2.enum(["exact", "partial"]),
+  metadata: toolMetadataSchema
+};
+var getRegionCodeOutputShape = {
+  query: z2.string(),
+  full_code: z2.string(),
+  sigungu_code: z2.string(),
+  sido_code: z2.string(),
+  applyhome_code: z2.string().optional(),
+  region_name: z2.string(),
+  address_name: z2.string().optional(),
+  lat: optionalNumber3,
+  lng: optionalNumber3,
+  resolved_via: z2.enum(["address", "keyword_fallback"]).optional(),
+  metadata: toolMetadataSchema
+};
+var searchNearbyCategoryOutputShape = {
+  center: z2.object({
+    lat: z2.number(),
+    lng: z2.number()
+  }),
+  radius_m: z2.number(),
+  results: z2.record(z2.string(), z2.array(placeResultSchema)),
+  summary: z2.object({
+    total: z2.number(),
+    by_category: z2.record(z2.string(), z2.number())
+  }),
+  metadata: toolMetadataSchema
+};
+var searchNearbyKeywordOutputShape = {
+  center: z2.object({
+    lat: z2.number(),
+    lng: z2.number()
+  }),
+  radius_m: z2.number(),
+  query: z2.string(),
+  filter_applied: keywordFilterSchema.nullable(),
+  deduplicate_by: z2.enum(["name", "address"]).nullable(),
+  results: z2.array(placeResultSchema),
+  summary: z2.object({
+    total_found: z2.number(),
+    after_filter: z2.number(),
+    after_dedupe: z2.number()
+  }),
+  metadata: toolMetadataSchema
+};
+var getAddressOutputShape = {
+  query: z2.string(),
+  results: z2.array(addressCandidateSchema),
+  summary: z2.object({
+    total_found: z2.number()
+  }),
+  metadata: toolMetadataSchema
+};
+var getComplexInfoOutputShape = {
+  kapt_code: z2.string(),
+  name: z2.string(),
+  resolved_from: z2.enum(["kapt_code", "bjd_code+name", "complex_query"]),
+  match: z2.enum(["exact", "approximate"]).optional(),
+  resolved_location: z2.object({
+    address: z2.string(),
+    umd: z2.string().optional(),
+    jibun: z2.string().optional(),
+    full_code: z2.string(),
+    sigungu_code: z2.string(),
+    kakao_place_name: z2.string(),
+    warnings: z2.array(z2.string())
+  }).optional(),
+  basic: complexBasicSchema,
+  detail: complexDetailSchema.nullable(),
+  derived: z2.object({
+    parking_per_unit: z2.number().optional()
+  }),
+  metadata: toolMetadataSchema.extend({
+    data_source: z2.literal("kapt_basis_info_v4"),
+    sources: z2.array(z2.string()),
+    note: z2.string()
+  })
+};
+var getComplexTradesOutputSchema = z2.object({
+  trade_type: z2.enum(["sale", "resale", "rent", "all"]),
+  region_code: z2.string(),
+  year_month: z2.string(),
+  filter_applied: tradeFilterSchema.nullable(),
+  total_count: z2.number().optional(),
+  filtered_count: z2.number().optional(),
+  items: z2.array(tradeItemSchema).optional(),
+  summary: tradeSummarySchema.optional(),
+  summary_by_ownership: resaleOwnershipSummarySchema.optional(),
+  results: z2.object({
+    sale: z2.union([complexTradesSingleSuccessSchema, complexTradesNestedErrorSchema]),
+    rent: z2.union([complexTradesSingleSuccessSchema, complexTradesNestedErrorSchema]),
+    resale: z2.union([complexTradesSingleSuccessSchema, complexTradesNestedErrorSchema])
+  }).optional(),
+  primary_type: z2.enum(["sale", "resale", "rent"]).nullable().optional(),
+  metadata: toolMetadataSchema.extend({
+    sources: z2.array(z2.string()),
+    returned_count: z2.number(),
+    omitted_count: z2.number(),
+    truncated: z2.boolean(),
+    source_count: z2.number()
+  })
+});
+var getStaticMapOutputShape = {
+  marker_count: z2.number(),
+  maptype: z2.enum(["basic", "satellite", "satellite_base", "terrain", "traffic"]),
+  warnings: z2.array(z2.string())
+};
+var TOOL_OUTPUT_SCHEMAS = {
+  get_geocode: getGeocodeOutputShape,
+  search_by_nearby_category: searchNearbyCategoryOutputShape,
+  search_by_nearby_keyword: searchNearbyKeywordOutputShape,
+  get_address: getAddressOutputShape,
+  get_region_code: getRegionCodeOutputShape,
+  get_complex_info: getComplexInfoOutputShape,
+  get_complex_trades: getComplexTradesOutputSchema,
+  get_static_map: getStaticMapOutputShape
+};
+
+// src/tool-result.ts
+function isStructuredContent(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function jsonToolResult(value, isError = false) {
+  const text3 = JSON.stringify(value) ?? "null";
+  return {
+    content: [{ type: "text", text: text3 }],
+    ...!isError && isStructuredContent(value) ? { structuredContent: value } : {},
+    ...isError ? { isError: true } : {}
+  };
+}
+function imageToolResult(base64, mimeType, summary) {
+  const summaryText = JSON.stringify(summary) ?? "null";
+  return {
+    content: [
+      { type: "image", data: base64, mimeType },
+      { type: "text", text: summaryText }
+    ],
+    ...isStructuredContent(summary) ? { structuredContent: summary } : {}
+  };
+}
+
+// src/index.ts
+function readEnv() {
+  const env = {};
+  if (process.env.KAKAO_REST_API_KEY) env.KAKAO_REST_API_KEY = process.env.KAKAO_REST_API_KEY;
+  if (process.env.NAVER_MAPS_CLIENT_ID) env.NAVER_MAPS_CLIENT_ID = process.env.NAVER_MAPS_CLIENT_ID;
+  if (process.env.NAVER_MAPS_CLIENT_SECRET) env.NAVER_MAPS_CLIENT_SECRET = process.env.NAVER_MAPS_CLIENT_SECRET;
+  if (process.env.DATA_GO_KR_SERVICE_KEY) env.DATA_GO_KR_SERVICE_KEY = process.env.DATA_GO_KR_SERVICE_KEY;
+  if (!env.KAKAO_REST_API_KEY) console.error("[warn] KAKAO_REST_API_KEY not set \u2014 Kakao tools will fail.");
+  if (!env.NAVER_MAPS_CLIENT_ID || !env.NAVER_MAPS_CLIENT_SECRET) {
+    console.error("[warn] NAVER_MAPS_CLIENT_ID/SECRET not set \u2014 get_geocode (required) and get_static_map will fail.");
+  }
+  if (!env.DATA_GO_KR_SERVICE_KEY) {
+    console.error("[warn] DATA_GO_KR_SERVICE_KEY not set \u2014 presale/complex-info/complex-trades tools will fail.");
+  }
+  return env;
+}
+function createServer(env) {
+  const cache = createCache();
+  const server = new McpServer({
+    name: "presale-mcp",
+    version: "0.1.0"
+  });
+  const registerTool = (name, config, handler) => {
+    server.registerTool(name, config, async (input, extra) => handler(input, extra));
+  };
+  registerTool(
+    "get_geocode",
+    {
+      ...TOOL_METADATA.get_geocode,
+      inputSchema: {
+        address: z3.string().min(1).describe("\uB3C4\uB85C\uBA85 \uB610\uB294 \uC9C0\uBC88 \uC8FC\uC18C. \uC608: \uCDA9\uB0A8 \uCC9C\uC548\uC2DC \uC11C\uBD81\uAD6C \uC640\uCD0C\uB3D9 59-6")
+      },
+      outputSchema: TOOL_OUTPUT_SCHEMAS.get_geocode
+    },
+    async (input) => {
+      const result = await getGeocode(input, env, fetch, { cache });
+      return jsonToolResult(result, "error" in result);
+    }
+  );
+  registerTool(
+    "search_by_nearby_category",
+    {
+      ...TOOL_METADATA.search_by_nearby_category,
+      inputSchema: {
+        center_lat: z3.number().describe("\uAC80\uC0C9 \uC911\uC2EC \uC704\uB3C4"),
+        center_lng: z3.number().describe("\uAC80\uC0C9 \uC911\uC2EC \uACBD\uB3C4"),
+        radius_m: z3.number().int().min(0).max(2e4).default(2e3).describe("\uAC80\uC0C9 \uBC18\uACBD \uBBF8\uD130. \uCD5C\uB300 20000"),
+        categories: z3.array(z3.string()).optional().describe("\uCE74\uD14C\uACE0\uB9AC ID \uB610\uB294 \uBCC4\uCE6D \uBC30\uC5F4. \uC608: school_elementary, school, subway, mart_large"),
+        subcategory_filter: z3.object({ category_name_contains: z3.string().optional() }).optional().describe("\uCE74\uCE74\uC624 category_name \uCD94\uAC00 \uD3EC\uD568 \uD544\uD130")
+      },
+      outputSchema: TOOL_OUTPUT_SCHEMAS.search_by_nearby_category
+    },
+    async (input) => jsonToolResult(await searchByNearbyCategory(input, env, fetch, { cache }))
+  );
+  registerTool(
+    "search_by_nearby_keyword",
+    {
+      ...TOOL_METADATA.search_by_nearby_keyword,
+      inputSchema: searchNearbyKeywordInputShape,
+      outputSchema: TOOL_OUTPUT_SCHEMAS.search_by_nearby_keyword
+    },
+    async (input) => jsonToolResult(await searchByNearbyKeyword(input, env, fetch, { cache }))
+  );
+  registerTool(
+    "search_presale_announcements",
+    {
+      ...TOOL_METADATA.search_presale_announcements,
+      inputSchema: {
+        center_lat: z3.number().optional().describe("\uAC80\uC0C9 \uC911\uC2EC \uC704\uB3C4. ApplyHome\uC740 \uBC18\uACBD \uAC80\uC0C9\uC744 \uC9C1\uC811 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC73C\uBBC0\uB85C \uBC95\uC815\uB3D9 \uC0D8\uD50C\uB9C1 \uD6C4 \uAC70\uB9AC \uC7AC\uD544\uD130\uB9C1\uD558\uB294 best-effort \uBC29\uC2DD\uC785\uB2C8\uB2E4."),
+        center_lng: z3.number().optional().describe("\uAC80\uC0C9 \uC911\uC2EC \uACBD\uB3C4. ApplyHome\uC740 \uBC18\uACBD \uAC80\uC0C9\uC744 \uC9C1\uC811 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC73C\uBBC0\uB85C \uBC95\uC815\uB3D9 \uC0D8\uD50C\uB9C1 \uD6C4 \uAC70\uB9AC \uC7AC\uD544\uD130\uB9C1\uD558\uB294 best-effort \uBC29\uC2DD\uC785\uB2C8\uB2E4."),
+        radius_km: z3.number().int().min(1).max(20).default(5).describe("\uAC80\uC0C9 \uBC18\uACBD km. \uAE30\uBCF8 5km"),
+        months_back: z3.number().int().min(1).max(180).default(24).describe("\uCD5C\uADFC N\uAC1C\uC6D4 \uACF5\uACE0. \uAE30\uBCF8 24\uAC1C\uC6D4, \uCD5C\uB300 180\uAC1C\uC6D4. 2018\uB144 \uC774\uD6C4 \uC785\uC8FC \uAC80\uC99D\uC740 date_from \uB610\uB294 \uCDA9\uBD84\uD788 \uD070 months_back\uC744 \uC0AC\uC6A9\uD558\uC138\uC694."),
+        year: z3.number().int().min(2021).max(2100).optional().describe("\uD2B9\uC815 \uACF5\uACE0 \uC5F0\uB3C4. \uC608: 2025. date_from/date_to\uBCF4\uB2E4 \uC6B0\uC120\uD569\uB2C8\uB2E4."),
+        date_from: z3.string().optional().describe("\uACF5\uACE0\uC77C \uC2DC\uC791\uC77C YYYY-MM-DD"),
+        date_to: z3.string().optional().describe("\uACF5\uACE0\uC77C \uC885\uB8CC\uC77C YYYY-MM-DD"),
+        move_in_from: z3.string().optional().describe("\uC785\uC8FC\uC608\uC815\uC6D4 \uC2DC\uC791 YYYY-MM \uB610\uB294 YYYYMM. ApplyHome \uACB0\uACFC \uD6C4\uCC98\uB9AC \uD544\uD130\uC785\uB2C8\uB2E4."),
+        move_in_to: z3.string().optional().describe("\uC785\uC8FC\uC608\uC815\uC6D4 \uC885\uB8CC YYYY-MM \uB610\uB294 YYYYMM. ApplyHome \uACB0\uACFC \uD6C4\uCC98\uB9AC \uD544\uD130\uC785\uB2C8\uB2E4."),
+        region_codes: z3.array(z3.string()).optional().describe("ApplyHome SUBSCRPT_AREA_CODE \uC2DC\uB3C4 \uCF54\uB4DC \uBC30\uC5F4. \uC608: 300, 312"),
+        status_filter: z3.array(z3.string()).optional().describe("\uC0C1\uD0DC \uD544\uD130. \uC608: \uBD84\uC591\uC608\uC815, \uBD84\uC591\uC911, \uCCAD\uC57D\uC644\uB8CC, \uACC4\uC57D\uC9C4\uD589, \uBD84\uC591\uC644\uB8CC"),
+        house_name: z3.string().optional().describe("\uC8FC\uD0DD\uBA85 LIKE \uAC80\uC0C9\uC5B4. \uD45C\uAE30 \uCC28\uC774\uB85C 0\uAC74\uC774\uBA74 \uC751\uB2F5\uC758 next \uD78C\uD2B8\uC5D0 \uB530\uB77C get_address/get_region_code \uD6C4 \uC9C0\uC5ED/\uBC18\uACBD \uAC80\uC0C9\uC73C\uB85C \uC7AC\uC870\uD68C\uD558\uC138\uC694."),
+        apply_address: z3.string().optional().describe("\uACF5\uAE09\uC704\uCE58 HSSPLY_ADRES LIKE \uAC80\uC0C9\uC5B4. \uC608: \uB0A8\uC591\uC8FC\uC2DC, \uACE0\uC591\uC2DC \uC77C\uC0B0\uB3D9\uAD6C"),
+        limit: z3.number().int().min(1).max(100).default(30).describe("\uC751\uB2F5\uC5D0 \uBC18\uD658\uD560 \uBD84\uC591\uACF5\uACE0 \uC218. \uC694\uC57D\uC740 \uC804\uCCB4 \uD544\uD130 \uACB0\uACFC \uAE30\uC900\uC73C\uB85C \uACC4\uC0B0\uD558\uACE0 announcements\uB9CC \uC81C\uD55C\uD569\uB2C8\uB2E4. \uAE30\uBCF8 30, \uCD5C\uB300 100")
+      }
+    },
+    async (input) => jsonToolResult(await searchPresaleAnnouncements(input, env, { cache }))
+  );
+  registerTool(
+    "get_announcement_detail",
+    {
+      ...TOOL_METADATA.get_announcement_detail,
+      inputSchema: {
+        house_manage_no: z3.string().min(1).describe("\uC8FC\uD0DD\uAD00\uB9AC\uBC88\uD638 (HOUSE_MANAGE_NO)"),
+        announcement_id: z3.string().min(1).describe("\uACF5\uACE0\uBC88\uD638 (PBLANC_NO)"),
+        type: z3.enum(["apt", "urbty", "remndr", "opt", "pbl_pvt_rent"]).default("apt").describe("\uACF5\uAE09\uC720\uD615. \uAE30\uBCF8\uAC12\uC740 apt(\uACF5\uB3D9\uC8FC\uD0DD)\uC774\uBA70, \uB300\uBD80\uBD84\uC758 APT \uBD84\uC591\uACF5\uACE0\uB294 apt\uB97C \uC0AC\uC6A9\uD569\uB2C8\uB2E4.")
+      }
+    },
+    async (input) => {
+      const result = await getAnnouncementDetail(input, env, { cache });
+      return jsonToolResult(result, "error" in result);
+    }
+  );
+  registerTool(
+    "get_complex_info",
+    {
+      ...TOOL_METADATA.get_complex_info,
+      inputSchema: {
+        kapt_code: z3.string().optional().describe("\uB2E8\uC9C0\uCF54\uB4DC. \uC54C\uBA74 \uC774\uAC83\uB9CC\uC73C\uB85C \uBC14\uB85C \uC870\uD68C(\uD574\uC18C \uB2E8\uACC4 \uC0DD\uB7B5)."),
+        bjd_code: z3.string().optional().describe("\uBC95\uC815\uB3D9\uCF54\uB4DC 10\uC790\uB9AC. kapt_code\uAC00 \uC5C6\uC744 \uB54C complex_name\uACFC \uD568\uAED8 \uB2E8\uC9C0\uCF54\uB4DC \uD574\uC18C\uC5D0 \uC0AC\uC6A9. get_geocode\uC758 region_code\uC5D0\uC11C \uC5BB\uC744 \uC218 \uC788\uC74C."),
+        complex_name: z3.string().optional().describe("\uB2E8\uC9C0\uBA85. kapt_code\uAC00 \uC5C6\uC744 \uB54C bjd_code\uC640 \uD568\uAED8 \uB9E4\uCE6D."),
+        complex_query: z3.string().optional().describe("\uB2E8\uC9C0\uBA85 \uB610\uB294 \uC8FC\uC18C \uC790\uC720\uD615 \uC785\uB825. \uC774\uAC83\uB9CC \uC8FC\uBA74 \uB0B4\uBD80\uC5D0\uC11C \uCE74\uCE74\uC624 \uAC80\uC0C9\u2192\uC8FC\uC18C\u2192\uBC95\uC815\uB3D9\uCF54\uB4DC\uB97C \uC790\uB3D9 \uD574\uC18C\uD55C \uB4A4 K-apt \uB2E8\uC9C0\uB97C \uB9E4\uCE6D\uD569\uB2C8\uB2E4(\uAC00\uC7A5 \uAC04\uD3B8\uD55C \uC785\uAD6C). kapt_code/bjd_code\uAC00 \uC788\uC73C\uBA74 \uADF8\uCABD\uC774 \uC6B0\uC120."),
+        detail: z3.boolean().default(false).describe("true\uBA74 \uC0C1\uC138\uC815\uBCF4(\uC8FC\uCC28\xB7\uC2B9\uAC15\uAE30\xB7CCTV\xB7\uAD50\uD1B5\xB7\uC2DC\uC124 \uB4F1)\uAE4C\uC9C0 \uC870\uD68C\xB7\uBCD1\uD569\uD558\uACE0 parking_per_unit\uC744 \uD30C\uC0DD.")
+      },
+      outputSchema: TOOL_OUTPUT_SCHEMAS.get_complex_info
+    },
+    async (input) => {
+      const result = await getComplexInfo(input, env, { cache });
+      return jsonToolResult(result, "error" in result);
+    }
+  );
+  registerTool(
+    "get_complex_trades",
+    {
+      ...TOOL_METADATA.get_complex_trades,
+      inputSchema: {
+        region_code: z3.string().regex(/^\d{5}$/).optional().describe("\uC2DC\uAD70\uAD6C\uCF54\uB4DC 5\uC790\uB9AC(LAWD_CD). get_region_code\uC758 sigungu_code \uC0AC\uC6A9. \uC608: 11110. complex_query\uB97C \uC8FC\uBA74 \uC0DD\uB7B5 \uAC00\uB2A5."),
+        year_month: z3.string().regex(/^\d{6}$/).describe("\uACC4\uC57D\uB144\uC6D4 YYYYMM. \uC608: 202407"),
+        trade_type: z3.enum(["sale", "resale", "rent", "all"]).default("sale").describe("\uAC70\uB798\uC720\uD615: sale=\uB9E4\uB9E4, resale=\uBD84\uC591\uAD8C\uC804\uB9E4, rent=\uC804\uC6D4\uC138, all=\uC138 \uC720\uD615 \uBCD1\uB82C \uC870\uD68C"),
+        resale_ownership: z3.enum(["presale_only", "all"]).default("presale_only").describe("\uBD84\uC591\uAD8C\uC804\uB9E4(resale) \uACB0\uACFC\uC758 \uC18C\uC720\uAD8C \uAD6C\uBD84. presale_only=\uBD84\uC591\uAD8C/\uACF5\uB780\uB9CC(\uAE30\uBCF8), all=\uC785\uC8FC\uAD8C \uD3EC\uD568. \uC785\uC8FC\uAD8C\uC740 \uC7AC\uAC74\uCD95 \uC870\uD569\uC6D0 \uBB3C\uB7C9\uC73C\uB85C \uC77C\uBC18\uBD84\uC591\uAC00\uC640 \uC131\uACA9\uC774 \uB2E4\uB985\uB2C8\uB2E4."),
+        complex_query: z3.string().optional().describe("\uB2E8\uC9C0\uBA85 \uB610\uB294 \uC8FC\uC18C \uC790\uC720\uD615 \uC785\uB825. \uC8FC\uBA74 \uCE74\uCE74\uC624 \uAC80\uC0C9\u2192\uC8FC\uC18C\u2192\uC2DC\uAD70\uAD6C\uCF54\uB4DC+\uBC95\uC815\uB3D9+\uC9C0\uBC88\uC744 \uC790\uB3D9 \uD574\uC18C\uD574 \uD574\uB2F9 \uB2E8\uC9C0 \uAC70\uB798\uB9CC \uD544\uD130\uB9C1\uD569\uB2C8\uB2E4(region_code/complex_filter \uC0DD\uB7B5 \uAC00\uB2A5)."),
+        complex_filter: z3.object({
+          umd: z3.string().min(1).describe("\uBC95\uC815\uB3D9\uBA85. \uC608: \uC22D\uC778\uB3D9"),
+          jibun: z3.union([z3.string(), z3.array(z3.string())]).describe("\uC9C0\uBC88 1\uAC1C \uB610\uB294 \uC5EC\uB7EC \uAC1C. \uC608: 202-3"),
+          jibun_match: z3.enum(["exact", "bonbun"]).default("exact").describe("exact=\uC804\uCCB4 \uC9C0\uBC88 \uC77C\uCE58, bonbun=\uBCF8\uBC88\uB9CC \uC77C\uCE58"),
+          apt_name: z3.string().optional().describe("\uC120\uD0DD \uBCF4\uC870 \uD544\uD130\uC6A9 \uB2E8\uC9C0\uBA85")
+        }).optional().describe("\uD2B9\uC815 \uB2E8\uC9C0 \uD544\uD130. \uC0DD\uB7B5\uD558\uBA74 \uC2DC\uAD70\uAD6C \uC804\uCCB4 \uAC70\uB798 \uBC18\uD658"),
+        num_of_rows: z3.number().int().min(1).max(1e3).default(1e3).describe("\uD398\uC774\uC9C0\uB2F9 \uC870\uD68C \uAC74\uC218. \uAE30\uBCF8 1000"),
+        limit: z3.number().int().min(1).max(100).default(30).describe("\uC751\uB2F5\uC5D0 \uBC18\uD658\uD560 \uAC70\uB798 \uD589 \uC218. \uC694\uC57D\uC740 \uC804\uCCB4 \uD544\uD130 \uACB0\uACFC \uAE30\uC900\uC73C\uB85C \uACC4\uC0B0\uD558\uACE0 items\uB9CC \uC81C\uD55C\uD569\uB2C8\uB2E4. \uAE30\uBCF8 30, \uCD5C\uB300 100")
+      },
+      outputSchema: TOOL_OUTPUT_SCHEMAS.get_complex_trades
+    },
+    async (input) => {
+      const result = await getComplexTrades(input, env, { cache });
+      return jsonToolResult(result, "error" in result);
+    }
+  );
+  registerTool(
+    "get_address",
+    {
+      ...TOOL_METADATA.get_address,
+      inputSchema: {
+        query: z3.string().min(1).describe("\uC7A5\uC18C\uBA85 \uB610\uB294 \uB2E8\uC9C0\uBA85. \uC608: \uB798\uBBF8\uC548\uC6D0\uBCA0\uC77C\uB9AC"),
+        size: z3.number().int().min(1).max(15).default(5).describe("\uBC18\uD658 \uD6C4\uBCF4 \uC218. \uAE30\uBCF8 5, \uCD5C\uB300 15"),
+        center_lat: z3.number().optional().describe("\uC815\uB82C \uAE30\uC900 \uC911\uC2EC \uC704\uB3C4. center_lng\uC640 \uD568\uAED8 \uC8FC\uBA74 \uAC70\uB9AC\uC21C \uC815\uB82C\uD569\uB2C8\uB2E4."),
+        center_lng: z3.number().optional().describe("\uC815\uB82C \uAE30\uC900 \uC911\uC2EC \uACBD\uB3C4. center_lat\uC640 \uD568\uAED8 \uC8FC\uBA74 \uAC70\uB9AC\uC21C \uC815\uB82C\uD569\uB2C8\uB2E4.")
+      },
+      outputSchema: TOOL_OUTPUT_SCHEMAS.get_address
+    },
+    async (input) => jsonToolResult(await getAddress(input, env, fetch, { cache }))
+  );
+  registerTool(
+    "get_region_code",
+    {
+      ...TOOL_METADATA.get_region_code,
+      inputSchema: {
+        query: z3.string().min(1).describe("\uC8FC\uC18C \uB610\uB294 \uC9C0\uC5ED\uBA85. \uC608: \uCDA9\uB0A8 \uCC9C\uC548\uC2DC \uC11C\uBD81\uAD6C \uC640\uCD0C\uB3D9 59-6")
+      },
+      outputSchema: TOOL_OUTPUT_SCHEMAS.get_region_code
+    },
+    async (input) => {
+      const result = await getRegionCode(input, env, fetch, { cache });
+      return jsonToolResult(result, "error" in result);
+    }
+  );
+  registerTool(
+    "get_static_map",
+    {
+      ...TOOL_METADATA.get_static_map,
+      inputSchema: {
+        markers: z3.array(
+          z3.object({
+            lat: z3.number().describe("\uC704\uB3C4"),
+            lng: z3.number().describe("\uACBD\uB3C4"),
+            label: z3.string().optional().describe("\uB9C8\uCEE4 \uB77C\uBCA8 A-Z \uB610\uB294 0-9"),
+            color: z3.string().optional().describe("\uB9C8\uCEE4 \uC0C9. Red/Blue/Orange/Yellow/Green/Purple/Gray \uB610\uB294 0xRRGGBB"),
+            info: z3.string().optional().describe("\uCC38\uACE0\uC6A9 \uC124\uBA85(\uC815\uC801\uC9C0\uB3C4\uC5D0\uB294 \uB80C\uB354\uB9C1\uB418\uC9C0 \uC54A\uC74C)")
+          })
+        ).optional().describe("\uC9C0\uB3C4\uC5D0 \uD45C\uC2DC\uD560 \uB9C8\uCEE4 \uBC30\uC5F4(\uCD5C\uB300 20). \uC8FC\uBA74 \uB124\uC774\uBC84\uAC00 \uC790\uB3D9\uC73C\uB85C \uC601\uC5ED\uC744 \uB9DE\uCDA5\uB2C8\uB2E4."),
+        center: z3.object({ lat: z3.number(), lng: z3.number() }).optional().describe("\uC911\uC2EC \uC88C\uD45C. markers\uAC00 \uC5C6\uC744 \uB54C \uC0AC\uC6A9."),
+        radius_m: z3.number().int().min(0).optional().describe("\uBC18\uACBD(m). \uC90C \uB808\uBCA8 \uACB0\uC815\uC5D0\uB9CC \uC0AC\uC6A9(\uC6D0\uC740 \uADF8\uB824\uC9C0\uC9C0 \uC54A\uC74C)."),
+        maptype: z3.enum(["basic", "satellite", "satellite_base", "terrain", "traffic"]).optional().describe("\uC9C0\uB3C4\uC720\uD615. \uAE30\uBCF8 basic."),
+        width: z3.number().int().min(1).max(1024).optional().describe("\uC774\uBBF8\uC9C0 \uB108\uBE44 px(\uCD5C\uB300 1024, \uAE30\uBCF8 700)."),
+        height: z3.number().int().min(1).max(1024).optional().describe("\uC774\uBBF8\uC9C0 \uB192\uC774 px(\uCD5C\uB300 1024, \uAE30\uBCF8 500)."),
+        level: z3.number().int().min(0).max(20).optional().describe("\uC90C \uB808\uBCA8 0-20. \uC9C0\uC815 \uC2DC radius_m\uBCF4\uB2E4 \uC6B0\uC120.")
+      },
+      outputSchema: TOOL_OUTPUT_SCHEMAS.get_static_map
+    },
+    async (input) => {
+      const result = await getStaticMap(input, env);
+      if ("error" in result) return jsonToolResult(result, true);
+      return imageToolResult(result.image.base64, result.image.mimeType, {
+        marker_count: result.marker_count,
+        maptype: result.maptype,
+        warnings: result.warnings
+      });
+    }
+  );
+  return server;
+}
+async function main() {
+  const env = readEnv();
+  const server = createServer(env);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});