daiso 1.2.7 → 1.2.9

package/dist/services/megabox/location.js

@@ -1,14 +1,12 @@
 /**
  * 메가박스 위치 해석 및 근처 지점 조회 보조 모듈
  */
-import { fetchJson } from '../../utils/http.js';
+import { geocodeLocation, validKoreanCoordinates } from '../../utils/geocode.js';
 import { fetchMegaboxBookingList, fetchMegaboxTheaterInfo } from './client.js';
 const DEFAULT_LATITUDE = 37.5665;
 const DEFAULT_LONGITUDE = 126.978;
 const DEFAULT_AREA_CODE = '11';
 const DEFAULT_TIMEOUT_MS = 15000;
-const GEOCODE_CACHE_TTL_MS = 60 * 60 * 1000;
-const megaboxGeocodeCache = new Map();
 const MEGABOX_AREA_CODE_BY_REGION = [
     ['서울특별시', '11'],
     ['서울', '11'],
@@ -69,94 +67,31 @@ function resolveAreaCodeFromText(text) {
     }
     return null;
 }
-function resolveAreaCodeFromGeocodeResult(result) {
-    for (const component of result.address_components || []) {
-        const candidates = [component.long_name || '', component.short_name || ''];
-        for (const candidate of candidates) {
-            const areaCode = resolveAreaCodeFromText(candidate);
-            if (areaCode) {
-                return areaCode;
-            }
-        }
-    }
-    return resolveAreaCodeFromText(result.formatted_address || '');
-}
-async function geocodeMegaboxLocation(params, options = {}) {
-    const apiKey = (options.googleMapsApiKey || '').trim();
-    if (apiKey.length === 0) {
-        return null;
-    }
-    const hasCoordinates = isValidCoordinate(params.latitude) && isValidCoordinate(params.longitude);
-    const keyword = (params.keyword || '').trim();
-    if (!hasCoordinates && keyword.length === 0) {
-        return null;
-    }
-    const cacheKey = hasCoordinates ? `coords:${params.latitude},${params.longitude}` : `keyword:${keyword}`;
-    const cached = megaboxGeocodeCache.get(cacheKey);
-    if (cached && cached.expiresAt > Date.now()) {
-        return cached.value;
-    }
-    const endpoint = new URL('https://maps.googleapis.com/maps/api/geocode/json');
-    if (hasCoordinates) {
-        endpoint.searchParams.set('latlng', `${params.latitude},${params.longitude}`);
-    }
-    else {
-        endpoint.searchParams.set('address', keyword);
-    }
-    endpoint.searchParams.set('key', apiKey);
-    const body = await fetchJson(endpoint.toString(), {
-        method: 'GET',
-        timeout: options.timeout || DEFAULT_TIMEOUT_MS,
-        headers: {
-            Accept: 'application/json',
-        },
-    });
-    if (body.status !== 'OK') {
-        megaboxGeocodeCache.set(cacheKey, {
-            expiresAt: Date.now() + GEOCODE_CACHE_TTL_MS,
-            value: null,
-        });
-        return null;
-    }
-    const firstResult = body.results?.[0];
-    const latitude = firstResult?.geometry?.location?.lat;
-    const longitude = firstResult?.geometry?.location?.lng;
-    const areaCode = firstResult ? resolveAreaCodeFromGeocodeResult(firstResult) : null;
-    const value = typeof latitude === 'number' && typeof longitude === 'number'
-        ? { latitude, longitude, areaCode }
-        : null;
-    megaboxGeocodeCache.set(cacheKey, {
-        expiresAt: Date.now() + GEOCODE_CACHE_TTL_MS,
-        value,
-    });
-    return value;
-}
 export async function resolveMegaboxLocation(params, options = {}) {
     const explicitAreaCode = (params.areaCode || '').trim();
     const keyword = (params.keyword || '').trim();
     const hasCoordinates = isValidCoordinate(params.latitude) && isValidCoordinate(params.longitude);
-    let latitude = hasCoordinates ? params.latitude : DEFAULT_LATITUDE;
-    let longitude = hasCoordinates ? params.longitude : DEFAULT_LONGITUDE;
-    let areaCode = explicitAreaCode || '';
-    let geocodeUsed = false;
-    if (!explicitAreaCode || !hasCoordinates) {
-        const geocoded = await geocodeMegaboxLocation(params, options);
-        if (geocoded) {
-            if (!hasCoordinates) {
-                latitude = geocoded.latitude;
-                longitude = geocoded.longitude;
-            }
-            if (!explicitAreaCode && geocoded.areaCode) {
-                areaCode = geocoded.areaCode;
-            }
-            geocodeUsed = true;
-        }
-    }
+    if (hasCoordinates &&
+        !validKoreanCoordinates(params.latitude, params.longitude))
+        throw new Error('유효한 위도/경도를 입력해주세요.');
+    const geocoded = !hasCoordinates && keyword ? await geocodeLocation(keyword, options) : null;
+    if (keyword && !hasCoordinates && !geocoded)
+        throw new Error(`위치를 좌표로 변환하지 못했습니다: ${keyword}`);
+    const latitude = hasCoordinates
+        ? params.latitude
+        : (geocoded?.latitude ?? DEFAULT_LATITUDE);
+    const longitude = hasCoordinates
+        ? params.longitude
+        : (geocoded?.longitude ?? DEFAULT_LONGITUDE);
+    const areaCode = explicitAreaCode ||
+        resolveAreaCodeFromText(geocoded?.formattedAddress || keyword) ||
+        (hasCoordinates ? '' : DEFAULT_AREA_CODE);
+    const geocodeUsed = Boolean(geocoded);
     return {
         keyword: keyword.length > 0 ? keyword : null,
         latitude,
         longitude,
-        areaCode: areaCode || DEFAULT_AREA_CODE,
+        areaCode,
         geocodeUsed,
     };
 }
