@datadive-tools/mcp 0.13.0 → 0.14.0

package/dist/lib.js

@@ -139,7 +139,7 @@ function extractMessage(body) {
 }
 
 // package.json
-var version = "0.13.0";
+var version = "0.14.0";
 
 // src/http/client.ts
 var PKG_VERSION = version;
@@ -457,22 +457,33 @@ var listRankRadarsTool = {
 // src/tools/get-rank-radar-data.ts
 import { z as z7 } from "zod";
 var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+var RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE = 100;
+var RANK_RADAR_MAX_DATE_RANGE_DAYS = 90;
 var inputSchema7 = {
   rankRadarId: z7.string().uuid().describe("The Rank Radar UUID (from `list_rank_radars`)."),
   startDate: z7.string().regex(ISO_DATE, "startDate must be in yyyy-mm-dd format").describe("Start date for the ranking data range, yyyy-mm-dd (e.g. 2024-03-26)."),
-  endDate: z7.string().regex(ISO_DATE, "endDate must be in yyyy-mm-dd format").describe("End date for the ranking data range, yyyy-mm-dd (e.g. 2024-04-26). Must be on or after startDate.")
+  endDate: z7.string().regex(ISO_DATE, "endDate must be in yyyy-mm-dd format").describe(
+    `End date for the ranking data range, yyyy-mm-dd (e.g. 2024-04-26). Must be on or after startDate, and at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days after it.`
+  ),
+  currentPage: z7.number().int().min(1).optional().describe("Page of keywords, 1-indexed. Defaults to 1."),
+  pageSize: z7.number().int().min(1).max(RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE).optional().describe(`Keywords per page (max ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE}). Defaults to 20.`)
 };
 var getRankRadarDataTool = {
   name: "get_rank_radar_data",
   title: "Get Keyword Rankings for a Rank Radar",
-  description: "Use this to analyze keyword ranking trends over time. Requires startDate and endDate (yyyy-mm-dd). Retrieves historical keyword ranking data for the specified Rank Radar within the date range. Returns an array of tracked keywords; each has id, keyword, searchVolume, ranks (per-day { date, organicRank, impressionRank }), and any highlight annotations. Use after `list_rank_radars` to discover a `rankRadarId`.",
+  description: `Use this to analyze keyword ranking trends over time. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart. Retrieves historical keyword ranking data for the specified Rank Radar within the date range. Results are paged by keyword: \`data\` holds one page of tracked keywords, and the response carries currentPage, pageSize, total, lastPage, hasNext and hasPrev. \`total\` is the Rank Radar's keyword count; to read every keyword, call again with \`currentPage\` + 1 while \`hasNext\` is true, using \`pageSize\` ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE} for large Rank Radars. Each keyword has id, keyword, searchVolume, relevancy, ranks (per-day { date, organicRank, sponsoredRank, impressionRank }), and any highlight annotations. Paused keywords are not included. Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
   inputSchema: inputSchema7,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
       { config: ctx.config, toolName: "get_rank_radar_data" },
       `/v1/niches/rank-radars/${encodeURIComponent(args.rankRadarId)}`,
-      { startDate: args.startDate, endDate: args.endDate }
+      {
+        startDate: args.startDate,
+        endDate: args.endDate,
+        currentPage: args.currentPage,
+        pageSize: args.pageSize
+      }
     );
   }
 };