mcpscraper-sdk 0.14.0 → 0.15.0

package/README.md

@@ -40,7 +40,7 @@ Every non-2xx response throws a `ScraperApiError` with `status`, `code`, and the
 
 ## API surface
 
-`client.tools` is the generated, typed 160-tool MCP surface. It includes 73 MCP Scraper tools and all 87 mirrored memory tools from `contracts/mcp.tools.json`.
+`client.tools` is the generated, typed 163-tool MCP surface. It includes 76 MCP Scraper tools and all 87 mirrored memory tools from `contracts/mcp.tools.json`.
 
 For multimodal results such as `meta_ad_creative_media`, call `client.tools.callToolResult(...)` to preserve native MCP image/audio/resource blocks. `callTool(...)` remains backward-compatible and returns the parsed structured or text value.
 
@@ -56,6 +56,8 @@ await client.tools.connections.exportConnectedServiceData({
 
 The connected-data export performs bounded Gmail, Calendar, Google Search Console, Zoom, Meta Marketing, or Resend pagination server-side and returns small results inline or a private seven-day JSONL artifact. Use `exportConnectedServiceData({ dataset: 'search_console_performance' })` for a fresh Search Console API extract. A scheduled `connection_sync` maintains a typed `gsc_performance_*` table exposed as `listServiceConnections().tableName`; use `exportSearchConsoleTableData` for a server-filtered download from that persisted table. Use `meta_ads_insights` for daily account, campaign, ad-set, and ad reporting across connected Meta ad accounts. Resend can aggregate sent/received mail, logs, contacts, broadcasts, and templates with `resend_data`. Resume partial exports with the returned `continuation` object; renew an expired signed URL with `client.tools.connections.renewConnectedDataDownload({ artifactId })`. Use `listServiceConnections` for verified grants and per-tool permission blockers, then `describeServiceConnectionTool` for the exact provider-native schema before calling through the generic connection bridges.
 
+Search Console also provides six API-only batches through those connection bridges: reads `inspect-urls` and `query-search-analytics-batch`, and gated actions `add-sites-batch`, `submit-sitemaps-batch`, `delete-sites-batch`, and `delete-sitemaps-batch`. They require no database, return per-item receipts, and can be bound to scheduled agent runs. Delete batches default to dry-run and require the live schema's exact confirmation token for execution; all actions require the connection's action switch.
+
 Integrations are included with an active Starter plan or higher: OAuth connect/reconnect and direct connected-service reads, approved actions, exports, and snapshots do not currently have an extra connection-operation debit. Scheduled Actions use the shared Credit balance at 75 Credits per started occurrence; agent-mode runs also add 1.5 times OpenRouter's actual reported model cost. Inspect the live policy with `await client.tools.schedule.getScheduleStatus()`.
 
 Core operations are flat on the client: `searchSerp`, `harvestPaa`, `extractUrl`, `mapSiteUrls`, `extractSite`, `auditSite`, `getExtractSiteStatus`, `listJobs`, `getJob`, `getHistory`, `getLedger`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.14.0",
-  "description": "Official Node.js client for all 160 mcpscraper.dev MCP tools and the REST API",
+  "version": "0.15.0",
+  "description": "Official Node.js client for all 163 mcpscraper.dev MCP tools and the REST API",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -31,7 +31,7 @@
     "seo-api"
   ],
   "dependencies": {
-    "mcpscraper-memory-sdk": "^0.13.0"
+    "mcpscraper-memory-sdk": "^0.14.0"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"

package/dist/index.cjs

@@ -1,411 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  GeneratedMcpToolsClient: () => import_mcpscraper_memory_sdk2.GeneratedMcpToolsClient,
-  MCP_TOOL_BINDINGS: () => import_mcpscraper_memory_sdk2.MCP_TOOL_BINDINGS,
-  MCP_TOOL_COUNT: () => import_mcpscraper_memory_sdk2.MCP_TOOL_COUNT,
-  McpToolError: () => import_mcpscraper_memory_sdk2.McpToolError,
-  McpToolsClient: () => import_mcpscraper_memory_sdk2.McpToolsClient,
-  ScraperApiError: () => ScraperApiError,
-  ScraperClient: () => ScraperClient
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/errors.ts
-function readString(body, key) {
-  if (body && typeof body === "object" && key in body) {
-    const value = body[key];
-    if (typeof value === "string") return value;
-  }
-  return void 0;
-}
-var ScraperApiError = class extends Error {
-  status;
-  code;
-  body;
-  constructor(status, body) {
-    super(readString(body, "message") ?? `mcpscraper.dev API request failed with status ${status}`);
-    this.name = "ScraperApiError";
-    this.status = status;
-    this.code = readString(body, "error_code") ?? readString(body, "error");
-    this.body = body;
-  }
-  isInsufficientBalance() {
-    return this.code === "insufficient_balance";
-  }
-  isConcurrencyLimitExceeded() {
-    return this.code === "concurrency_limit_exceeded";
-  }
-  isStructuredError() {
-    return typeof readString(this.body, "error_type") === "string";
-  }
-};
-
-// src/client.ts
-var import_mcpscraper_memory_sdk = require("mcpscraper-memory-sdk");
-var Requester = class {
-  constructor(apiKey, baseUrl, fetchImpl) {
-    this.apiKey = apiKey;
-    this.baseUrl = baseUrl;
-    this.fetchImpl = fetchImpl;
-  }
-  apiKey;
-  baseUrl;
-  fetchImpl;
-  async call(method, path, body, extraHeaders = {}) {
-    return (await this.callWithReceipt(method, path, body, extraHeaders)).data;
-  }
-  async callWithReceipt(method, path, body, extraHeaders = {}) {
-    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
-      method,
-      headers: {
-        "x-api-key": this.apiKey,
-        ...body !== void 0 ? { "content-type": "application/json" } : {},
-        ...extraHeaders
-      },
-      body: body !== void 0 ? JSON.stringify(body) : void 0
-    });
-    const data = await res.json().catch(() => void 0);
-    if (!res.ok) throw new ScraperApiError(res.status, data);
-    return { data, headers: res.headers };
-  }
-  async callRaw(method, path) {
-    const res = await this.fetchImpl(`${this.baseUrl}${path}`, { method, headers: { "x-api-key": this.apiKey } });
-    if (!res.ok) {
-      const data = await res.json().catch(() => void 0);
-      throw new ScraperApiError(res.status, data);
-    }
-    return res.arrayBuffer();
-  }
-};
-var YoutubeNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  harvest(params) {
-    return this.r.call("POST", "/youtube/harvest", params);
-  }
-  transcribe(params) {
-    return this.r.call("POST", "/youtube/transcribe", params);
-  }
-};
-var ScreenshotNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  capture(params) {
-    return this.r.call("POST", "/screenshot", params);
-  }
-};
-var FacebookNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  ad(params) {
-    return this.r.call("POST", "/facebook/ad", params);
-  }
-  pageIntel(params) {
-    return this.r.call("POST", "/facebook/page-intel", params);
-  }
-  adTranscribe(params) {
-    return this.r.call("POST", "/facebook/transcribe", params);
-  }
-  videoTranscribe(params) {
-    return this.r.call("POST", "/facebook/video-transcribe", params);
-  }
-  search(params) {
-    return this.r.call("POST", "/facebook/search", params);
-  }
-  media(params) {
-    return this.r.call("POST", "/facebook/media", params);
-  }
-};
-var GoogleAdsNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  search(params) {
-    return this.r.call("POST", "/google-ads/search", params);
-  }
-  pageIntel(params) {
-    return this.r.call("POST", "/google-ads/page-intel", params);
-  }
-  transcribe(params) {
-    return this.r.call("POST", "/google-ads/transcribe", params);
-  }
-};
-var InstagramNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  profileContent(params) {
-    return this.r.call("POST", "/instagram/profile-content", params);
-  }
-  mediaDownload(params) {
-    return this.r.call("POST", "/instagram/media-download", params);
-  }
-};
-var RedditNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  thread(params) {
-    return this.r.call("POST", "/reddit/thread", params);
-  }
-};
-var VideoNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  analyze(params) {
-    return this.r.call("POST", "/video/analyze", params);
-  }
-  status(params) {
-    return this.r.call("POST", "/video/status", params);
-  }
-};
-var MapsNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  search(params) {
-    return this.r.call("POST", "/maps/search", params);
-  }
-  place(params) {
-    return this.r.call("POST", "/maps/place", params);
-  }
-};
-var DirectoryNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  run(params) {
-    return this.r.call("POST", "/directory/run", params);
-  }
-};
-var SerpIntelligenceNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  capture(params, options = {}) {
-    return this.r.call(
-      "POST",
-      "/serp-intelligence/capture",
-      params,
-      options.idempotencyKey === void 0 ? {} : { "Idempotency-Key": options.idempotencyKey }
-    );
-  }
-  async captureWithReceipt(params, options = {}) {
-    const result = await this.r.callWithReceipt(
-      "POST",
-      "/serp-intelligence/capture",
-      params,
-      options.idempotencyKey === void 0 ? {} : { "Idempotency-Key": options.idempotencyKey }
-    );
-    return {
-      data: result.data,
-      idempotencyKey: result.headers.get("Idempotency-Key")
-    };
-  }
-  pageSnapshots(params) {
-    return this.r.call("POST", "/serp-intelligence/page-snapshots", params);
-  }
-};
-var WorkflowsNamespace = class {
-  constructor(r) {
-    this.r = r;
-  }
-  r;
-  listDefinitions() {
-    return this.r.call("GET", "/workflows/definitions");
-  }
-  run(params) {
-    return this.r.call("POST", "/workflows/run", params);
-  }
-  advanceStep(id) {
-    return this.r.call("POST", `/workflows/runs/${encodeURIComponent(id)}/step`);
-  }
-  listRuns() {
-    return this.r.call("GET", "/workflows/runs");
-  }
-  getRun(id) {
-    return this.r.call("GET", `/workflows/runs/${encodeURIComponent(id)}`);
-  }
-  getRunArtifact(id, artifactId) {
-    return this.r.callRaw(
-      "GET",
-      `/workflows/runs/${encodeURIComponent(id)}/artifacts/${encodeURIComponent(artifactId)}`
-    );
-  }
-  createSchedule(params) {
-    return this.r.call("POST", "/workflows/schedules", params);
-  }
-  listSchedules() {
-    return this.r.call("GET", "/workflows/schedules");
-  }
-  patchSchedule(id, params) {
-    return this.r.call("PATCH", `/workflows/schedules/${encodeURIComponent(id)}`, params);
-  }
-  deleteSchedule(id) {
-    return this.r.call("DELETE", `/workflows/schedules/${encodeURIComponent(id)}`);
-  }
-  runScheduleNow(id) {
-    return this.r.call("POST", `/workflows/schedules/${encodeURIComponent(id)}/run`);
-  }
-};
-var MemoryTools = class {
-  access;
-  capture;
-  channels;
-  facts;
-  graph;
-  library;
-  memory;
-  recall;
-  schedule;
-  storage;
-  tables;
-  tags;
-  vaults;
-  video;
-  webhooks;
-  constructor(callTool) {
-    this.access = new import_mcpscraper_memory_sdk.AccessNamespace(callTool);
-    this.capture = new import_mcpscraper_memory_sdk.CaptureNamespace(callTool);
-    this.channels = new import_mcpscraper_memory_sdk.ChannelsNamespace(callTool);
-    this.facts = new import_mcpscraper_memory_sdk.FactsNamespace(callTool);
-    this.graph = new import_mcpscraper_memory_sdk.GraphNamespace(callTool);
-    this.library = new import_mcpscraper_memory_sdk.LibraryNamespace(callTool);
-    this.memory = new import_mcpscraper_memory_sdk.MemoryNamespace(callTool);
-    this.recall = new import_mcpscraper_memory_sdk.RecallNamespace(callTool);
-    this.schedule = new import_mcpscraper_memory_sdk.ScheduleNamespace(callTool);
-    this.storage = new import_mcpscraper_memory_sdk.StorageNamespace(callTool);
-    this.tables = new import_mcpscraper_memory_sdk.TablesNamespace(callTool);
-    this.tags = new import_mcpscraper_memory_sdk.TagsNamespace(callTool);
-    this.vaults = new import_mcpscraper_memory_sdk.VaultsNamespace(callTool);
-    this.video = new import_mcpscraper_memory_sdk.VideoNamespace(callTool);
-    this.webhooks = new import_mcpscraper_memory_sdk.WebhooksNamespace(callTool);
-  }
-};
-var ScraperClient = class {
-  r;
-  youtube;
-  screenshot;
-  facebook;
-  googleAds;
-  instagram;
-  reddit;
-  video;
-  maps;
-  directory;
-  serpIntelligence;
-  workflows;
-  memoryTools;
-  tools;
-  constructor(options) {
-    this.r = new Requester(options.apiKey, options.baseUrl ?? "https://mcpscraper.dev", options.fetch ?? globalThis.fetch);
-    this.youtube = new YoutubeNamespace(this.r);
-    this.screenshot = new ScreenshotNamespace(this.r);
-    this.facebook = new FacebookNamespace(this.r);
-    this.googleAds = new GoogleAdsNamespace(this.r);
-    this.instagram = new InstagramNamespace(this.r);
-    this.reddit = new RedditNamespace(this.r);
-    this.video = new VideoNamespace(this.r);
-    this.maps = new MapsNamespace(this.r);
-    this.directory = new DirectoryNamespace(this.r);
-    this.serpIntelligence = new SerpIntelligenceNamespace(this.r);
-    this.workflows = new WorkflowsNamespace(this.r);
-    this.memoryTools = new MemoryTools(this.callMemoryTool.bind(this));
-    this.tools = new import_mcpscraper_memory_sdk.McpToolsClient({
-      apiKey: options.apiKey,
-      baseUrl: options.baseUrl ?? "https://mcpscraper.dev",
-      fetch: options.fetch
-    });
-  }
-  async callMemoryTool(toolName, args) {
-    const result = await this.r.call("POST", "/memory/mcp-call", {
-      toolName,
-      args: args ?? {}
-    });
-    if (result && typeof result === "object" && result.ok === false) {
-      const failure = result;
-      throw new ScraperApiError(200, { message: failure.error, ...failure });
-    }
-    return result;
-  }
-  searchSerp(params) {
-    return this.r.call("POST", "/harvest/sync", { ...params, serpOnly: true });
-  }
-  harvestPaa(params) {
-    return this.r.call("POST", "/harvest/sync", params);
-  }
-  extractUrl(params) {
-    return this.r.call("POST", "/extract-url", params);
-  }
-  mapSiteUrls(params) {
-    return this.r.call("POST", "/map-urls", params);
-  }
-  extractSite(params) {
-    return this.r.call("POST", "/extract-site", params);
-  }
-  auditSite(params) {
-    return this.extractSite(params);
-  }
-  getExtractSiteStatus(id) {
-    return this.r.call("GET", `/extract-site/status/${encodeURIComponent(id)}`);
-  }
-  listJobs() {
-    return this.r.call("GET", "/jobs");
-  }
-  getJob(id) {
-    return this.r.call("GET", `/jobs/${encodeURIComponent(id)}`);
-  }
-  getHistory() {
-    return this.r.call("GET", "/history");
-  }
-  getLedger() {
-    return this.r.call("GET", "/ledger");
-  }
-};
-
-// src/index.ts
-var import_mcpscraper_memory_sdk2 = require("mcpscraper-memory-sdk");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  GeneratedMcpToolsClient,
-  MCP_TOOL_BINDINGS,
-  MCP_TOOL_COUNT,
-  McpToolError,
-  McpToolsClient,
-  ScraperApiError,
-  ScraperClient
-});