mcpscraper-sdk 0.10.0 → 0.12.0

package/README.md

@@ -40,7 +40,9 @@ Every non-2xx response throws a `ScraperApiError` with `status`, `code`, and the
 
 ## API surface
 
-`client.tools` is the generated, typed 157-tool MCP surface. It includes 72 MCP Scraper tools and all 85 mirrored memory tools from `contracts/mcp.tools.json`.
+`client.tools` is the generated, typed 158-tool MCP surface. It includes 73 MCP Scraper tools and all 85 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.
 
 ```ts
 await client.tools.search.searchSerp({ query: 'roof repair Denver' })

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { AccessNamespace, CaptureNamespace, ChannelsNamespace, FactsNamespace, GraphNamespace, LibraryNamespace, MemoryNamespace, RecallNamespace, ScheduleNamespace, StorageNamespace, TablesNamespace, TagsNamespace, VaultsNamespace, VideoNamespace as VideoNamespace$1, WebhooksNamespace, CallToolFn, McpToolsClient } from 'mcpscraper-memory-sdk';
-export { GeneratedMcpToolsClient, MCP_TOOL_BINDINGS, MCP_TOOL_COUNT, McpToolDescriptor, McpToolError, McpToolErrorDetails, McpToolsClient, McpToolsClientOptions } from 'mcpscraper-memory-sdk';
+export { GeneratedMcpToolsClient, MCP_TOOL_BINDINGS, MCP_TOOL_COUNT, McpContentBlock, McpToolCallResult, McpToolDescriptor, McpToolError, McpToolErrorDetails, McpToolsClient, McpToolsClientOptions } from 'mcpscraper-memory-sdk';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -1027,6 +1027,11 @@ interface components {
              * @default false
              */
             background: boolean;
+            /**
+             * @description Download every discovered image as a real file into the background job's bundle.zip (under images/<page>/), not just image URLs/stats. OFF by default. Implies background regardless of the background flag — too slow to run inline. Capped at 20 images/page and 500 images/site.
+             * @default false
+             */
+            downloadImages: boolean;
             /** @default false */
             rotateProxies: boolean;
             /** @default 30 */
@@ -1170,7 +1175,10 @@ interface components {
             /**
              * @description Produced files (name + MIME type). When the job requested formats including
              *     `issues`, this includes `seo-audit.json` (application/json — the same object as
-             *     the synchronous `seoAudit`), and rows in `pages.jsonl` include `inSitemap`.
+             *     the synchronous `seoAudit`), and rows in `pages.jsonl` include `inSitemap`. The
+             *     `bundle.zip` entry is the full downloadable export — page Markdown under `pages/`,
+             *     plus (when `downloadImages` was set) real image files under `images/<page>/` and an
+             *     `images-download-summary.json` entry reporting queued/downloaded/failed counts.
              */
             artifacts?: {
                 [key: string]: unknown;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AccessNamespace, CaptureNamespace, ChannelsNamespace, FactsNamespace, GraphNamespace, LibraryNamespace, MemoryNamespace, RecallNamespace, ScheduleNamespace, StorageNamespace, TablesNamespace, TagsNamespace, VaultsNamespace, VideoNamespace as VideoNamespace$1, WebhooksNamespace, CallToolFn, McpToolsClient } from 'mcpscraper-memory-sdk';
-export { GeneratedMcpToolsClient, MCP_TOOL_BINDINGS, MCP_TOOL_COUNT, McpToolDescriptor, McpToolError, McpToolErrorDetails, McpToolsClient, McpToolsClientOptions } from 'mcpscraper-memory-sdk';
+export { GeneratedMcpToolsClient, MCP_TOOL_BINDINGS, MCP_TOOL_COUNT, McpContentBlock, McpToolCallResult, McpToolDescriptor, McpToolError, McpToolErrorDetails, McpToolsClient, McpToolsClientOptions } from 'mcpscraper-memory-sdk';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -1027,6 +1027,11 @@ interface components {
              * @default false
              */
             background: boolean;
+            /**
+             * @description Download every discovered image as a real file into the background job's bundle.zip (under images/<page>/), not just image URLs/stats. OFF by default. Implies background regardless of the background flag — too slow to run inline. Capped at 20 images/page and 500 images/site.
+             * @default false
+             */
+            downloadImages: boolean;
             /** @default false */
             rotateProxies: boolean;
             /** @default 30 */
@@ -1170,7 +1175,10 @@ interface components {
             /**
              * @description Produced files (name + MIME type). When the job requested formats including
              *     `issues`, this includes `seo-audit.json` (application/json — the same object as
-             *     the synchronous `seoAudit`), and rows in `pages.jsonl` include `inSitemap`.
+             *     the synchronous `seoAudit`), and rows in `pages.jsonl` include `inSitemap`. The
+             *     `bundle.zip` entry is the full downloadable export — page Markdown under `pages/`,
+             *     plus (when `downloadImages` was set) real image files under `images/<page>/` and an
+             *     `images-download-summary.json` entry reporting queued/downloaded/failed counts.
              */
             artifacts?: {
                 [key: string]: unknown;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.10.0",
-  "description": "Official Node.js client for all 157 mcpscraper.dev MCP tools and the REST API",
+  "version": "0.12.0",
+  "description": "Official Node.js client for all 159 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.9.0"
+    "mcpscraper-memory-sdk": "^0.11.1"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"