alterlab-mcp-server 1.7.0 → 1.9.0

package/dist/tools/sessions.js

@@ -10,6 +10,7 @@ exports.handleRefreshSession = handleRefreshSession;
 exports.handleDeleteSession = handleDeleteSession;
 const zod_1 = require("zod");
 const errors_js_1 = require("../errors.js");
+const common_js_1 = require("./common.js");
 const format_js_1 = require("../format.js");
 // ============================================================================
 // List Sessions
@@ -36,6 +37,24 @@ async function handleListSessions(client) {
 // ============================================================================
 // Create Session
 // ============================================================================
+const cookieObjectSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1),
+    value: zod_1.z.string(),
+    domain: zod_1.z.string().optional(),
+    path: zod_1.z.string().optional(),
+    secure: zod_1.z.boolean().optional(),
+    httpOnly: zod_1.z.boolean().optional(),
+    sameSite: zod_1.z.string().optional(),
+    expires: zod_1.z.number().optional(),
+})
+    .passthrough();
+const cookiesSchema = zod_1.z.union([
+    zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
+    zod_1.z.array(cookieObjectSchema).max(100),
+]);
+const COOKIES_DESCRIPTION = 'Cookies as a {name: value} object (e.g. {"session-id": "abc123"}) or as a list (max 100) of cookie ' +
+    "objects with metadata: {name, value, domain?, path?, secure?, httpOnly?, sameSite?, expires?}.";
 exports.createSessionSchema = zod_1.z.object({
     name: zod_1.z
         .string()
@@ -44,29 +63,55 @@ exports.createSessionSchema = zod_1.z.object({
         .describe("Human-readable name for this session (e.g., 'My Amazon Account')"),
     domain: zod_1.z
         .string()
-        .min(1)
+        .min(3)
+        .max(255)
         .describe("Domain this session is for (e.g., 'amazon.com')"),
-    cookies: zod_1.z
+    consent: zod_1.z
+        .boolean()
+        .describe("Explicit GDPR consent from the account owner to store these session cookies. " +
+        "Must be true — the API rejects session creation with CONSENT_REQUIRED otherwise. " +
+        "Only set true after the user has agreed to AlterLab storing their cookies."),
+    cookies: cookiesSchema.optional().describe("Cookies for authentication. " + COOKIES_DESCRIPTION),
+    headers: zod_1.z
         .record(zod_1.z.string(), zod_1.z.string())
-        .describe("Cookie key-value pairs for authentication " +
-        '(e.g., {"session-id": "abc123", "session-token": "xyz789"})'),
-    user_agent: zod_1.z
+        .optional()
+        .describe("Custom headers sent with this session (e.g., a User-Agent or Authorization header)"),
+    expires_at: zod_1.z
         .string()
         .optional()
-        .describe("Browser User-Agent string to use with this session"),
+        .describe("Session expiry in ISO 8601 format (e.g., '2026-12-31T23:59:59Z')"),
+    notes: zod_1.z.string().max(1000).optional().describe("Free-text notes about this session"),
+    auto_refresh_enabled: zod_1.z
+        .boolean()
+        .optional()
+        .describe("Enable proactive expiry detection and health checks (API default true)"),
+    notify_before_expiry: zod_1.z
+        .boolean()
+        .optional()
+        .describe("Notify when the session is about to expire (API default true)"),
+    notify_on_failure: zod_1.z
+        .boolean()
+        .optional()
+        .describe("Notify when session validation fails (API default true)"),
+    organization_id: zod_1.z
+        .string()
+        .uuid()
+        .optional()
+        .describe("Organization to assign the session to (org admins only)"),
+    shared: zod_1.z
+        .boolean()
+        .optional()
+        .describe("Share the session with organization members immediately (API default false)"),
 });
 exports.createSessionDescription = "Create a new stored session for authenticated scraping. " +
     "Provide cookies from a logged-in browser session to enable scraping " +
     "behind login walls. The session is stored securely and can be reused " +
-    "across multiple scrape requests via session_id.";
+    "across multiple scrape requests via session_id. " +
+    "Requires consent=true (explicit GDPR consent to store the cookies); optional headers, expires_at, notes, " +
+    "auto_refresh/notification flags and organization sharing are supported.";
 async function handleCreateSession(client, params) {
     try {
-        const response = await client.createSession({
-            name: params.name,
-            domain: params.domain,
-            cookies: params.cookies,
-            user_agent: params.user_agent,
-        });
+        const response = await client.createSession((0, common_js_1.compact)(params));
         return {
             content: [{ type: "text", text: (0, format_js_1.formatSessionCreateResponse)(response) }],
         };
@@ -138,11 +183,9 @@ exports.updateSessionSchema = zod_1.z.object({
         .max(100)
         .optional()
         .describe("New name for the session"),
-    cookies: zod_1.z
-        .record(zod_1.z.string(), zod_1.z.string())
+    cookies: cookiesSchema
         .optional()
-        .describe("New cookie key-value pairs — replaces ALL existing cookies " +
-        '(e.g., {"session-id": "new123", "session-token": "newxyz"})'),
+        .describe("New cookies — replaces ALL existing cookies. " + COOKIES_DESCRIPTION),
     headers: zod_1.z
         .record(zod_1.z.string(), zod_1.z.string())
         .optional()
@@ -156,6 +199,18 @@ exports.updateSessionSchema = zod_1.z.object({
         .max(1000)
         .optional()
         .describe("Notes or description for this session"),
+    auto_refresh_enabled: zod_1.z
+        .boolean()
+        .optional()
+        .describe("Enable or disable proactive expiry detection and health checks"),
+    notify_before_expiry: zod_1.z
+        .boolean()
+        .optional()
+        .describe("Enable or disable the before-expiry notification"),
+    notify_on_failure: zod_1.z
+        .boolean()
+        .optional()
+        .describe("Enable or disable the validation-failure notification"),
 });
 exports.updateSessionDescription = "Update a stored session's properties. You can change the name, rotate " +
     "cookies, update custom headers, set a new expiration, or add notes. " +
@@ -181,11 +236,10 @@ async function handleUpdateSession(client, params) {
 // ============================================================================
 exports.refreshSessionSchema = zod_1.z.object({
     session_id: zod_1.z.string().uuid().describe("UUID of the session to refresh"),
-    cookies: zod_1.z
-        .record(zod_1.z.string(), zod_1.z.string())
+    cookies: cookiesSchema
         .optional()
-        .describe("New cookie key-value pairs to replace the old ones. " +
-        "If omitted, only failure counters are reset."),
+        .describe("New cookies to replace the old ones. If omitted, only failure counters are reset. " +
+        COOKIES_DESCRIPTION),
     headers: zod_1.z
         .record(zod_1.z.string(), zod_1.z.string())
         .optional()

package/dist/tools/sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"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"}

package/dist/tools/simple_batch.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AlterLabClient } from "../client.js";
+export declare const simpleBatchSchema: z.ZodObject<{
+    urls: z.ZodArray<z.ZodString, "many">;
+    formats: z.ZodDefault<z.ZodArray<z.ZodEnum<["text", "json", "json_v2", "html", "markdown", "rag", "content", "raw"]>, "many">>;
+    render_js: z.ZodDefault<z.ZodBoolean>;
+    use_proxy: z.ZodDefault<z.ZodBoolean>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    max_concurrent: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    formats: ("content" | "text" | "json" | "json_v2" | "html" | "markdown" | "rag" | "raw")[];
+    render_js: boolean;
+    use_proxy: boolean;
+    urls: string[];
+    max_concurrent: number;
+}, {
+    urls: string[];
+    timeout?: number | undefined;
+    formats?: ("content" | "text" | "json" | "json_v2" | "html" | "markdown" | "rag" | "raw")[] | undefined;
+    render_js?: boolean | undefined;
+    use_proxy?: boolean | undefined;
+    max_concurrent?: number | undefined;
+}>;
+export declare const simpleBatchDescription: string;
+export declare function handleSimpleBatch(client: AlterLabClient, params: z.infer<typeof simpleBatchSchema>): Promise<CallToolResult>;
+//# sourceMappingURL=simple_batch.d.ts.map

package/dist/tools/simple_batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple_batch.d.ts","sourceRoot":"","sources":["../../src/tools/simple_batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EA4C5B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAMoE,CAAC;AAMxG,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACxC,OAAO,CAAC,cAAc,CAAC,CAwGzB"}

package/dist/tools/simple_batch.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simpleBatchDescription = exports.simpleBatchSchema = void 0;
+exports.handleSimpleBatch = handleSimpleBatch;
+const zod_1 = require("zod");
+const common_js_1 = require("./common.js");
+const format_js_1 = require("../format.js");
+exports.simpleBatchSchema = zod_1.z.object({
+    urls: zod_1.z
+        .array(zod_1.z.string().url().max(2083))
+        .min(1)
+        .max(20)
+        .describe("List of URLs to scrape (max 20). All results are returned synchronously."),
+    formats: zod_1.z
+        .array(common_js_1.allFormatEnum)
+        .default(["markdown"])
+        .describe("Output formats applied to every URL. 'markdown' is best for LLM consumption."),
+    render_js: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Render JavaScript using headless browser for all URLs. " +
+        "Required for JS-heavy sites. Forces tier 4 ($0.004/req)."),
+    use_proxy: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Route all requests through premium proxy (+$0.0002/req)."),
+    timeout: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(300)
+        .default(90)
+        .describe("Request timeout in seconds per URL (1-300)."),
+    max_concurrent: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .default(3)
+        .describe("Maximum number of URLs to scrape in parallel (1-10, default 3). " +
+        "Higher values finish faster but consume more concurrent connections."),
+});
+exports.simpleBatchDescription = "Scrape multiple URLs simultaneously and get all results back in one call — no polling required. " +
+    "Unlike alterlab_batch (async with batch_id polling), this returns all results inline when complete. " +
+    "Best for 2-20 URLs where you need results immediately. For 20+ URLs, use alterlab_batch instead. " +
+    "Uses concurrent scraping (controlled by max_concurrent) for speed. " +
+    "Shows per-URL status, content preview, and a total cost summary at the end. " +
+    "Handles partial failures gracefully — failed URLs show error details, successful ones show content.";
+async function handleSimpleBatch(client, params) {
+    const { urls, formats, render_js, use_proxy, timeout, max_concurrent } = params;
+    // Concurrency semaphore — limits inflight scrapes to max_concurrent.
+    let inflight = 0;
+    const queue = [];
+    function acquire() {
+        if (inflight < max_concurrent) {
+            inflight++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => queue.push(resolve));
+    }
+    function release() {
+        inflight--;
+        const next = queue.shift();
+        if (next) {
+            inflight++;
+            next();
+        }
+    }
+    async function scrapeOne(url) {
+        await acquire();
+        try {
+            const response = await client.scrape({
+                url,
+                mode: "auto",
+                formats,
+                sync: true,
+                timeout,
+                advanced: {
+                    render_js,
+                    use_proxy,
+                    markdown: formats.includes("markdown"),
+                    scroll_to_load: false,
+                    scroll_count: 3,
+                    remove_cookie_banners: true,
+                    block_images: false,
+                },
+            });
+            const costMicrocents = response.billing?.final_cost_microcents ?? 0;
+            const costUsd = costMicrocents / 1_000_000;
+            return {
+                status: "fulfilled",
+                url,
+                text: (0, format_js_1.formatScrapeResponse)(response),
+                cost: costUsd,
+            };
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error
+                ? err.message
+                : typeof err === "object" && err !== null && "detail" in err
+                    ? String(err.detail ?? "unknown error")
+                    : "unknown error";
+            return { status: "rejected", url, error: errorMsg };
+        }
+        finally {
+            release();
+        }
+    }
+    const outcomes = await Promise.all(urls.map((url) => scrapeOne(url)));
+    // Build response
+    const parts = [
+        `**Batch Scrape Results** — ${urls.length} URL${urls.length !== 1 ? "s" : ""}`,
+        "",
+    ];
+    let totalCost = 0;
+    let successCount = 0;
+    let failCount = 0;
+    for (let i = 0; i < outcomes.length; i++) {
+        const outcome = outcomes[i];
+        parts.push(`---\n## [${i + 1}/${urls.length}] ${outcome.url}`);
+        if (outcome.status === "fulfilled") {
+            successCount++;
+            totalCost += outcome.cost;
+            parts.push(outcome.text);
+        }
+        else {
+            failCount++;
+            parts.push(`**Error**: ${outcome.error}`);
+        }
+        parts.push("");
+    }
+    // Summary footer
+    parts.push("---");
+    parts.push(`**Summary**: ${successCount} succeeded, ${failCount} failed` +
+        (totalCost > 0 ? ` | Total cost: $${totalCost.toFixed(6)}` : ""));
+    // Append balance warning if the last scrape left a low-balance signal
+    const balanceWarningSuffix = (0, format_js_1.formatBalanceWarning)(client.getLastBalanceWarning());
+    return {
+        content: [{ type: "text", text: parts.join("\n") + balanceWarningSuffix }],
+    };
+}
+//# sourceMappingURL=simple_batch.js.map

package/dist/tools/simple_batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple_batch.js","sourceRoot":"","sources":["../../src/tools/simple_batch.ts"],"names":[],"mappings":"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"}

package/dist/tools/usage.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AlterLabClient } from "../client.js";
+export declare const usageSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const usageDescription: string;
+export declare function handleUsage(client: AlterLabClient): Promise<CallToolResult>;
+//# sourceMappingURL=usage.d.ts.map

package/dist/tools/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,eAAO,MAAM,WAAW,gDAAe,CAAC;AAExC,eAAO,MAAM,gBAAgB,QAIqC,CAAC;AAEnE,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/tools/usage.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usageDescription = exports.usageSchema = void 0;
+exports.handleUsage = handleUsage;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+exports.usageSchema = zod_1.z.object({});
+exports.usageDescription = "Get account usage for the current billing period — balance, credits consumed this period, " +
+    "account tier and entitlement source. " +
+    "Use this to track spend against your plan; use alterlab_check_balance for deposit and spend totals. " +
+    "No parameters required — uses your API key for identification.";
+async function handleUsage(client) {
+    try {
+        const usage = await client.getUsage();
+        return {
+            content: [{ type: "text", text: formatUsageResponse(usage) }],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+function formatUsageResponse(usage) {
+    const parts = ["**Usage**\n"];
+    parts.push(`- Balance: $${(usage.balance_microcents / 1_000_000).toFixed(4)}`);
+    parts.push(`- Credits used this period: ${usage.credits_used_month}`);
+    parts.push(`- Account tier: ${usage.account_tier}`);
+    parts.push(`- Entitlement source: ${usage.entitlement_source}`);
+    parts.push(`- Period: ${usage.period_start} to ${usage.period_end}`);
+    parts.push("\nAdd funds: https://alterlab.io/dashboard/billing");
+    return parts.join("\n");
+}
+function isApiError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "status" in error &&
+        typeof error.status === "number");
+}
+//# sourceMappingURL=usage.js.map

package/dist/tools/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":";;;AAcA,kCAcC;AA5BD,6BAAwB;AAGxB,4CAAgE;AAGnD,QAAA,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE3B,QAAA,gBAAgB,GAC3B,4FAA4F;IAC5F,uCAAuC;IACvC,sGAAsG;IACtG,gEAAgE,CAAC;AAE5D,KAAK,UAAU,WAAW,CAC/B,MAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;SAC9D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAA,6BAAiB,EAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAA,6BAAiB,EAAC,KAAc,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAoB;IAC/C,MAAM,KAAK,GAAa,CAAC,aAAa,CAAC,CAAC;IAExC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,+BAA+B,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,yBAAyB,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,YAAY,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAErE,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAEjE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QACjB,OAAQ,KAAkB,CAAC,MAAM,KAAK,QAAQ,CAC/C,CAAC;AACJ,CAAC"}