@squadbase/vite-server 0.1.17-dev.24af54e → 0.1.17-dev.423ee34

package/dist/connectors/semrush.js

@@ -16,6 +16,7 @@ var init_parameter_definition = __esm({
       type;
       secret;
       required;
+      isDeprecated;
       constructor(config) {
         this.slug = config.slug;
         this.name = config.name;
@@ -24,6 +25,7 @@ var init_parameter_definition = __esm({
         this.type = config.type;
         this.secret = config.secret;
         this.required = config.required;
+        this.isDeprecated = config.isDeprecated ?? false;
       }
       /**
        * Get the parameter value from a ConnectorConnectionObject.
@@ -295,7 +297,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
   /**
    * Create tools for connections that belong to this connector.
    * Filters connections by connectorKey internally.
-   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   * Returns tools keyed as `connector_${connectorKey}_${toolName}`.
    */
   createTools(connections, config, opts) {
     const myConnections = connections.filter(
@@ -305,7 +307,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
     for (const t of Object.values(this.tools)) {
       const tool = t.createTool(myConnections, config);
       const originalToModelOutput = tool.toModelOutput;
-      result[`${this.connectorKey}_${t.name}`] = {
+      result[`connector_${this.connectorKey}_${t.name}`] = {
         ...tool,
         toModelOutput: async (options) => {
           if (!originalToModelOutput) {
@@ -361,19 +363,34 @@ async function runSetupFlow(flow, params, ctx, config) {
   };
   let state = flow.initialState();
   let answerIdx = 0;
+  const pendingParameterUpdates = [];
   for (const step of flow.steps) {
     const ans = ctx.answers[answerIdx];
     if (ans && ans.questionSlug === step.slug) {
       state = step.applyAnswer(state, ans.answer);
+      if (step.toParameterUpdates) {
+        pendingParameterUpdates.push(...step.toParameterUpdates(state));
+      }
       answerIdx += 1;
       continue;
     }
+    const resolvedAllowFreeText = step.allowFreeText !== void 0 ? step.allowFreeText : true;
     if (step.type === "text") {
+      if (step.fetchOptions) {
+        const options2 = await step.fetchOptions(state, runtime);
+        if (options2.length === 0) {
+          continue;
+        }
+      }
       return {
         type: "nextQuestion",
         questionSlug: step.slug,
         question: step.question[ctx.language],
-        questionType: "text"
+        questionType: "text",
+        allowFreeText: resolvedAllowFreeText,
+        ...pendingParameterUpdates.length > 0 && {
+          parameterUpdates: pendingParameterUpdates
+        }
       };
     }
     const options = step.fetchOptions ? await step.fetchOptions(state, runtime) : [];
@@ -385,11 +402,21 @@ async function runSetupFlow(flow, params, ctx, config) {
       questionSlug: step.slug,
       question: step.question[ctx.language],
       questionType: step.type,
-      options
+      options,
+      allowFreeText: resolvedAllowFreeText,
+      ...pendingParameterUpdates.length > 0 && {
+        parameterUpdates: pendingParameterUpdates
+      }
     };
   }
   const dataInvestigationResult = await flow.finalize(state, runtime);
-  return { type: "fulfilled", dataInvestigationResult };
+  return {
+    type: "fulfilled",
+    dataInvestigationResult,
+    ...pendingParameterUpdates.length > 0 && {
+      parameterUpdates: pendingParameterUpdates
+    }
+  };
 }
 async function resolveSetupSelection(params) {
   const { selected, allSentinel, fetchAll, limit } = params;
@@ -593,7 +620,8 @@ var semrushOnboarding = new ConnectorOnboarding({
 });
 
 // ../connectors/src/connectors/semrush/utils.ts
-var PROJECTS_BASE_URL = "https://api.semrush.com/management/v1";
+var BASE_URL3 = "https://api.semrush.com";
+var PROJECTS_BASE_URL = `${BASE_URL3}/management/v1`;
 function projectsApiFetch(params, path2, init) {
   const apiKey = params[parameters.apiKey.slug];
   if (!apiKey) {
@@ -610,10 +638,103 @@ function projectsApiFetch(params, path2, init) {
   if (!headers.has("Accept")) headers.set("Accept", "application/json");
   return fetch(url.toString(), { ...init, headers });
 }
+async function reportFetch(params, query) {
+  const apiKey = params[parameters.apiKey.slug];
+  if (!apiKey) {
+    throw new Error(
+      `semrush: missing required parameter: ${parameters.apiKey.slug}`
+    );
+  }
+  const url = new URL(`${BASE_URL3}/`);
+  for (const [k, v] of Object.entries(query)) {
+    url.searchParams.set(k, v);
+  }
+  url.searchParams.set("key", apiKey);
+  const res = await fetch(url.toString());
+  const text = await res.text();
+  if (text.startsWith("ERROR ")) throw new Error(text.trim());
+  return parseSemicolonCsv(text);
+}
+async function backlinksFetch(params, query) {
+  const apiKey = params[parameters.apiKey.slug];
+  if (!apiKey) {
+    throw new Error(
+      `semrush: missing required parameter: ${parameters.apiKey.slug}`
+    );
+  }
+  const url = new URL(`${BASE_URL3}/analytics/v1/`);
+  for (const [k, v] of Object.entries(query)) {
+    url.searchParams.set(k, v);
+  }
+  url.searchParams.set("key", apiKey);
+  const res = await fetch(url.toString());
+  const text = await res.text();
+  if (text.startsWith("ERROR ")) throw new Error(text.trim());
+  return parseSemicolonCsv(text);
+}
+function parseSemicolonCsv(raw) {
+  const lines = raw.trim().split("\n").filter(Boolean);
+  if (lines.length === 0) return { columns: [], rows: [] };
+  const columns = lines[0].split(";");
+  const rows = lines.slice(1).map((line) => {
+    const values = line.split(";");
+    const row = {};
+    for (let i = 0; i < columns.length; i++) {
+      row[columns[i]] = values[i] ?? "";
+    }
+    return row;
+  });
+  return { columns, rows };
+}
 
 // ../connectors/src/connectors/semrush/setup-flow.ts
 var ALL_PROJECTS = "__ALL_PROJECTS__";
 var SEMRUSH_SETUP_MAX_PROJECTS = 10;
+var SEMRUSH_DATABASES = [
+  { value: "us", label: "United States" },
+  { value: "uk", label: "United Kingdom" },
+  { value: "ca", label: "Canada" },
+  { value: "au", label: "Australia" },
+  { value: "de", label: "Germany" },
+  { value: "fr", label: "France" },
+  { value: "es", label: "Spain" },
+  { value: "it", label: "Italy" },
+  { value: "br", label: "Brazil" },
+  { value: "jp", label: "Japan" },
+  { value: "in", label: "India" },
+  { value: "ru", label: "Russia" },
+  { value: "nl", label: "Netherlands" },
+  { value: "se", label: "Sweden" },
+  { value: "mx", label: "Mexico" },
+  { value: "kr", label: "South Korea" },
+  { value: "sg", label: "Singapore" },
+  { value: "hk", label: "Hong Kong" },
+  { value: "tw", label: "Taiwan" }
+];
+var REPORT_TYPE_LABELS = {
+  domain_overview: {
+    en: "Domain Overview (rank, traffic, keyword count)",
+    ja: "Domain Overview (\u30E9\u30F3\u30AF\u30FB\u30C8\u30E9\u30D5\u30A3\u30C3\u30AF\u30FB\u30AD\u30FC\u30EF\u30FC\u30C9\u6570)"
+  },
+  organic_search: {
+    en: "Organic Search (top organic keywords)",
+    ja: "Organic Search (\u4E0A\u4F4D\u30AA\u30FC\u30AC\u30CB\u30C3\u30AF\u30AD\u30FC\u30EF\u30FC\u30C9)"
+  },
+  paid_search: {
+    en: "Paid Search (top paid keywords)",
+    ja: "Paid Search (\u4E0A\u4F4D\u6709\u6599\u30AD\u30FC\u30EF\u30FC\u30C9)"
+  },
+  backlinks: {
+    en: "Backlinks (referring domains, backlink count)",
+    ja: "Backlinks (\u53C2\u7167\u30C9\u30E1\u30A4\u30F3\u30FB\u88AB\u30EA\u30F3\u30AF\u6570)"
+  }
+};
+var REPORT_TYPE_VALUES = [
+  "domain_overview",
+  "organic_search",
+  "paid_search",
+  "backlinks"
+];
 function projectId(p) {
   const raw = p.project_id ?? p.id;
   return raw == null ? "" : String(raw);
@@ -622,7 +743,7 @@ function projectName(p) {
   return p.project_name ?? p.name ?? p.domain ?? p.url ?? projectId(p);
 }
 function projectDomain(p) {
-  return p.domain ?? p.url ?? "";
+  return p.domain ?? p.domain_unicode ?? p.url ?? "";
 }
 function projectCreatedAt(p) {
   return p.created_at ?? p.date_created ?? "";
@@ -630,13 +751,19 @@ function projectCreatedAt(p) {
 async function fetchProjects(params) {
   let res;
   try {
-    res = await projectsApiFetch(params, "/projects/");
+    res = await projectsApiFetch(params, "/projects");
   } catch (err) {
-    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    return {
+      ok: false,
+      error: err instanceof Error ? err.message : String(err)
+    };
   }
   if (!res.ok) {
     const body2 = await res.text().catch(() => res.statusText);
-    return { ok: false, error: `HTTP ${res.status} ${body2 || res.statusText}` };
+    return {
+      ok: false,
+      error: `HTTP ${res.status} ${body2 || res.statusText}`
+    };
   }
   let body;
   try {
@@ -650,9 +777,171 @@ async function fetchProjects(params) {
   const projects = Array.isArray(body) ? body : Array.isArray(body?.projects) ? body.projects : Array.isArray(body?.data) ? body.data : [];
   return { ok: true, projects };
 }
+function formatNumber(n) {
+  return n.toLocaleString("en-US");
+}
+async function fetchDomainOverview(params, domain, database) {
+  const sections = [];
+  try {
+    const report = await reportFetch(params, {
+      type: "domain_ranks",
+      domain,
+      database
+    });
+    if (report.rows.length === 0) {
+      sections.push("_No data found for this domain._", "");
+      return sections;
+    }
+    const row = report.rows[0];
+    sections.push("| Metric | Value |");
+    sections.push("|--------|-------|");
+    sections.push(
+      `| Rank | ${row["Rank"] ?? "-"} |`,
+      `| Organic Keywords | ${formatNumber(Number(row["Organic Keywords"]) || 0)} |`,
+      `| Organic Traffic | ${formatNumber(Number(row["Organic Traffic"]) || 0)} |`,
+      `| Organic Cost | $${formatNumber(Number(row["Organic Cost"]) || 0)} |`,
+      `| Adwords Keywords | ${formatNumber(Number(row["Adwords Keywords"]) || 0)} |`,
+      `| Adwords Traffic | ${formatNumber(Number(row["Adwords Traffic"]) || 0)} |`,
+      `| Adwords Cost | $${formatNumber(Number(row["Adwords Cost"]) || 0)} |`
+    );
+    sections.push("");
+  } catch (err) {
+    sections.push(
+      `_Error: ${err instanceof Error ? err.message : String(err)}_`,
+      ""
+    );
+  }
+  return sections;
+}
+async function fetchOrganicSearch(params, domain, database) {
+  return fetchKeywordReport(params, "domain_organic", domain, database);
+}
+async function fetchPaidSearch(params, domain, database) {
+  return fetchKeywordReport(params, "domain_adwords", domain, database);
+}
+async function fetchKeywordReport(params, type, domain, database) {
+  const sections = [];
+  try {
+    const report = await reportFetch(params, {
+      type,
+      domain,
+      database,
+      display_limit: "5"
+    });
+    if (report.rows.length === 0) {
+      sections.push("_No data found._", "");
+      return sections;
+    }
+    sections.push(...renderCsvTable(report, 5));
+    sections.push("");
+  } catch (err) {
+    sections.push(
+      `_Error: ${err instanceof Error ? err.message : String(err)}_`,
+      ""
+    );
+  }
+  return sections;
+}
+async function fetchBacklinks(params, domain) {
+  const sections = [];
+  try {
+    const report = await backlinksFetch(params, {
+      type: "backlinks_overview",
+      target: domain,
+      target_type: "root_domain"
+    });
+    if (report.rows.length === 0) {
+      sections.push("_No backlink data found._", "");
+      return sections;
+    }
+    const row = report.rows[0];
+    sections.push("| Metric | Value |");
+    sections.push("|--------|-------|");
+    for (const col of report.columns) {
+      sections.push(`| ${col} | ${formatNumber(Number(row[col]) || 0)} |`);
+    }
+    sections.push("");
+  } catch (err) {
+    sections.push(
+      `_Error: ${err instanceof Error ? err.message : String(err)}_`,
+      ""
+    );
+  }
+  return sections;
+}
+function renderCsvTable(report, maxRows) {
+  const cols = report.columns;
+  const rows = report.rows.slice(0, maxRows);
+  const lines = [];
+  lines.push(`| ${cols.join(" | ")} |`);
+  lines.push(`|${cols.map(() => "---").join("|")}|`);
+  for (const row of rows) {
+    const cells = cols.map((c) => (row[c] ?? "").replace(/\|/g, "\\|"));
+    lines.push(`| ${cells.join(" | ")} |`);
+  }
+  return lines;
+}
 var semrushSetupFlow = {
   initialState: () => ({}),
   steps: [
+    {
+      slug: "domain",
+      type: "select",
+      allowFreeText: true,
+      question: {
+        ja: "\u5206\u6790\u5BFE\u8C61\u306E\u30C9\u30E1\u30A4\u30F3\u3092\u9078\u629E\u307E\u305F\u306F\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044",
+        en: "Select or enter the domain to analyze"
+      },
+      async fetchOptions(_state, rt) {
+        const result = await fetchProjects(rt.params);
+        if (!result.ok || result.projects.length === 0) return [];
+        const seen = /* @__PURE__ */ new Set();
+        const options = [];
+        for (const p of result.projects) {
+          const d = projectDomain(p);
+          if (d && !seen.has(d)) {
+            seen.add(d);
+            options.push({
+              value: d,
+              label: `${d} (${projectName(p)})`
+            });
+          }
+        }
+        return options;
+      },
+      applyAnswer: (state, answer) => ({ ...state, domain: answer[0] })
+    },
+    {
+      slug: "database",
+      type: "select",
+      allowFreeText: false,
+      question: {
+        ja: "\u30EA\u30FC\u30B8\u30E7\u30F3\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\u5BFE\u8C61\u30C9\u30E1\u30A4\u30F3\u306E\u4E3B\u8981\u5E02\u5834\uFF09",
+        en: "Select the region (primary market for the target domain)"
+      },
+      async fetchOptions() {
+        return SEMRUSH_DATABASES.map((db) => ({
+          value: db.value,
+          label: `${db.label} (${db.value})`
+        }));
+      },
+      applyAnswer: (state, answer) => ({ ...state, database: answer[0] })
+    },
+    {
+      slug: "reportTypes",
+      type: "multiSelect",
+      question: {
+        ja: "\u63A2\u7D22\u3059\u308B\u30EC\u30DD\u30FC\u30C8\u7A2E\u5225\u3092\u9078\u3093\u3067\u304F\u3060\u3055\u3044\uFF08\u8907\u6570\u9078\u629E\u53EF\uFF09",
+        en: "Select report types to explore (multi-select allowed)"
+      },
+      async fetchOptions(_state, rt) {
+        return REPORT_TYPE_VALUES.map((value) => ({
+          value,
+          label: REPORT_TYPE_LABELS[value][rt.language]
+        }));
+      },
+      applyAnswer: (state, answer) => ({ ...state, reportTypes: answer })
+    },
     {
       slug: "projects",
       type: "multiSelect",
@@ -669,7 +958,9 @@ var semrushSetupFlow = {
           const id = projectId(p);
           if (!id) return null;
           return { value: id, label: projectName(p) };
-        }).filter((opt) => opt !== null);
+        }).filter(
+          (opt) => opt !== null
+        );
         if (options.length === 0) return [];
         return [
           {
@@ -683,49 +974,80 @@ var semrushSetupFlow = {
     }
   ],
   async finalize(state, rt) {
-    const sections = ["## Semrush", ""];
-    if (!state.projects?.length) {
+    if (!state.domain || !state.database || !state.reportTypes) {
+      throw new Error("Semrush setup: incomplete state on finalize");
+    }
+    const domain = state.domain;
+    const database = state.database;
+    const selected = state.reportTypes.filter(
+      (r) => REPORT_TYPE_VALUES.includes(r)
+    );
+    const sections = [
+      "## Semrush",
+      "",
+      `**Domain:** ${domain}`,
+      `**Region:** ${database}`,
+      ""
+    ];
+    for (const reportType of selected) {
       sections.push(
-        "_No Semrush Projects API access detected; Standard Analytics reports run by domain/keyword and don't require pre-selection._",
+        `### ${REPORT_TYPE_LABELS[reportType].en}`,
         ""
       );
-      return sections.join("\n");
-    }
-    const result = await fetchProjects(rt.params);
-    if (!result.ok) {
-      throw new Error(
-        `semrush: listProjects failed on finalize: ${result.error}`
-      );
-    }
-    const projectByIdMap = /* @__PURE__ */ new Map();
-    for (const p of result.projects) {
-      const id = projectId(p);
-      if (id) projectByIdMap.set(id, p);
-    }
-    const targetIds = await resolveSetupSelection({
-      selected: state.projects,
-      allSentinel: ALL_PROJECTS,
-      fetchAll: async () => result.projects.map((p) => projectId(p)).filter((id) => id),
-      limit: SEMRUSH_SETUP_MAX_PROJECTS
-    });
-    if (!targetIds.length) {
-      sections.push("_No projects selected._", "");
-      return sections.join("\n");
+      switch (reportType) {
+        case "domain_overview":
+          sections.push(
+            ...await fetchDomainOverview(rt.params, domain, database)
+          );
+          break;
+        case "organic_search":
+          sections.push(
+            ...await fetchOrganicSearch(rt.params, domain, database)
+          );
+          break;
+        case "paid_search":
+          sections.push(
+            ...await fetchPaidSearch(rt.params, domain, database)
+          );
+          break;
+        case "backlinks":
+          sections.push(...await fetchBacklinks(rt.params, domain));
+          break;
+      }
     }
-    sections.push("| Project | Domain | Created |");
-    sections.push("|---------|--------|---------|");
-    for (const id of targetIds) {
-      const p = projectByIdMap.get(id);
-      if (!p) {
-        sections.push(`| ${id} | - | - |`);
-        continue;
+    if (state.projects?.length) {
+      const result = await fetchProjects(rt.params);
+      if (result.ok) {
+        const projectByIdMap = /* @__PURE__ */ new Map();
+        for (const p of result.projects) {
+          const id = projectId(p);
+          if (id) projectByIdMap.set(id, p);
+        }
+        const targetIds = await resolveSetupSelection({
+          selected: state.projects,
+          allSentinel: ALL_PROJECTS,
+          fetchAll: async () => result.projects.map((p) => projectId(p)).filter((id) => id),
+          limit: SEMRUSH_SETUP_MAX_PROJECTS
+        });
+        if (targetIds.length > 0) {
+          sections.push("### Projects", "");
+          sections.push("| Project | Domain | Created |");
+          sections.push("|---------|--------|---------|");
+          for (const id of targetIds) {
+            const p = projectByIdMap.get(id);
+            if (!p) {
+              sections.push(`| ${id} | - | - |`);
+              continue;
+            }
+            const name = projectName(p).replace(/\|/g, "\\|");
+            const dom = projectDomain(p).replace(/\|/g, "\\|") || "-";
+            const created = projectCreatedAt(p) || "-";
+            sections.push(`| ${name} | ${dom} | ${created} |`);
+          }
+          sections.push("");
+        }
       }
-      const name = projectName(p).replace(/\|/g, "\\|");
-      const domain = projectDomain(p).replace(/\|/g, "\\|") || "-";
-      const created = projectCreatedAt(p) || "-";
-      sections.push(`| ${name} | ${domain} | ${created} |`);
     }
-    sections.push("");
     return sections.join("\n");
   }
 };
@@ -745,7 +1067,7 @@ var semrushConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`semrush-api-key_request\`: The only way to call the Semrush API. Use it for the Standard Analytics API (\`/?type=...\` reports), the Trends API (\`/analytics/v1/...\`), and the Projects API (\`/management/v1/...\`). Authentication is handled automatically \u2014 the API key is appended as the \`key\` query parameter; never include it yourself. The Standard Analytics API returns semicolon-separated CSV with the first row as the header (use \`responseFormat="text"\`); the Trends and Projects APIs return JSON (use \`responseFormat="json"\`). Errors from the Standard API are returned as a body that starts with \`ERROR\`, often with HTTP 200 \u2014 the tool surfaces these as \`success: false\` automatically.
+- \`connector_semrush-api-key_request\`: The only way to call the Semrush API. Use it for the Standard Analytics API (\`/?type=...\` reports), the Trends API (\`/analytics/v1/...\`), and the Projects API (\`/management/v1/...\`). Authentication is handled automatically \u2014 the API key is appended as the \`key\` query parameter; never include it yourself. The Standard Analytics API returns semicolon-separated CSV with the first row as the header (use \`responseFormat="text"\`); the Trends and Projects APIs return JSON (use \`responseFormat="json"\`). Errors from the Standard API are returned as a body that starts with \`ERROR\`, often with HTTP 200 \u2014 the tool surfaces these as \`success: false\` automatically.
 
 ### Business Logic
 
@@ -758,7 +1080,7 @@ SDK methods (client created via \`connection(connectionId)\`):
 - \`client.trends(path, query?)\` \u2014 call a Trends API endpoint (\`/analytics/v1/...\`) and return parsed JSON
 - \`client.projects(path, init?)\` \u2014 call a Projects API endpoint (\`/management/v1/...\`) and return parsed JSON
 
-\u{1F6A8} **MANDATORY pre-flight before creating any server logic that calls \`report()\`.** Before authoring a TypeScript handler that invokes \`client.report(...)\` (Standard Analytics \u2014 \`domain_ranks\`, \`domain_organic\`, \`phrase_this\`, etc.), you MUST first call the \`semrush-api-key_request\` tool with \`path: "https://www.semrush.com/users/countapiunits.html"\`, no \`queryParams\`, \`responseFormat: "text"\` to confirm the unit balance is greater than 0. If the balance is 0, **stop, do not create the server logic**, and report the issue to the user (the account owner needs to top up API units in the Semrush console). \`testFetchServerLogic\` will execute the handler and consume units; creating handlers when the balance is 0 produces \`ERROR 132 :: API UNITS BALANCE IS ZERO\` failures across every server logic.
+\u{1F6A8} **MANDATORY pre-flight before creating any server logic that calls \`report()\`.** Before authoring a TypeScript handler that invokes \`client.report(...)\` (Standard Analytics \u2014 \`domain_ranks\`, \`domain_organic\`, \`phrase_this\`, etc.), you MUST first call the \`connector_semrush-api-key_request\` tool with \`path: "https://www.semrush.com/users/countapiunits.html"\`, no \`queryParams\`, \`responseFormat: "text"\` to confirm the unit balance is greater than 0. If the balance is 0, **stop, do not create the server logic**, and report the issue to the user (the account owner needs to top up API units in the Semrush console). \`testFetchServerLogic\` will execute the handler and consume units; creating handlers when the balance is 0 produces \`ERROR 132 :: API UNITS BALANCE IS ZERO\` failures across every server logic.
 
 \u{1F6A8} **Always set a small \`display_limit\` explicitly \u2014 never rely on the default.** Semrush computes "required units = display_limit \xD7 per-row cost" up front, and rejects the request with \`ERROR 132 :: API UNITS BALANCE IS ZERO\` when the *estimated* cost exceeds the remaining balance, **even when the actual balance is non-zero** (e.g. balance \u2248 40,950 still fails for \`display_limit=10000\` on costly reports). Default to \`display_limit: "1000"\` (or smaller \u2014 \`"100"\` is plenty for most dashboards), and only increase it when the user explicitly asks for a larger sample AND \`checkUnits()\` confirms enough headroom. If you truly need all rows, paginate with \`display_offset\` in chunks of 1000 instead of bumping \`display_limit\`. Treat \`ERROR 132\` as "request too large for the current balance" first, and only as "balance is literally zero" after re-checking units.
 
@@ -848,7 +1170,7 @@ To check remaining API units (free, does NOT consume units), call the request to
 - Date strings in historical endpoints must be the 15th of the month (\`YYYYMM15\`)`,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`semrush-api-key_request\`: Semrush API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002Standard Analytics API\uFF08\`/?type=...\` \u5F62\u5F0F\u306E\u30EC\u30DD\u30FC\u30C8\uFF09\u3001Trends API\uFF08\`/analytics/v1/...\`\uFF09\u3001Projects API\uFF08\`/management/v1/...\`\uFF09\u3059\u3079\u3066\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\u306F\u81EA\u52D5\u7684\u306B\u884C\u308F\u308C\u3001API\u30AD\u30FC\u306F \`key\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3068\u3057\u3066\u4ED8\u4E0E\u3055\u308C\u308B\u305F\u3081\u3001\u81EA\u5206\u3067\u542B\u3081\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002Standard Analytics API \u306F1\u884C\u76EE\u304C\u30D8\u30C3\u30C0\u30FC\u306E\u30BB\u30DF\u30B3\u30ED\u30F3\u533A\u5207\u308ACSV\u3092\u8FD4\u3059\u305F\u3081 \`responseFormat="text"\` \u3092\u4F7F\u7528\u3057\u3001Trends/Projects API \u306F JSON \u3092\u8FD4\u3059\u305F\u3081 \`responseFormat="json"\` \u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002Standard API \u306E\u30A8\u30E9\u30FC\u306F HTTP 200 \u3067\u3082\u672C\u6587\u304C \`ERROR\` \u3067\u59CB\u307E\u308B\u5F62\u5F0F\u3067\u8FD4\u308B\u3053\u3068\u304C\u3042\u308A\u307E\u3059\u304C\u3001\u30C4\u30FC\u30EB\u306F\u81EA\u52D5\u7684\u306B \`success: false\` \u3068\u3057\u3066\u8FD4\u3057\u307E\u3059\u3002
+- \`connector_semrush-api-key_request\`: Semrush API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002Standard Analytics API\uFF08\`/?type=...\` \u5F62\u5F0F\u306E\u30EC\u30DD\u30FC\u30C8\uFF09\u3001Trends API\uFF08\`/analytics/v1/...\`\uFF09\u3001Projects API\uFF08\`/management/v1/...\`\uFF09\u3059\u3079\u3066\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\u306F\u81EA\u52D5\u7684\u306B\u884C\u308F\u308C\u3001API\u30AD\u30FC\u306F \`key\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3068\u3057\u3066\u4ED8\u4E0E\u3055\u308C\u308B\u305F\u3081\u3001\u81EA\u5206\u3067\u542B\u3081\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002Standard Analytics API \u306F1\u884C\u76EE\u304C\u30D8\u30C3\u30C0\u30FC\u306E\u30BB\u30DF\u30B3\u30ED\u30F3\u533A\u5207\u308ACSV\u3092\u8FD4\u3059\u305F\u3081 \`responseFormat="text"\` \u3092\u4F7F\u7528\u3057\u3001Trends/Projects API \u306F JSON \u3092\u8FD4\u3059\u305F\u3081 \`responseFormat="json"\` \u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002Standard API \u306E\u30A8\u30E9\u30FC\u306F HTTP 200 \u3067\u3082\u672C\u6587\u304C \`ERROR\` \u3067\u59CB\u307E\u308B\u5F62\u5F0F\u3067\u8FD4\u308B\u3053\u3068\u304C\u3042\u308A\u307E\u3059\u304C\u3001\u30C4\u30FC\u30EB\u306F\u81EA\u52D5\u7684\u306B \`success: false\` \u3068\u3057\u3066\u8FD4\u3057\u307E\u3059\u3002
 
 ### Business Logic
 
@@ -861,7 +1183,7 @@ SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u30
 - \`client.trends(path, query?)\` \u2014 Trends API \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\`/analytics/v1/...\`\uFF09\u3092\u547C\u3073\u51FA\u3057 JSON \u3092\u8FD4\u3059
 - \`client.projects(path, init?)\` \u2014 Projects API \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\`/management/v1/...\`\uFF09\u3092\u547C\u3073\u51FA\u3057 JSON \u3092\u8FD4\u3059
 
-\u{1F6A8} **\`report()\` \u3092\u547C\u3076\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u3059\u308B\u524D\u306E\u5FC5\u9808\u30D7\u30EA\u30D5\u30E9\u30A4\u30C8\u3002** Standard Analytics\uFF08\`domain_ranks\`\u3001\`domain_organic\`\u3001\`phrase_this\` \u306A\u3069\uFF09\u306E \`client.report(...)\` \u3092\u542B\u3080 TypeScript \u30CF\u30F3\u30C9\u30E9\u3092\u4F5C\u6210\u3059\u308B\u524D\u306B\u3001\u5FC5\u305A \`semrush-api-key_request\` \u30C4\u30FC\u30EB\u3092 \`path: "https://www.semrush.com/users/countapiunits.html"\`\u3001\`queryParams\` \u7121\u3057\u3001\`responseFormat: "text"\` \u3067\u547C\u3073\u51FA\u3057\u3066\u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u304C 0 \u3088\u308A\u5927\u304D\u3044\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B\u3053\u3068\u3002\u6B8B\u91CF\u304C 0 \u306E\u5834\u5408\u306F **\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u305B\u305A\u306B\u505C\u6B62\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u306B\u5831\u544A**\u3059\u308B\uFF08Semrush \u306E\u7BA1\u7406\u30B3\u30F3\u30BD\u30FC\u30EB\u304B\u3089 API \u30E6\u30CB\u30C3\u30C8\u3092\u88DC\u5145\u3059\u308B\u5FC5\u8981\u304C\u3042\u308B\uFF09\u3002\`testFetchServerLogic\` \u306F\u30CF\u30F3\u30C9\u30E9\u3092\u5B9F\u884C\u3057\u3066\u30E6\u30CB\u30C3\u30C8\u3092\u6D88\u8CBB\u3059\u308B\u305F\u3081\u3001\u6B8B\u91CF 0 \u306E\u307E\u307E\u4F5C\u6210\u3059\u308B\u3068\u5168\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u304C \`ERROR 132 :: API UNITS BALANCE IS ZERO\` \u3067\u5931\u6557\u3059\u308B\u3002
+\u{1F6A8} **\`report()\` \u3092\u547C\u3076\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u3059\u308B\u524D\u306E\u5FC5\u9808\u30D7\u30EA\u30D5\u30E9\u30A4\u30C8\u3002** Standard Analytics\uFF08\`domain_ranks\`\u3001\`domain_organic\`\u3001\`phrase_this\` \u306A\u3069\uFF09\u306E \`client.report(...)\` \u3092\u542B\u3080 TypeScript \u30CF\u30F3\u30C9\u30E9\u3092\u4F5C\u6210\u3059\u308B\u524D\u306B\u3001\u5FC5\u305A \`connector_semrush-api-key_request\` \u30C4\u30FC\u30EB\u3092 \`path: "https://www.semrush.com/users/countapiunits.html"\`\u3001\`queryParams\` \u7121\u3057\u3001\`responseFormat: "text"\` \u3067\u547C\u3073\u51FA\u3057\u3066\u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u304C 0 \u3088\u308A\u5927\u304D\u3044\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B\u3053\u3068\u3002\u6B8B\u91CF\u304C 0 \u306E\u5834\u5408\u306F **\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u305B\u305A\u306B\u505C\u6B62\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u306B\u5831\u544A**\u3059\u308B\uFF08Semrush \u306E\u7BA1\u7406\u30B3\u30F3\u30BD\u30FC\u30EB\u304B\u3089 API \u30E6\u30CB\u30C3\u30C8\u3092\u88DC\u5145\u3059\u308B\u5FC5\u8981\u304C\u3042\u308B\uFF09\u3002\`testFetchServerLogic\` \u306F\u30CF\u30F3\u30C9\u30E9\u3092\u5B9F\u884C\u3057\u3066\u30E6\u30CB\u30C3\u30C8\u3092\u6D88\u8CBB\u3059\u308B\u305F\u3081\u3001\u6B8B\u91CF 0 \u306E\u307E\u307E\u4F5C\u6210\u3059\u308B\u3068\u5168\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u304C \`ERROR 132 :: API UNITS BALANCE IS ZERO\` \u3067\u5931\u6557\u3059\u308B\u3002
 
 \u{1F6A8} **\`display_limit\` \u306F\u5FC5\u305A\u660E\u793A\u7684\u306B\u5C0F\u3055\u3044\u5024\u3092\u6307\u5B9A\u3057\u3001\u30C7\u30D5\u30A9\u30EB\u30C8\u306B\u983C\u3089\u306A\u3044\u3053\u3068\u3002** Semrush \u306F\u4E8B\u524D\u306B\u300C\u5FC5\u8981\u30E6\u30CB\u30C3\u30C8 = display_limit \xD7 \u884C\u3042\u305F\u308A\u5358\u4FA1\u300D\u3092\u8A08\u7B97\u3057\u3001\u305D\u306E**\u898B\u7A4D\u984D**\u304C\u6B8B\u91CF\u3092\u8D85\u3048\u308B\u3068\u30EA\u30AF\u30A8\u30B9\u30C8\u3092 \`ERROR 132 :: API UNITS BALANCE IS ZERO\` \u3067\u62D2\u5426\u3059\u308B\u3002**\u5B9F\u6B8B\u91CF\u304C\u30BC\u30ED\u3067\u306A\u304F\u3066\u3082**\u8D77\u3053\u308B\uFF08\u4F8B\uFF1A\u6B8B\u91CF\u7D04 40,950 \u3067\u3082\u3001\u30B3\u30B9\u30C8\u306E\u9AD8\u3044\u30EC\u30DD\u30FC\u30C8\u3067 \`display_limit=10000\` \u3060\u3068\u5931\u6557\u3059\u308B\uFF09\u3002\u539F\u5247\u3068\u3057\u3066 \`display_limit: "1000"\`\uFF08\u30C0\u30C3\u30B7\u30E5\u30DC\u30FC\u30C9\u7528\u9014\u306A\u3089 \`"100"\` \u3067\u3082\u5341\u5206\uFF09\u3092\u6307\u5B9A\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u304C\u660E\u793A\u7684\u306B\u5927\u304D\u306A\u30B5\u30F3\u30D7\u30EB\u3092\u8981\u6C42\u3057\u3001\u304B\u3064 \`checkUnits()\` \u3067\u6B8B\u91CF\u306B\u5341\u5206\u306A\u4F59\u88D5\u304C\u3042\u308B\u3053\u3068\u3092\u78BA\u8A8D\u3067\u304D\u305F\u5834\u5408\u306E\u307F\u5897\u3084\u3059\u3002\u5168\u884C\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F \`display_limit\` \u3092\u4E0A\u3052\u308B\u306E\u3067\u306F\u306A\u304F\u3001\`display_offset\` \u3067 1000 \u4EF6\u523B\u307F\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u5B9F\u88C5\u3059\u308B\u3053\u3068\u3002\`ERROR 132\` \u306F\u300C\u6B8B\u91CF\u304C\u6587\u5B57\u901A\u308A\u30BC\u30ED\u300D\u3088\u308A\u5148\u306B\u300C\u73FE\u5728\u306E\u6B8B\u91CF\u306B\u5BFE\u3057\u3066\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5927\u304D\u3059\u304E\u308B\u300D\u3092\u7591\u3044\u3001\u30E6\u30CB\u30C3\u30C8\u3092\u518D\u78BA\u8A8D\u3057\u3066\u304B\u3089\u5224\u65AD\u3059\u308B\u3053\u3068\u3002