daiso 1.0.8 → 1.0.9

package/dist/services/opinet/location.js

@@ -0,0 +1,119 @@
+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);
+}
+export function wgs84ToKatec(latitude, longitude) {
+    if (!isFiniteNumber(latitude) || !isFiniteNumber(longitude)) {
+        throw new Error('유효한 위도/경도를 입력해주세요.');
+    }
+    const [x, y] = proj4(WGS84, KATEC, [longitude, latitude]);
+    return {
+        x: Number(x.toFixed(3)),
+        y: Number(y.toFixed(3)),
+    };
+}
+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;
+}
+export async function resolveOpinetLocation(input, options = {}) {
+    if (isFiniteNumber(input.x) && isFiniteNumber(input.y)) {
+        return {
+            katec: { x: input.x, y: input.y },
+            latitude: null,
+            longitude: null,
+            location: input.location?.trim() || null,
+            formattedAddress: null,
+            geocodeUsed: false,
+            inputType: 'katec',
+        };
+    }
+    if (isFiniteNumber(input.latitude) && isFiniteNumber(input.longitude)) {
+        return {
+            katec: wgs84ToKatec(input.latitude, input.longitude),
+            latitude: input.latitude,
+            longitude: input.longitude,
+            location: input.location?.trim() || null,
+            formattedAddress: null,
+            geocodeUsed: false,
+            inputType: 'coordinates',
+        };
+    }
+    const location = input.location?.trim() || '';
+    if (location.length > 0) {
+        const geocoded = await geocodeLocation(location, options);
+        if (!geocoded) {
+            throw new Error(`위치를 좌표로 변환하지 못했습니다: ${location}`);
+        }
+        return {
+            katec: wgs84ToKatec(geocoded.latitude, geocoded.longitude),
+            latitude: geocoded.latitude,
+            longitude: geocoded.longitude,
+            location,
+            formattedAddress: geocoded.formattedAddress,
+            geocodeUsed: true,
+            inputType: 'location',
+        };
+    }
+    throw new Error('KATEC x/y, 위도/경도(latitude/longitude), 또는 location 중 하나를 입력해주세요.');
+}
+export function __testOnlyClearOpinetGeocodeCache() {
+    geocodeCache.clear();
+}

package/dist/services/opinet/tools.js

@@ -0,0 +1,80 @@
+import * as z from 'zod';
+import { fetchOpinetAveragePrices, fetchOpinetLowestStations, fetchOpinetStationDetail, fetchOpinetStationsAround, } from './client.js';
+function buildTextResponse(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
+    };
+}
+export function createOpinetAveragePricesTool(apiKey) {
+    return {
+        name: 'opinet_get_average_prices',
+        metadata: {
+            title: '오피넷 전국 평균 유가',
+            description: '한국석유공사 오피넷의 전국 평균 유가를 조회합니다.',
+            inputSchema: {
+                timeoutMs: z.number().optional().default(10000).describe('요청 제한 시간(ms)'),
+            },
+        },
+        handler: (async (args) => buildTextResponse(await fetchOpinetAveragePrices({ apiKey, timeoutMs: args.timeoutMs }))),
+    };
+}
+export function createOpinetLowestStationsTool(apiKey) {
+    return {
+        name: 'opinet_get_lowest_price_stations',
+        metadata: {
+            title: '오피넷 최저가 주유소',
+            description: '전국 또는 지역별 최저가 주유소를 유종별로 조회합니다.',
+            inputSchema: {
+                fuelCode: z
+                    .enum(['B027', 'D047', 'B034', 'C004', 'K015'])
+                    .optional()
+                    .default('B027')
+                    .describe('유종 코드: B027 휘발유, D047 경유, B034 고급휘발유, C004 실내등유, K015 자동차부탄'),
+                areaCode: z.string().optional().describe('오피넷 지역 코드. 미입력 시 전국 기준'),
+                count: z.number().optional().default(10).describe('최저가 결과 수(1~20)'),
+                timeoutMs: z.number().optional().default(10000).describe('요청 제한 시간(ms)'),
+            },
+        },
+        handler: (async (args) => buildTextResponse(await fetchOpinetLowestStations(args, { apiKey, timeoutMs: args.timeoutMs }))),
+    };
+}
+export function createOpinetStationsAroundTool(apiKey, googleMapsApiKey) {
+    return {
+        name: 'opinet_search_stations_around',
+        metadata: {
+            title: '오피넷 반경 내 주유소',
+            description: 'KATEC x/y, 위도/경도, 또는 장소 키워드 기준 반경 내 주유소를 가격순 또는 거리순으로 조회합니다.',
+            inputSchema: {
+                x: z.number().optional().describe('기준 위치 X좌표(KATEC)'),
+                y: z.number().optional().describe('기준 위치 Y좌표(KATEC)'),
+                latitude: z.number().optional().describe('위도(WGS84)'),
+                longitude: z.number().optional().describe('경도(WGS84)'),
+                location: z.string().optional().describe('장소/주소 키워드. 예: 강남역, 서울역'),
+                radiusMeters: z.number().optional().default(3000).describe('검색 반경 m(100~5000)'),
+                fuelCode: z
+                    .enum(['B027', 'D047', 'B034', 'C004', 'K015'])
+                    .optional()
+                    .default('B027')
+                    .describe('유종 코드'),
+                sort: z.enum(['price', 'distance']).optional().default('price').describe('정렬 기준'),
+                timeoutMs: z.number().optional().default(10000).describe('요청 제한 시간(ms)'),
+            },
+        },
+        handler: (async (args) => buildTextResponse(await fetchOpinetStationsAround(args, { apiKey, googleMapsApiKey, timeoutMs: args.timeoutMs }))),
+    };
+}
+export function createOpinetStationDetailTool(apiKey) {
+    return {
+        name: 'opinet_get_station_detail',
+        metadata: {
+            title: '오피넷 주유소 상세정보',
+            description: '오피넷 주유소 ID로 상세 정보, 부가시설, 유종별 가격을 조회합니다.',
+            inputSchema: {
+                stationId: z.string().describe('오피넷 주유소 ID'),
+                timeoutMs: z.number().optional().default(10000).describe('요청 제한 시간(ms)'),
+            },
+        },
+        handler: (async (args) => buildTextResponse(await fetchOpinetStationDetail(args.stationId, { apiKey, timeoutMs: args.timeoutMs }))),
+    };
+}

