krx-cli 1.6.0 → 1.7.1

package/dist/mcp.js

@@ -31157,12 +31157,51 @@ function applyPipeline(data, options) {
   if (options.sort) {
     result = sortData(result, options.sort, options.direction ?? "desc");
   }
+  if (options.offset !== void 0 && options.offset > 0) {
+    result = result.slice(options.offset);
+  }
   if (options.limit && options.limit > 0) {
     result = limitData(result, options.limit);
   }
   return result;
 }
 
+// src/mcp/tools/result.ts
+var MAX_RESULT_BYTES = 5e5;
+function successResult(data) {
+  const text = JSON.stringify(data, null, 2);
+  if (Buffer.byteLength(text, "utf-8") <= MAX_RESULT_BYTES) {
+    return { content: [{ type: "text", text }] };
+  }
+  let lo = 0;
+  let hi = data.length;
+  while (lo < hi) {
+    const mid = Math.ceil((lo + hi) / 2);
+    const candidate = JSON.stringify(data.slice(0, mid), null, 2);
+    if (Buffer.byteLength(candidate, "utf-8") <= MAX_RESULT_BYTES - 2e3) {
+      lo = mid;
+    } else {
+      hi = mid - 1;
+    }
+  }
+  const truncated = data.slice(0, lo);
+  const result = {
+    data: truncated,
+    _truncated: {
+      total: data.length,
+      returned: lo,
+      message: `Result truncated: ${lo} of ${data.length} rows returned. To get remaining rows, use offset=${lo} with limit=${lo}. Or use 'fields' to reduce row size.`
+    }
+  };
+  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+}
+function errorResult(message) {
+  return {
+    content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+    isError: true
+  };
+}
+
 // src/mcp/tools/index.ts
 function getEndpointShortName(path5) {
   return path5.split("/").pop() ?? path5;
@@ -31182,7 +31221,9 @@ Notes:
 - Date format: YYYYMMDD (e.g., 20260310)
 - Data is T-1 (previous trading day)
 - All response values are strings
-- Rate limit: 10,000 calls/day`;
+- Rate limit: 10,000 calls/day
+- IMPORTANT: When querying a specific stock, ALWAYS pass 'isuCd' to filter. Without it, all stocks in the market are returned.
+- Full market listings can exceed the result size limit. Use 'fields' to select only needed columns, or 'limit'+'offset' for pagination. If the response contains '_truncated', follow its instructions to retrieve remaining data.`;
 }
 function buildInputSchema(endpoints) {
   const shortNames = endpoints.map((e) => getEndpointShortName(e.path));
@@ -31200,6 +31241,7 @@ function buildInputSchema(endpoints) {
     isuCd: external_exports.string().optional().describe("Stock/item code (ISU_CD) to filter a specific item"),
     sort: external_exports.string().optional().describe("Sort results by this field name"),
     sort_direction: external_exports.enum(["asc", "desc"]).optional().describe("Sort direction (default: desc)"),
+    offset: external_exports.number().optional().describe("Skip first N results (use with limit for pagination)"),
     limit: external_exports.number().optional().describe("Limit number of results returned"),
     filter: external_exports.string().optional().describe(
       'Filter expression (e.g. "FLUC_RT > 5", "MKT_NM == KOSPI"). Operators: >, <, >=, <=, ==, !='
@@ -31222,14 +31264,6 @@ function filterFields(data, fields) {
     return filtered;
   });
 }
-function errorResult(message) {
-  return {
-    content: [
-      { type: "text", text: JSON.stringify({ error: message }) }
-    ],
-    isError: true
-  };
-}
 function createCategoryTool(categoryId) {
   const endpoints = ENDPOINTS.filter((e) => e.category === categoryId);
   return {
@@ -31286,22 +31320,20 @@ function createCategoryTool(categoryId) {
         const filterExpr = args.filter;
         const sortField2 = args.sort;
         const sortDirection2 = args.sort_direction ?? "desc";
+        const offsetN2 = args.offset;
         const limitN2 = args.limit;
         data2 = applyPipeline(data2, {
           filter: filterExpr,
           sort: sortField2,
           direction: sortDirection2,
+          offset: offsetN2,
           limit: limitN2
         });
         const fields2 = args.fields;
         if (fields2) {
           data2 = filterFields(data2, fields2);
         }
-        return {
-          content: [
-            { type: "text", text: JSON.stringify(data2, null, 2) }
-          ]
-        };
+        return successResult(data2);
       }
       const dateStr = args.date ?? getRecentTradingDate();
       try {
@@ -31326,23 +31358,21 @@ function createCategoryTool(categoryId) {
       const filterExpr2 = args.filter;
       const sortField = args.sort;
       const sortDirection = args.sort_direction ?? "desc";
+      const offsetN = args.offset;
       const limitN = args.limit;
       let data = result.data;
       data = applyPipeline(data, {
         filter: filterExpr2,
         sort: sortField,
         direction: sortDirection,
+        offset: offsetN,
         limit: limitN
       });
       const fields = args.fields;
       if (fields) {
         data = filterFields(data, fields);
       }
-      return {
-        content: [
-          { type: "text", text: JSON.stringify(data, null, 2) }
-        ]
-      };
+      return successResult(data);
     }
   };
 }