@@ -215,5 +150,5 @@ export async function resolveMegaboxNearestTheater(params, options = {}) {
     };
 }
 export function __testOnlyClearMegaboxLocationCaches() {
-    megaboxGeocodeCache.clear();
+    // 캐시를 유지하지 않으므로 초기화할 상태가 없습니다.
 }

package/dist/services/megabox/tools/findNearbyTheaters.js

@@ -4,7 +4,7 @@
 import * as z from 'zod';
 import { toYyyymmdd } from '../client.js';
 import { fetchMegaboxNearbyTheaters } from '../location.js';
-async function findNearbyTheaters(args) {
+async function findNearbyTheaters(args, geocodeOptions = {}) {
     const { keyword, latitude, longitude, playDate = toYyyymmdd(), areaCode, limit = 10, timeoutMs = 15000, } = args;
     const result = await fetchMegaboxNearbyTheaters({
         keyword,
@@ -15,14 +15,14 @@ async function findNearbyTheaters(args) {
         limit,
         timeout: timeoutMs,
     }, {
-        googleMapsApiKey: process.env.GOOGLE_MAPS_API_KEY,
+        ...geocodeOptions,
         timeout: timeoutMs,
     });
     return {
         content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
     };
 }
-export function createFindNearbyTheatersTool() {
+export function createFindNearbyTheatersTool(geocodeOptions = {}) {
     return {
         name: 'megabox_find_nearby_theaters',
         metadata: {
@@ -30,14 +30,14 @@ export function createFindNearbyTheatersTool() {
             description: '사용자 좌표 또는 위치 키워드 기준으로 메가박스 지점을 거리순으로 조회합니다.',
             inputSchema: {
                 keyword: z.string().optional().describe('위치 키워드 (예: 안산 중앙역, 강남역)'),
-                latitude: z.number().optional().default(37.5665).describe('위도 (기본값: 서울 시청 37.5665)'),
-                longitude: z.number().optional().default(126.978).describe('경도 (기본값: 서울 시청 126.978)'),
+                latitude: z.number().optional().describe('위도 (미입력 시 keyword 해석)'),
+                longitude: z.number().optional().describe('경도 (미입력 시 keyword 해석)'),
                 playDate: z.string().optional().describe('조회 날짜(YYYYMMDD, 기본값: 오늘)'),
-                areaCode: z.string().optional().default('11').describe('지역 코드 (기본값: 11, 서울)'),
+                areaCode: z.string().optional().describe('지역 코드 (미입력 시 위치로 결정)'),
                 limit: z.number().optional().default(10).describe('반환할 최대 지점 수 (기본값: 10)'),
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: findNearbyTheaters,
+        handler: ((args) => findNearbyTheaters(args, geocodeOptions)),
     };
 }

package/dist/services/megabox/tools/getRemainingSeats.js

@@ -4,7 +4,7 @@
 import * as z from 'zod';
 import { fetchMegaboxBookingList, toYyyymmdd } from '../client.js';
 import { resolveMegaboxNearestTheater } from '../location.js';
-async function getRemainingSeats(args) {
+async function getRemainingSeats(args, geocodeOptions = {}) {
     const { playDate = toYyyymmdd(), theaterId: inputTheaterId, movieId, keyword, latitude, longitude, areaCode, limit = 50, timeoutMs = 15000, } = args;
     let theaterId = inputTheaterId;
     let resolvedTheater = null;
@@ -18,7 +18,7 @@ async function getRemainingSeats(args) {
             playDate,
             timeout: timeoutMs,
         }, {
-            googleMapsApiKey: process.env.GOOGLE_MAPS_API_KEY,
+            ...geocodeOptions,
             timeout: timeoutMs,
         });
         theaterId = resolved.theater?.theaterId;
@@ -62,7 +62,7 @@ async function getRemainingSeats(args) {
         content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
     };
 }
-export function createGetRemainingSeatsTool() {
+export function createGetRemainingSeatsTool(geocodeOptions = {}) {
     return {
         name: 'megabox_get_remaining_seats',
         metadata: {
@@ -75,11 +75,11 @@ export function createGetRemainingSeatsTool() {
                 keyword: z.string().optional().describe('위치 키워드 (예: 안산 중앙역, 강남역)'),
                 latitude: z.number().optional().describe('위도'),
                 longitude: z.number().optional().describe('경도'),
-                areaCode: z.string().optional().default('11').describe('지역 코드 (기본값: 11, 서울)'),
+                areaCode: z.string().optional().describe('지역 코드 (미입력 시 위치로 결정)'),
                 limit: z.number().optional().default(50).describe('반환할 최대 회차 수 (기본값: 50)'),
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: getRemainingSeats,
+        handler: ((args) => getRemainingSeats(args, geocodeOptions)),
     };
 }

package/dist/services/megabox/tools/listNowShowing.js

@@ -4,7 +4,7 @@
 import * as z from 'zod';
 import { fetchMegaboxBookingList, toYyyymmdd } from '../client.js';
 import { resolveMegaboxNearestTheater } from '../location.js';
-async function listNowShowing(args) {
+async function listNowShowing(args, geocodeOptions = {}) {
     const { playDate = toYyyymmdd(), theaterId: inputTheaterId, movieId, keyword, latitude, longitude, areaCode, timeoutMs = 15000, } = args;
     let theaterId = inputTheaterId;
     let resolvedTheater = null;
@@ -18,7 +18,7 @@ async function listNowShowing(args) {
             playDate,
             timeout: timeoutMs,
         }, {
-            googleMapsApiKey: process.env.GOOGLE_MAPS_API_KEY,
+            ...geocodeOptions,
             timeout: timeoutMs,
         });
         theaterId = resolved.theater?.theaterId;
@@ -57,7 +57,7 @@ async function listNowShowing(args) {
         content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
     };
 }
-export function createListNowShowingTool() {
+export function createListNowShowingTool(geocodeOptions = {}) {
     return {
         name: 'megabox_list_now_showing',
         metadata: {
@@ -70,10 +70,10 @@ export function createListNowShowingTool() {
                 keyword: z.string().optional().describe('위치 키워드 (예: 안산 중앙역, 강남역)'),
                 latitude: z.number().optional().describe('위도'),
                 longitude: z.number().optional().describe('경도'),
-                areaCode: z.string().optional().default('11').describe('지역 코드 (기본값: 11, 서울)'),
+                areaCode: z.string().optional().describe('지역 코드 (미입력 시 위치로 결정)'),
                 timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
             },
         },
-        handler: listNowShowing,
+        handler: ((args) => listNowShowing(args, geocodeOptions)),
     };
 }

package/dist/services/oliveyoung/tools/checkInventory.js

@@ -4,7 +4,7 @@
 import * as z from 'zod';
 import { enrichOliveyoungProductsWithNearbyStoreInventory, fetchOliveyoungProducts, fetchOliveyoungStores, } from '../client.js';
 async function checkInventory(args, transport) {
-    const { keyword, latitude = 37.5665, longitude = 126.978, storeKeyword = '', page = 1, size = 20, sort = '01', includeSoldOut = false, storeLimit = 10, stockCheckLimit = 5, timeoutMs = 15000, zyteApiKey, } = args;
+    const { keyword, latitude = 37.5665, longitude = 126.978, storeKeyword = '', page = 1, size = 20, sort = '01', includeSoldOut = false, storeLimit = 10, stockCheckLimit = 5, timeoutMs = transport.timeout ?? (transport.relayUrl ? 60000 : 15000), zyteApiKey, } = args;
     if (!keyword || keyword.trim().length === 0) {
         throw new Error('상품 검색어(keyword)를 입력해주세요.');
     }
@@ -15,9 +15,9 @@ async function checkInventory(args, transport) {
             pageIdx: 1,
             searchWords: storeKeyword,
         }, {
-            timeout: timeoutMs,
             apiKey: zyteApiKey,
             ...transport,
+            timeout: timeoutMs,
         }),
         fetchOliveyoungProducts({
             keyword,
@@ -26,9 +26,9 @@ async function checkInventory(args, transport) {
             sort,
             includeSoldOut,
         }, {
-            timeout: timeoutMs,
             apiKey: zyteApiKey,
             ...transport,
+            timeout: timeoutMs,
         }),
     ]);
     const enrichedInventory = await enrichOliveyoungProductsWithNearbyStoreInventory(productResult.products, {
@@ -37,9 +37,9 @@ async function checkInventory(args, transport) {
         storeKeyword,
         maxProducts: Math.min(productResult.products.length, Math.max(0, stockCheckLimit)),
     }, {
-        timeout: timeoutMs,
         apiKey: zyteApiKey,
         ...transport,
+        timeout: timeoutMs,
     });
     const inStockProducts = enrichedInventory.products.filter((product) => product.inStock);
     const result = {
@@ -98,7 +98,7 @@ export function createCheckInventoryTool(apiKey, transport = {}) {
                     .optional()
                     .default(5)
                     .describe('주변 매장별 재고를 보강할 상품 수 (기본값: 5, 최대: 5, 낮출수록 빠름)'),
-                timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
+                timeoutMs: z.number().optional().default(transport.timeout ?? (transport.relayUrl ? 60000 : 15000)).describe('개별 조회 제한 시간(ms, 기본값: 무료 릴레이 60000 / 직접 15000)'),
             },
         },
         handler: ((args) => checkInventory({ ...args, zyteApiKey: apiKey }, transport)),

package/dist/services/oliveyoung/tools/findNearbyStores.js

@@ -4,16 +4,16 @@
 import * as z from 'zod';
 import { fetchOliveyoungStores } from '../client.js';
 async function findNearbyStores(args, transport) {
-    const { latitude = 37.5665, longitude = 126.978, keyword = '', pageIdx = 1, limit = 20, timeoutMs = 15000, zyteApiKey, } = args;
+    const { latitude = 37.5665, longitude = 126.978, keyword = '', pageIdx = 1, limit = 20, timeoutMs = transport.timeout ?? (transport.relayUrl ? 60000 : 15000), zyteApiKey, } = args;
     const { totalCount, stores } = await fetchOliveyoungStores({
         latitude,
         longitude,
         pageIdx,
         searchWords: keyword,
     }, {
-        timeout: timeoutMs,
         apiKey: zyteApiKey,
         ...transport,
+        timeout: timeoutMs,
     });
     const limitedStores = stores.slice(0, limit);
     const result = {
@@ -46,7 +46,7 @@ export function createFindNearbyStoresTool(apiKey, transport = {}) {
                     .describe('매장 검색어 (예: 강남, 명동, 신촌). 비우면 주변 매장 전체 조회'),
                 pageIdx: z.number().optional().default(1).describe('매장 결과 페이지 번호 (기본값: 1)'),
                 limit: z.number().optional().default(20).describe('반환할 최대 매장 수 (기본값: 20)'),
-                timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
+                timeoutMs: z.number().optional().default(transport.timeout ?? (transport.relayUrl ? 60000 : 15000)).describe('개별 조회 제한 시간(ms, 기본값: 무료 릴레이 60000 / 직접 15000)'),
             },
         },
         handler: ((args) => findNearbyStores({ ...args, zyteApiKey: apiKey }, transport)),

package/dist/services/oliveyoung/tools/searchProducts.js

@@ -4,7 +4,7 @@
 import * as z from 'zod';
 import { fetchOliveyoungProducts } from '../client.js';
 async function searchProducts(args, transport) {
-    const { keyword, page = 1, size = 20, sort = '01', includeSoldOut = false, timeoutMs = 15000, zyteApiKey, } = args;
+    const { keyword, page = 1, size = 20, sort = '01', includeSoldOut = false, timeoutMs = transport.timeout ?? (transport.relayUrl ? 60000 : 15000), zyteApiKey, } = args;
     if (!keyword || keyword.trim().length === 0) {
         throw new Error('상품 검색어(keyword)를 입력해주세요.');
     }
@@ -15,9 +15,9 @@ async function searchProducts(args, transport) {
         sort,
         includeSoldOut,
     }, {
-        timeout: timeoutMs,
         apiKey: zyteApiKey,
         ...transport,
+        timeout: timeoutMs,
     });
     return {
         content: [
@@ -50,7 +50,7 @@ export function createSearchProductsTool(apiKey, transport = {}) {
                 size: z.number().optional().default(20).describe('페이지당 상품 수 (기본값: 20)'),
                 sort: z.string().optional().default('01').describe('정렬 코드 (기본값: 01)'),
                 includeSoldOut: z.boolean().optional().default(false).describe('품절 상품 포함 여부 (기본값: false)'),
-                timeoutMs: z.number().optional().default(15000).describe('요청 제한 시간(ms, 기본값: 15000)'),
+                timeoutMs: z.number().optional().default(transport.timeout ?? (transport.relayUrl ? 60000 : 15000)).describe('개별 조회 제한 시간(ms, 기본값: 무료 릴레이 60000 / 직접 15000)'),
             },
         },
         handler: ((args) => searchProducts({ ...args, zyteApiKey: apiKey }, transport)),

package/dist/services/oliveyoung/transport.js

@@ -24,7 +24,8 @@ export function isValidOliveyoungRelayUrl(value) {
             !(relay.protocol === 'http:' && ['127.0.0.1', 'localhost'].includes(relay.hostname))));
 }
 export async function requestOliveyoung(path, body, options = {}) {
-    const { timeout = 15000, relayUrl, relayToken } = options;
+    const { relayUrl, relayToken, timeout = relayUrl ? 60000 : 15000 } = options;
+    const deadline = Date.now() + timeout;
     const headers = {
         'Content-Type': 'application/json',
         Accept: 'application/json',
@@ -64,40 +65,55 @@ export async function requestOliveyoung(path, body, options = {}) {
     }
     if (relayUrl) {
         scope = await relayCredentialScope([relayUrl.replace(/\/$/, ''), relayToken, options.accessClientId, options.accessClientSecret]);
-        const quota = cooldown.get(scope, consumer);
-        if (quota)
-            throw toOliveyoungRelayError(new HttpError(429, '', '', new Headers({
-                'x-relay-quota-reason': quota.quotaReason, 'retry-after': String(quota.retryAfter),
-            })));
     }
-    let result;
-    try {
-        result = await fetchJson(url, {
-            method: 'POST',
-            // Workers는 error 모드를 지원하지 않으므로 따라가지 않고 아래 200 검사로 거절합니다.
-            redirect: 'manual',
-            headers,
-            body: JSON.stringify(body),
-            timeout,
-            retries: 0,
-            expectedStatus: 200,
-        });
-    }
-    catch (error) {
-        if (relayUrl) {
-            if (error instanceof HttpError && error.quota)
-                cooldown.set(scope, consumer, error.quota);
-            throw toOliveyoungRelayError(error);
+    let retried = false;
+    while (true) {
+        let result;
+        const cachedQuota = relayUrl ? cooldown.get(scope, consumer) : undefined;
+        try {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                throw new DOMException('Request deadline exceeded', 'AbortError');
+            if (cachedQuota)
+                throw new HttpError(429, '', '', new Headers({
+                    'x-relay-quota-reason': cachedQuota.quotaReason,
+                    'retry-after': String(cachedQuota.retryAfter),
+                }));
+            result = await fetchJson(url, {
+                method: 'POST',
+                // Workers는 error 모드를 지원하지 않으므로 따라가지 않고 아래 200 검사로 거절합니다.
+                redirect: 'manual',
+                headers,
+                body: JSON.stringify(body),
+                timeout: remaining,
+                retries: 0,
+                expectedStatus: 200,
+            });
+        }
+        catch (error) {
+            if (relayUrl) {
+                if (error instanceof HttpError && error.quota) {
+                    if (!cachedQuota)
+                        cooldown.set(scope, consumer, error.quota);
+                    if (!retried && error.quota.quotaReason === 'consumer-busy' &&
+                        deadline - Date.now() > 1000) {
+                        retried = true;
+                        await new Promise(resolve => setTimeout(resolve, 1000));
+                        continue;
+                    }
+                }
+                throw toOliveyoungRelayError(error);
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error('올리브영 API 요청 시간 초과');
+            }
+            throw new Error('올리브영 직접 요청 실패. 운영자는 OY_RELAY_URL과 OY_RELAY_TOKEN으로 브라우저 릴레이를 설정해주세요.', { cause: error });
         }
-        if (error instanceof Error && error.name === 'AbortError') {
-            throw new Error('올리브영 API 요청 시간 초과');
+        if (result?.status !== 'SUCCESS') {
+            if (relayUrl)
+                throw toOliveyoungRelayError(new SyntaxError());
+            throw new Error(`올리브영 API 상태 오류: ${result?.status || 'UNKNOWN'}`);
         }
-        throw new Error('올리브영 직접 요청 실패. 운영자는 OY_RELAY_URL과 OY_RELAY_TOKEN으로 브라우저 릴레이를 설정해주세요.', { cause: error });
-    }
-    if (result?.status !== 'SUCCESS') {
-        if (relayUrl)
-            throw toOliveyoungRelayError(new SyntaxError());
-        throw new Error(`올리브영 API 상태 오류: ${result?.status || 'UNKNOWN'}`);
+        return result;
     }
-    return result;
 }

package/dist/services/opinet/client.js

@@ -180,7 +180,7 @@ export async function fetchOpinetLowestStations(params, options = {}) {
 }
 export async function fetchOpinetStationsAround(params, options = {}) {
     const resolvedLocation = await resolveOpinetLocation(params, {
-        googleMapsApiKey: options.googleMapsApiKey,
+        ...options,
         timeoutMs: options.timeoutMs,
         fetchImpl: options.fetchImpl,
     });

package/dist/services/opinet/index.js

@@ -15,7 +15,7 @@ class OpinetService {
         return [
             createOpinetAveragePricesTool(this.options.apiKey),
             createOpinetLowestStationsTool(this.options.apiKey),
-            createOpinetStationsAroundTool(this.options.apiKey, this.options.googleMapsApiKey),
+            createOpinetStationsAroundTool(this.options.apiKey, this.options.googleMapsApiKey, this.options),
             createOpinetStationDetailTool(this.options.apiKey),
         ];
     }

package/dist/services/opinet/location.js

@@ -1,14 +1,9 @@
+import { geocodeLocation as resolveFreeLocation, validKoreanCoordinates, } from '../../utils/geocode.js';
 import proj4 from 'proj4';
 const WGS84 = 'EPSG:4326';
 const KATEC = 'KATEC';
 const KATEC_PROJ4 = '+proj=tmerc +lat_0=38 +lon_0=128 +k=0.9999 +x_0=400000 +y_0=600000 +ellps=bessel +units=m +no_defs +towgs84=-115.80,474.99,674.11,1.16,-2.31,-1.63,6.43';
 proj4.defs(KATEC, KATEC_PROJ4);
-const GEOCODE_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
-const geocodeCache = new Map();
-function getProcessEnvValue(name) {
-    /* c8 ignore next -- Worker 런타임은 bindings로 키를 주입합니다. */
-    return typeof process !== 'undefined' ? process.env[name] : undefined;
-}
 function isFiniteNumber(value) {
     return typeof value === 'number' && Number.isFinite(value);
 }
@@ -23,55 +18,7 @@ export function wgs84ToKatec(latitude, longitude) {
     };
 }
 async function geocodeLocation(location, options) {
-    const keyword = location.trim();
-    const cached = geocodeCache.get(keyword);
-    if (cached && cached.expiresAt > Date.now()) {
-        return cached.value;
-    }
-    const apiKey = options.googleMapsApiKey?.trim() || getProcessEnvValue('GOOGLE_MAPS_API_KEY')?.trim();
-    if (!apiKey) {
-        throw new Error('location 검색에는 GOOGLE_MAPS_API_KEY가 필요합니다.');
-    }
-    const endpoint = new URL('https://maps.googleapis.com/maps/api/geocode/json');
-    endpoint.searchParams.set('address', keyword);
-    endpoint.searchParams.set('key', apiKey);
-    const response = await (options.fetchImpl ?? fetch)(endpoint.toString(), {
-        headers: { Accept: 'application/json' },
-        signal: AbortSignal.timeout(options.timeoutMs ?? 10000),
-    });
-    const bodyText = await response.text();
-    let parsed;
-    try {
-        parsed = JSON.parse(bodyText);
-    }
-    catch {
-        parsed = { status: 'INVALID_JSON' };
-    }
-    if (!response.ok) {
-        throw new Error(`Google Geocoding 호출 실패: HTTP ${response.status} ${bodyText}`);
-    }
-    if (parsed.status !== 'OK') {
-        geocodeCache.set(keyword, {
-            expiresAt: Date.now() + GEOCODE_CACHE_TTL_MS,
-            value: null,
-        });
-        return null;
-    }
-    const first = parsed.results?.[0];
-    const latitude = first?.geometry?.location?.lat;
-    const longitude = first?.geometry?.location?.lng;
-    const value = isFiniteNumber(latitude) && isFiniteNumber(longitude)
-        ? {
-            latitude,
-            longitude,
-            formattedAddress: first?.formatted_address ?? null,
-        }
-        : null;
-    geocodeCache.set(keyword, {
-        expiresAt: Date.now() + GEOCODE_CACHE_TTL_MS,
-        value,
-    });
-    return value;
+    return resolveFreeLocation(location, options);
 }
 export async function resolveOpinetLocation(input, options = {}) {
     if (isFiniteNumber(input.x) && isFiniteNumber(input.y)) {
@@ -86,6 +33,8 @@ export async function resolveOpinetLocation(input, options = {}) {
         };
     }
     if (isFiniteNumber(input.latitude) && isFiniteNumber(input.longitude)) {
+        if (!validKoreanCoordinates(input.latitude, input.longitude))
+            throw new Error('유효한 위도/경도를 입력해주세요.');
         return {
             katec: wgs84ToKatec(input.latitude, input.longitude),
             latitude: input.latitude,
@@ -115,5 +64,5 @@ export async function resolveOpinetLocation(input, options = {}) {
     throw new Error('KATEC x/y, 위도/경도(latitude/longitude), 또는 location 중 하나를 입력해주세요.');
 }
 export function __testOnlyClearOpinetGeocodeCache() {
-    geocodeCache.clear();
+    // 캐시를 유지하지 않으므로 초기화할 상태가 없습니다.
 }

package/dist/services/opinet/tools.js

@@ -39,7 +39,7 @@ export function createOpinetLowestStationsTool(apiKey) {
         handler: (async (args) => buildTextResponse(await fetchOpinetLowestStations(args, { apiKey, timeoutMs: args.timeoutMs }))),
     };
 }
-export function createOpinetStationsAroundTool(apiKey, googleMapsApiKey) {
+export function createOpinetStationsAroundTool(apiKey, googleMapsApiKey, geocodeOptions = {}) {
     return {
         name: 'opinet_search_stations_around',
         metadata: {
@@ -61,7 +61,7 @@ export function createOpinetStationsAroundTool(apiKey, googleMapsApiKey) {
                 timeoutMs: z.number().optional().default(10000).describe('요청 제한 시간(ms)'),
             },
         },
-        handler: (async (args) => buildTextResponse(await fetchOpinetStationsAround(args, { apiKey, googleMapsApiKey, timeoutMs: args.timeoutMs }))),
+        handler: (async (args) => buildTextResponse(await fetchOpinetStationsAround(args, { ...geocodeOptions, apiKey, googleMapsApiKey, timeoutMs: args.timeoutMs }))),
     };
 }
 export function createOpinetStationDetailTool(apiKey) {