alterlab-mcp-server 1.1.1 → 1.2.0

package/dist/tools/map.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapDescription = exports.mapSchema = void 0;
+exports.handleMap = handleMap;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+exports.mapSchema = zod_1.z.object({
+    url: zod_1.z.string().url().describe("Starting URL for site discovery"),
+    max_pages: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50000)
+        .default(500)
+        .describe("Maximum URLs to discover"),
+    max_depth: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(10)
+        .default(3)
+        .describe("Link-following depth (0 = start page + sitemap only)"),
+    include_patterns: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe("Glob patterns — only include URLs whose path matches at least one (e.g., ['/docs/*'])"),
+    exclude_patterns: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe("Glob patterns — exclude URLs whose path matches any (e.g., ['/tag/*', '/page/*'])"),
+    search: zod_1.z
+        .string()
+        .max(500)
+        .optional()
+        .describe("Query to filter and rank discovered URLs by relevance (returns relevance_score per URL)"),
+    sitemap: zod_1.z
+        .enum(["skip", "include", "only"])
+        .default("include")
+        .describe("Sitemap handling: include (parse sitemaps + follow links), skip (links only), only (sitemap URLs only)"),
+    include_metadata: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Fetch title and meta description for each URL via lightweight GET (adds latency)"),
+    include_subdomains: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Include URLs from subdomains of the target domain"),
+    respect_robots: zod_1.z
+        .boolean()
+        .default(true)
+        .describe("Respect robots.txt directives"),
+});
+exports.mapDescription = "Discover all URLs on a website via sitemap parsing and link extraction. " +
+    "No JS rendering, no content scraping — pure lightweight URL discovery. " +
+    "Costs $0.001 per call regardless of how many URLs are found. " +
+    "Returns a flat list of URLs with source (sitemap/link) and depth. " +
+    "Use include_patterns/exclude_patterns to scope discovery to specific sections. " +
+    "Use search to rank URLs by relevance to a query. " +
+    "Use include_metadata=true to also fetch page titles and descriptions.";
+async function handleMap(client, params) {
+    try {
+        const response = await client.map({
+            url: params.url,
+            max_pages: params.max_pages,
+            max_depth: params.max_depth,
+            include_patterns: params.include_patterns,
+            exclude_patterns: params.exclude_patterns,
+            search: params.search,
+            sitemap: params.sitemap,
+            include_metadata: params.include_metadata,
+            include_subdomains: params.include_subdomains,
+            respect_robots: params.respect_robots,
+        });
+        const text = formatMapResponse(response, params.url);
+        return { content: [{ type: "text", text }] };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error, { url: params.url });
+        }
+        return (0, errors_js_1.formatErrorResult)(error, { url: params.url });
+    }
+}
+function formatMapResponse(response, startUrl) {
+    const r = response;
+    const mapId = String(r.map_id ?? "");
+    const totalUrls = Number(r.total_urls ?? 0);
+    const sitemapFound = Boolean(r.sitemap_found);
+    const creditsUsed = Number(r.credits_used ?? 0);
+    const urls = Array.isArray(r.urls) ? r.urls : [];
+    const parts = [
+        `**Site Map: ${startUrl}**\n`,
+        `- Map ID: \`${mapId}\``,
+        `- URLs discovered: ${totalUrls}`,
+        `- Sitemap found: ${sitemapFound ? "Yes" : "No"}`,
+        `- Credits used: ${creditsUsed}`,
+        "",
+    ];
+    // robots.txt info
+    const robotsTxt = r.robots_txt;
+    if (robotsTxt && robotsTxt.exists) {
+        const disallowed = Array.isArray(robotsTxt.disallowed_paths)
+            ? robotsTxt.disallowed_paths
+            : [];
+        if (disallowed.length > 0) {
+            parts.push(`**robots.txt**: ${disallowed.length} disallowed path${disallowed.length !== 1 ? "s" : ""}`);
+        }
+    }
+    // Show up to 50 URLs
+    const preview = urls.slice(0, 50);
+    if (preview.length > 0) {
+        parts.push(`\n**Discovered URLs** (showing ${preview.length} of ${totalUrls}):\n`);
+        for (const entry of preview) {
+            const e = entry;
+            const url = String(e.url ?? "");
+            const source = String(e.source ?? "");
+            const depth = Number(e.depth ?? 0);
+            const title = e.title ? ` — ${String(e.title)}` : "";
+            const score = e.relevance_score !== null && e.relevance_score !== undefined
+                ? ` [relevance: ${Number(e.relevance_score).toFixed(2)}]`
+                : "";
+            parts.push(`- [${source}, depth ${depth}] ${url}${title}${score}`);
+        }
+        if (totalUrls > 50) {
+            parts.push(`\n... and ${totalUrls - 50} more URLs`);
+        }
+    }
+    else {
+        parts.push("No URLs discovered.");
+    }
+    return parts.join("\n");
+}
+function isApiError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "status" in error &&
+        typeof error.status === "number");
+}
+//# sourceMappingURL=map.js.map