package/dist/services/opinet/types.js

@@ -0,0 +1 @@
+export {};

package/openapi.json

@@ -55,6 +55,7 @@
                 "sevenelevenGetCatalog",
                 "compareProducts",
                 "placesSearchNearby",
+                "submitDeveloperRequest",
                 "megaboxFindTheaters",
                 "megaboxListMovies",
                 "megaboxGetSeats",
@@ -139,6 +140,87 @@
               "type": "string"
             }
           },
+          {
+            "name": "type",
+            "in": "query",
+            "required": false,
+            "description": "개발자 요청 유형(bug, improvement, feature, docs, other)",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "severity",
+            "in": "query",
+            "required": false,
+            "description": "개발자 요청 영향도(low, medium, high, critical)",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "title",
+            "in": "query",
+            "required": false,
+            "description": "개발자 요청 제목",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "description",
+            "in": "query",
+            "required": false,
+            "description": "개발자 요청 상세 설명",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "toolName",
+            "in": "query",
+            "required": false,
+            "description": "문제가 발생했거나 개선이 필요한 MCP 도구 이름",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "reproduction",
+            "in": "query",
+            "required": false,
+            "description": "오류 재현 방법",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "expected",
+            "in": "query",
+            "required": false,
+            "description": "기대 결과",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "actual",
+            "in": "query",
+            "required": false,
+            "description": "실제 결과",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "source",
+            "in": "query",
+            "required": false,
+            "description": "요청 출처(mcp, chatgpt, claude, cli, api, other)",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "sido",
             "in": "query",

package/openapi.yaml

@@ -56,6 +56,7 @@ paths:
               - sevenelevenGetCatalog
               - compareProducts
               - placesSearchNearby
+              - submitDeveloperRequest
               - megaboxFindTheaters
               - megaboxListMovies
               - megaboxGetSeats
@@ -113,6 +114,60 @@ paths:
           description: 통합 비교 서비스 목록(daiso,gs25,seveneleven,emart24)
           schema:
             type: string
+        - name: type
+          in: query
+          required: false
+          description: 개발자 요청 유형(bug, improvement, feature, docs, other)
+          schema:
+            type: string
+        - name: severity
+          in: query
+          required: false
+          description: 개발자 요청 영향도(low, medium, high, critical)
+          schema:
+            type: string
+        - name: title
+          in: query
+          required: false
+          description: 개발자 요청 제목
+          schema:
+            type: string
+        - name: description
+          in: query
+          required: false
+          description: 개발자 요청 상세 설명
+          schema:
+            type: string
+        - name: toolName
+          in: query
+          required: false
+          description: 문제가 발생했거나 개선이 필요한 MCP 도구 이름
+          schema:
+            type: string
+        - name: reproduction
+          in: query
+          required: false
+          description: 오류 재현 방법
+          schema:
+            type: string
+        - name: expected
+          in: query
+          required: false
+          description: 기대 결과
+          schema:
+            type: string
+        - name: actual
+          in: query
+          required: false
+          description: 실제 결과
+          schema:
+            type: string
+        - name: source
+          in: query
+          required: false
+          description: 요청 출처(mcp, chatgpt, claude, cli, api, other)
+          schema:
+            type: string
         - name: sido
           in: query
           required: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daiso",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Korean retail and cinema MCP server, CLI, and Codex Skill for Daiso, convenience stores, marts, Olive Young, and theaters",
   "main": "dist/index.js",
   "bin": {
@@ -39,7 +39,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "check": "npm run format:check && npm run lint && npm run typecheck && npm test"
+    "check": "npm run format:check && npm run lint && npm run lint:biome && npm run typecheck && npm test",
+    "lint:biome": "biome lint"
   },
   "keywords": [
     "mcp",
@@ -78,24 +79,23 @@
     "node": ">=20"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260316.1",
+    "@biomejs/biome": "^2.4.15",
+    "@cloudflare/workers-types": "^4.20260526.1",
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "^4.1.0",
-    "chart.js": "^4.5.1",
-    "chartjs-node-canvas": "^5.0.0",
-    "chartjs-plugin-datalabels": "^2.2.0",
-    "eslint": "^10.0.2",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
+    "eslint": "^10.4.0",
     "eslint-config-prettier": "^10.1.8",
     "globals": "^17.4.0",
-    "jiti": "^2.6.1",
-    "playwright": "^1.58.2",
-    "prettier": "^3.8.1",
-    "tsx": "^4.20.6",
+    "jiti": "^2.7.0",
+    "playwright": "^1.60.0",
+    "prettier": "^3.8.3",
+    "sharp": "^0.34.5",
+    "tsx": "^4.22.3",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.3",
-    "vitest": "^4.1.0",
-    "wrangler": "^4.73.0"
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^4.1.7",
+    "wrangler": "^4.95.0"
   },
   "overrides": {
     "flatted": "3.4.2",
@@ -105,7 +105,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "hono": "^4.12.8",
+    "hono": "^4.12.23",
+    "proj4": "^2.20.8",
     "workers-mcp": "^0.0.13"
   }
 }