package/dist/tools/map.js.map

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

package/dist/tools/scrape.d.ts

@@ -4,8 +4,8 @@ import type { AlterLabClient } from "../client.js";
 export declare const scrapeSchema: z.ZodObject<{
     url: z.ZodString;
     mode: z.ZodDefault<z.ZodEnum<["auto", "html", "js", "pdf", "ocr"]>>;
-    formats: z.ZodDefault<z.ZodArray<z.ZodEnum<["text", "json", "html", "markdown"]>, "many">>;
-    render_js: z.ZodDefault<z.ZodBoolean>;
+    formats: z.ZodDefault<z.ZodArray<z.ZodEnum<["text", "json", "json_v2", "html", "markdown", "rag"]>, "many">>;
+    render_js: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"auto">]>>;
     use_proxy: z.ZodDefault<z.ZodBoolean>;
     proxy_country: z.ZodOptional<z.ZodString>;
     wait_for: z.ZodOptional<z.ZodString>;
@@ -13,30 +13,57 @@ export declare const scrapeSchema: z.ZodObject<{
     include_raw_html: z.ZodDefault<z.ZodBoolean>;
     session_id: z.ZodOptional<z.ZodString>;
     cookies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    scroll_to_load: z.ZodDefault<z.ZodBoolean>;
+    scroll_count: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    remove_cookie_banners: z.ZodDefault<z.ZodBoolean>;
+    location: z.ZodOptional<z.ZodObject<{
+        country: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        country?: string | undefined;
+        language?: string | undefined;
+    }, {
+        country?: string | undefined;
+        language?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     timeout: number;
     mode: "auto" | "html" | "js" | "pdf" | "ocr";
-    formats: ("text" | "html" | "json" | "markdown")[];
-    render_js: boolean;
+    formats: ("text" | "html" | "json" | "json_v2" | "markdown" | "rag")[];
+    render_js: boolean | "auto";
     use_proxy: boolean;
     include_raw_html: boolean;
+    scroll_to_load: boolean;
+    remove_cookie_banners: boolean;
     proxy_country?: string | undefined;
     wait_for?: string | undefined;
     session_id?: string | undefined;
     cookies?: Record<string, string> | undefined;
+    scroll_count?: number | undefined;
+    location?: {
+        country?: string | undefined;
+        language?: string | undefined;
+    } | undefined;
 }, {
     url: string;
     timeout?: number | undefined;
     mode?: "auto" | "html" | "js" | "pdf" | "ocr" | undefined;
-    formats?: ("text" | "html" | "json" | "markdown")[] | undefined;
-    render_js?: boolean | undefined;
+    formats?: ("text" | "html" | "json" | "json_v2" | "markdown" | "rag")[] | undefined;
+    render_js?: boolean | "auto" | undefined;
     use_proxy?: boolean | undefined;
     proxy_country?: string | undefined;
     wait_for?: string | undefined;
     include_raw_html?: boolean | undefined;
     session_id?: string | undefined;
     cookies?: Record<string, string> | undefined;
+    scroll_to_load?: boolean | undefined;
+    scroll_count?: number | undefined;
+    remove_cookie_banners?: boolean | undefined;
+    location?: {
+        country?: string | undefined;
+        language?: string | undefined;
+    } | undefined;
 }>;
 export declare const scrapeDescription: string;
 export declare function handleScrape(client: AlterLabClient, params: z.infer<typeof scrapeSchema>): Promise<CallToolResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/tools/scrape.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,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDvB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAMwD,CAAC;AAEvF,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,CA6BzB"}
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/tools/scrape.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,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqHvB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAW0B,CAAC;AAEzD,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,CAiCzB"}

package/dist/tools/scrape.js

@@ -12,17 +12,21 @@ exports.scrapeSchema = zod_1.z.object({
         .default("auto")
         .describe("Scraping mode: auto (recommended), html, js (headless browser), pdf, or ocr"),
     formats: zod_1.z
-        .array(zod_1.z.enum(["text", "json", "html", "markdown"]))
+        .array(zod_1.z.enum(["text", "json", "json_v2", "html", "markdown", "rag"]))
         .default(["markdown"])
-        .describe("Output formats. 'markdown' is best for LLM consumption"),
+        .describe("Output formats. 'markdown' is best for LLM consumption. " +
+        "'json_v2' returns a structured section tree (headings + content blocks). " +
+        "'rag' returns chunked text optimized for retrieval-augmented generation."),
     render_js: zod_1.z
-        .boolean()
+        .union([zod_1.z.boolean(), zod_1.z.literal("auto")])
         .default(false)
-        .describe("Render JavaScript using headless browser (+3 credits). Required for JS-heavy sites"),
+        .describe("Render JavaScript using headless browser (forces Tier 4 minimum — no separate add-on charge). " +
+        "Required for JS-heavy sites. Set to 'auto' for smart detection (probes each page, " +
+        "only renders JS-heavy pages with browser — saves 30-60% on mixed sites)."),
     use_proxy: zod_1.z
         .boolean()
         .default(false)
-        .describe("Route through premium proxy (+1 credit). Helps bypass geo-restrictions and anti-bot"),
+        .describe("Route through premium proxy (+$0.0002). Helps bypass geo-restrictions and anti-bot"),
     proxy_country: zod_1.z
         .string()
         .optional()
@@ -52,15 +56,56 @@ exports.scrapeSchema = zod_1.z.object({
         .record(zod_1.z.string(), zod_1.z.string())
         .optional()
         .describe("Inline cookies as key-value pairs for authenticated scraping " +
-        "(e.g., {\"session_token\": \"abc123\"}). " +
+        '(e.g., {"session_token": "abc123"}). ' +
         "Use this for one-off requests; use session_id for reusable sessions."),
+    scroll_to_load: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Scroll page to trigger lazy-loaded content (requires render_js). " +
+        "Performs explicit viewport-height scrolls to load dynamic content. Adds ~2-3s latency."),
+    scroll_count: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .default(3)
+        .optional()
+        .describe("Number of scroll iterations when scroll_to_load is enabled (1-10, default 3)"),
+    remove_cookie_banners: zod_1.z
+        .boolean()
+        .default(true)
+        .describe("Remove cookie consent banners from HTML before content extraction (free, enabled by default)"),
+    location: zod_1.z
+        .object({
+        country: zod_1.z
+            .string()
+            .length(2)
+            .optional()
+            .describe("ISO 3166-1 alpha-2 country code for geo-targeting (e.g., 'US', 'DE', 'JP'). " +
+            "Routes request through a proxy in the specified country."),
+        language: zod_1.z
+            .string()
+            .min(2)
+            .max(5)
+            .optional()
+            .describe("ISO 639-1 language code (e.g., 'en', 'de', 'ja'). " +
+            "Sets the Accept-Language header and browser locale."),
+    })
+        .optional()
+        .describe("Geo-targeting parameters for localized content scraping. " +
+        "Controls proxy country routing, Accept-Language header, and browser locale."),
 });
-exports.scrapeDescription = "Scrape a URL and return its content as markdown, text, HTML, or JSON. " +
+exports.scrapeDescription = "Scrape a URL and return its content as markdown, text, HTML, JSON, or structured sections. " +
     "Automatically handles anti-bot protection with tier escalation. " +
     "Returns markdown by default — optimized for LLM context. " +
     "Use render_js=true for JavaScript-heavy sites (React, Angular, SPAs). " +
+    "Use render_js='auto' for mixed sites to detect JS needs per-page (saves 30-60%). " +
     "Use use_proxy=true for geo-restricted or heavily protected sites. " +
-    "Supports authenticated scraping via session_id (stored session) or inline cookies.";
+    "Use formats=['json_v2'] for a structured section tree (headings + content blocks). " +
+    "Use formats=['rag'] for chunked text optimized for RAG pipelines. " +
+    "Supports authenticated scraping via session_id (stored session) or inline cookies. " +
+    "Use scroll_to_load=true for infinite-scroll pages that lazy-load content. " +
+    "Use location.country to scrape geo-targeted content.";
 async function handleScrape(client, params) {
     try {
         const response = await client.scrape({
@@ -73,11 +118,15 @@ async function handleScrape(client, params) {
             wait_for: params.wait_for,
             session_id: params.session_id,
             cookies: params.cookies,
+            location: params.location,
             advanced: {
                 render_js: params.render_js,
                 use_proxy: params.use_proxy,
                 proxy_country: params.proxy_country,
                 markdown: params.formats.includes("markdown"),
+                scroll_to_load: params.scroll_to_load,
+                scroll_count: params.scroll_count,
+                remove_cookie_banners: params.remove_cookie_banners,
             },
         });
         return {

package/dist/tools/scrape.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":";;;AAqEA,oCAgCC;AArGD,6BAAwB;AAGxB,4CAAgE;AAChE,4CAAoD;AAEvC,QAAA,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC/C,IAAI,EAAE,OAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;SAC1C,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,OAAO,EAAE,OAAC;SACP,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;SACnD,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;SACrB,QAAQ,CAAC,wDAAwD,CAAC;IACrE,SAAS,EAAE,OAAC;SACT,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,oFAAoF,CAAC;IACjG,SAAS,EAAE,OAAC;SACT,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,qFAAqF,CAAC;IAClG,aAAa,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,QAAQ,EAAE,OAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;IACzF,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oCAAoC,CAAC;IACjD,gBAAgB,EAAE,OAAC;SAChB,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,UAAU,EAAE,OAAC;SACV,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,uDAAuD;QACvD,yDAAyD;QACzD,0DAA0D,CAC3D;IACH,OAAO,EAAE,OAAC;SACP,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,QAAQ,EAAE;SACV,QAAQ,CACP,+DAA+D;QAC/D,2CAA2C;QAC3C,sEAAsE,CACvE;CACJ,CAAC,CAAC;AAEU,QAAA,iBAAiB,GAC5B,wEAAwE;IACxE,kEAAkE;IAClE,2DAA2D;IAC3D,wEAAwE;IACxE,oEAAoE;IACpE,oFAAoF,CAAC;AAEhF,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,MAAoC;IAEpC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACnC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE;gBACR,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;aAC9C;SACF,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAA,gCAAoB,EAAC,QAAQ,CAAC,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAA,6BAAiB,EAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAA,6BAAiB,EAAC,KAAc,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,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"}
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"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"}

package/dist/tools/search.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AlterLabClient } from "../client.js";
+export declare const searchSchema: z.ZodObject<{
+    query: z.ZodString;
+    num_results: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+    domain: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    time_range: z.ZodOptional<z.ZodEnum<["hour", "day", "week", "month", "year"]>>;
+    scrape_results: z.ZodDefault<z.ZodBoolean>;
+    formats: z.ZodOptional<z.ZodArray<z.ZodEnum<["text", "json", "json_v2", "html", "markdown"]>, "many">>;
+    extraction_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    num_results: number;
+    page: number;
+    scrape_results: boolean;
+    formats?: ("text" | "html" | "json" | "json_v2" | "markdown")[] | undefined;
+    country?: string | undefined;
+    language?: string | undefined;
+    extraction_schema?: Record<string, unknown> | undefined;
+    domain?: string | undefined;
+    time_range?: "hour" | "day" | "week" | "month" | "year" | undefined;
+}, {
+    query: string;
+    formats?: ("text" | "html" | "json" | "json_v2" | "markdown")[] | undefined;
+    country?: string | undefined;
+    language?: string | undefined;
+    extraction_schema?: Record<string, unknown> | undefined;
+    num_results?: number | undefined;
+    page?: number | undefined;
+    domain?: string | undefined;
+    time_range?: "hour" | "day" | "week" | "month" | "year" | undefined;
+    scrape_results?: boolean | undefined;
+}>;
+export declare const searchDescription: string;
+export declare function handleSearch(client: AlterLabClient, params: z.infer<typeof searchSchema>): Promise<CallToolResult>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.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;AAGnD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DvB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAOqC,CAAC;AAEpE,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,CAuBzB"}

package/dist/tools/search.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchDescription = exports.searchSchema = void 0;
+exports.handleSearch = handleSearch;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+exports.searchSchema = zod_1.z.object({
+    query: zod_1.z
+        .string()
+        .min(1)
+        .max(500)
+        .describe("Search query (max 500 characters)"),
+    num_results: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .default(10)
+        .describe("Number of results to return (1-30)"),
+    page: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .default(1)
+        .describe("Result page number (1-indexed). Page 2 returns results 11-20, etc."),
+    domain: zod_1.z
+        .string()
+        .optional()
+        .describe("Restrict results to a specific domain (applied as site: prefix, e.g. 'docs.example.com')"),
+    country: zod_1.z
+        .string()
+        .length(2)
+        .optional()
+        .describe("ISO 3166-1 alpha-2 country code for geo-targeted results (e.g., 'US', 'GB', 'DE')"),
+    language: zod_1.z
+        .string()
+        .min(2)
+        .max(5)
+        .optional()
+        .describe("Language code for results (e.g., 'en', 'fr', 'de')"),
+    time_range: zod_1.z
+        .enum(["hour", "day", "week", "month", "year"])
+        .optional()
+        .describe("Filter results by recency"),
+    scrape_results: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("If true, scrape each result page and include content in response. " +
+        "Each page is billed at its scraping tier cost in addition to the base search fee."),
+    formats: zod_1.z
+        .array(zod_1.z.enum(["text", "json", "json_v2", "html", "markdown"]))
+        .optional()
+        .describe("Output formats when scrape_results=true"),
+    extraction_schema: zod_1.z
+        .record(zod_1.z.unknown())
+        .optional()
+        .describe("JSON schema for structured extraction when scrape_results=true"),
+});
+exports.searchDescription = "Execute a web search and return SERP results (URLs, titles, snippets). " +
+    "Uses AlterLab's own SERP engine with Google/Bing/DuckDuckGo multi-engine failover. " +
+    "Costs $0.001 per search query. " +
+    "Set scrape_results=true to also scrape each result page and get full content — " +
+    "each page is billed at its normal scraping tier cost. " +
+    "Use domain to restrict results to a specific site (equivalent to site: operator). " +
+    "Use time_range to filter by recency (hour/day/week/month/year).";
+async function handleSearch(client, params) {
+    try {
+        const response = await client.search({
+            query: params.query,
+            num_results: params.num_results,
+            page: params.page,
+            domain: params.domain,
+            country: params.country,
+            language: params.language,
+            time_range: params.time_range,
+            scrape_results: params.scrape_results,
+            formats: params.formats,
+            extraction_schema: params.extraction_schema,
+        });
+        const text = formatSearchResponse(response, params.query);
+        return { content: [{ type: "text", text }] };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error, { url: params.query });
+        }
+        return (0, errors_js_1.formatErrorResult)(error, { url: params.query });
+    }
+}
+function formatSearchResponse(response, query) {
+    const resp = response;
+    const searchId = String(resp.search_id ?? "");
+    const results = Array.isArray(resp.results) ? resp.results : [];
+    const resultsCount = Number(resp.results_count ?? results.length);
+    const creditsUsed = Number(resp.credits_used ?? 0);
+    const costBreakdown = resp.cost_breakdown;
+    const parts = [
+        `**Search Results for: "${query}"**\n`,
+        `Found ${resultsCount} result${resultsCount !== 1 ? "s" : ""} | Search ID: \`${searchId}\`\n`,
+    ];
+    for (const result of results) {
+        const r = result;
+        const position = Number(r.position ?? 0);
+        const title = String(r.title ?? "Untitled");
+        const url = String(r.url ?? "");
+        const snippet = String(r.snippet ?? "");
+        const datePublished = r.date_published
+            ? ` (${String(r.date_published)})`
+            : "";
+        parts.push(`**${position}. ${title}**${datePublished}`);
+        parts.push(`${url}`);
+        parts.push(`${snippet}\n`);
+        // Include scraped content if available
+        const content = r.content;
+        if (content) {
+            const scrapeText = content.markdown ||
+                content.text;
+            if (scrapeText) {
+                const preview = scrapeText.slice(0, 500);
+                parts.push(`> ${preview}${scrapeText.length > 500 ? "..." : ""}\n`);
+            }
+        }
+    }
+    // Cost footer
+    parts.push("---");
+    if (costBreakdown) {
+        const total = Number(costBreakdown.total_microcents ?? 0);
+        parts.push(`Cost: $${(total / 1_000_000).toFixed(6)} | Credits: ${creditsUsed}`);
+    }
+    else {
+        parts.push(`Credits used: ${creditsUsed}`);
+    }
+    // Featured snippet, knowledge panel, PAA
+    const featuredSnippet = resp.featured_snippet;
+    if (featuredSnippet) {
+        parts.unshift(`**Featured Snippet**: ${String(featuredSnippet.content ?? "")}\n`);
+    }
+    return parts.join("\n");
+}
+function isApiError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "status" in error &&
+        typeof error.status === "number");
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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