mcpscraper-sdk 0.12.0 → 0.12.1

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 158-tool MCP surface. It includes 73 MCP Scraper tools and all 85 mirrored memory tools from `contracts/mcp.tools.json`.
+`client.tools` is the generated, typed 159-tool MCP surface. It includes 72 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, Zoom, Meta Marketing, or Resend pagination server-side and returns small results inline or a private seven-day JSONL artifact. 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.
 
+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`.
 
 Everything else is namespaced by product area, matching the OpenAPI spec's tags: `client.youtube`, `client.screenshot`, `client.facebook`, `client.googleAds`, `client.instagram`, `client.reddit`, `client.video`, `client.maps`, `client.directory`, `client.serpIntelligence`, `client.workflows`.
@@ -90,4 +92,4 @@ npm run generate
 
 ## See also
 
-[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 86-tool typed surface) · [`mcpscraper-sdk` Python source package](../scraper-python) · [`mcpscraper-cli`](../cli)
+[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 87-tool typed surface) · [`mcpscraper-sdk` Python source package](../scraper-python) · [`mcpscraper-cli`](../cli)

package/dist/index.d.cts

@@ -17,9 +17,9 @@ interface paths {
         put?: never;
         /**
          * Run a Google SERP search, or a full People-Also-Ask harvest
-         * @description Set `serpOnly: true` for a pure organic-results/SERP call (~0.1 credit). Omit or
+         * @description Set `serpOnly: true` for a pure organic-results/SERP call (1 credit). Omit or
          *     set `false` for a full People-Also-Ask harvest, which also returns SERP data
-         *     (~1 credit base + 0.2 credit per question actually returned; unused estimate is
+         *     (55 credit base + 3 credits per question actually returned; unused estimate is
          *     refunded). Runs synchronously and returns the result inline.
          */
         post: operations["harvestSync"];
@@ -108,7 +108,7 @@ interface paths {
         put?: never;
         /**
          * Extract a single page (markdown/HTML, headings, optional screenshot/branding/media)
-         * @description Costs 0.1 credit per page.
+         * @description Costs 1 credit per page.
          */
         post: operations["extractUrl"];
         delete?: never;
@@ -128,7 +128,7 @@ interface paths {
         put?: never;
         /**
          * Spider a site and return its discovered URL inventory
-         * @description Flat 0.5 credit per call, regardless of URL count discovered.
+         * @description Flat 5 credits per call, regardless of URL count discovered.
          */
         post: operations["mapSiteUrls"];
         delete?: never;
@@ -148,7 +148,7 @@ interface paths {
         put?: never;
         /**
          * Crawl and extract every page of a site (also serves audit_site)
-         * @description 0.1 credit per page crawled (estimated up front against `maxPages`, then
+         * @description 1 credit per page crawled (estimated up front against `maxPages`, then
          *     reconciled to the actual page count crawled; unused estimate refunded). Set
          *     `background: true` to enqueue an async crawl and poll
          *     `GET /extract-site/status/{id}` instead of waiting inline — recommended above a
@@ -189,7 +189,7 @@ interface paths {
         put?: never;
         /**
          * Search YouTube, or list a channel's videos
-         * @description Costs 0.2 credit per call.
+         * @description Costs 2 credits per call.
          */
         post: operations["youtubeHarvest"];
         delete?: never;
@@ -209,7 +209,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe a YouTube video's captions
-         * @description 0.2 credit per minute; a 5-minute hold is taken up front and reconciled to actual duration.
+         * @description 2 credits per minute; a 5-minute hold is taken up front and reconciled to actual duration.
          */
         post: operations["youtubeTranscribe"];
         delete?: never;
@@ -229,7 +229,7 @@ interface paths {
         put?: never;
         /**
          * Capture a full-page PNG screenshot of a URL
-         * @description Costs 0.1 credit. Returns the raw PNG bytes, not JSON.
+         * @description Costs 1 credit. Returns the raw PNG bytes, not JSON.
          */
         post: operations["screenshot"];
         delete?: never;
@@ -249,7 +249,7 @@ interface paths {
         put?: never;
         /**
          * Extract one Facebook Ad Library ad (all its variants) by URL or library ID
-         * @description Costs 0.2 credit.
+         * @description Costs 2 credits.
          */
         post: operations["facebookAd"];
         delete?: never;
@@ -269,7 +269,7 @@ interface paths {
         put?: never;
         /**
          * List an advertiser's active/recent ads by page ID, library ID, or search query
-         * @description Costs 0.2 credit.
+         * @description Costs 2 credits.
          */
         post: operations["facebookPageIntel"];
         delete?: never;
@@ -289,7 +289,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe a Facebook ad's video by direct video URL
-         * @description 0.2 credit per minute; a 5-minute hold is taken and reconciled to actual duration.
+         * @description 333 credits per minute (typical); a hold is taken and reconciled to actual duration and vendor cost.
          */
         post: operations["facebookAdTranscribe"];
         delete?: never;
@@ -309,7 +309,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe an organic Facebook video, reel, or share URL (not an ad)
-         * @description 0.2 credit per minute; a 5-minute hold is taken and reconciled to actual duration.
+         * @description 333 credits per minute (typical); a hold is taken and reconciled to actual duration and vendor cost.
          */
         post: operations["facebookVideoTranscribe"];
         delete?: never;
@@ -329,7 +329,7 @@ interface paths {
         put?: never;
         /**
          * Search the Facebook Ad Library by keyword and return matching advertisers
-         * @description Costs 0.6 credit.
+         * @description Costs 6 credits.
          */
         post: operations["facebookSearch"];
         delete?: never;
@@ -369,7 +369,7 @@ interface paths {
         put?: never;
         /**
          * Find advertisers in the Google Ads Transparency Center by keyword
-         * @description Costs 0.6 credit.
+         * @description Costs 6 credits.
          */
         post: operations["googleAdsSearch"];
         delete?: never;
@@ -389,7 +389,7 @@ interface paths {
         put?: never;
         /**
          * List one advertiser's creatives by advertiser ID or domain
-         * @description Costs 0.2 credit.
+         * @description Costs 2 credits.
          */
         post: operations["googleAdsPageIntel"];
         delete?: never;
@@ -409,7 +409,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe a Google ad's video by direct video URL
-         * @description 0.2 credit per minute; a 5-minute hold is taken and reconciled to actual duration.
+         * @description 333 credits per minute (typical); a hold is taken and reconciled to actual duration and vendor cost.
          */
         post: operations["googleAdsTranscribe"];
         delete?: never;
@@ -429,7 +429,7 @@ interface paths {
         put?: never;
         /**
          * List a public Instagram profile's grid content
-         * @description Costs 0.4 credit per profile scan. Provide `handle` or `url`.
+         * @description Costs 4 credits per profile scan. Provide `handle` or `url`.
          */
         post: operations["instagramProfileContent"];
         delete?: never;
@@ -449,7 +449,7 @@ interface paths {
         put?: never;
         /**
          * Extract and optionally download media from an Instagram post, reel, or tv URL
-         * @description Costs 0.4 credit; +0.05 credit if `includeTranscript` is used.
+         * @description Costs 4 credits per post or reel; when `includeTranscript` is used, transcription is typically 333 credits per minute and is reconciled to actual duration and vendor cost.
          */
         post: operations["instagramMediaDownload"];
         delete?: never;
@@ -469,7 +469,7 @@ interface paths {
         put?: never;
         /**
          * Capture a Reddit post and its comment tree
-         * @description Costs 2 credits. Refunded automatically if Reddit blocks the request after retries.
+         * @description Costs 30 credits for the thread plus 2 credits per comment actually returned. Refunded automatically if Reddit blocks the request after retries.
          */
         post: operations["redditThread"];
         delete?: never;
@@ -492,7 +492,7 @@ interface paths {
          * @description Full multi-lens breakdown: samples frames across a video (up to 30 minutes),
          *     analyzes each with vision AI, transcribes audio, then produces summary,
          *     pacing/energy, words-per-minute, topic outline, key points, hook analysis,
-         *     visual style, and a how-to-replicate recipe. ~0.667 credit per 120 frames
+         *     visual style, and a how-to-replicate recipe. 6,667 credits per 120 frames
          *     requested (max 480 frames); billed down automatically if the video can't use
          *     the requested frames, refunded fully if the run fails.
          */
@@ -531,7 +531,7 @@ interface paths {
         put?: never;
         /**
          * Search Google Maps for businesses matching a query and location
-         * @description Costs 0.5 credit. Returns up to 50 business/profile candidates.
+         * @description Costs 5 credits. Returns up to 50 business/profile candidates.
          */
         post: operations["mapsSearch"];
         delete?: never;
@@ -551,7 +551,7 @@ interface paths {
         put?: never;
         /**
          * Deep-dive one Google Maps business by name and location, with reviews
-         * @description 3 credits base; +0.1 credit per review card when `includeReviews` is true.
+         * @description 60 credits base; +1 credit per review card when `includeReviews` is true.
          */
         post: operations["mapsPlaceIntel"];
         delete?: never;
@@ -571,7 +571,7 @@ interface paths {
         put?: never;
         /**
          * Run Google Maps business search across many cities in a state/region at once
-         * @description Cost is `0.5 credit × number of markets resolved` for the query — see `GET /workflows/definitions` for related workflow shapes. Failed cities are refunded individually.
+         * @description Cost is `5 credits × number of markets resolved` for the query — see `GET /workflows/definitions` for related workflow shapes. Failed cities are refunded individually.
          */
         post: operations["directoryWorkflow"];
         delete?: never;
@@ -591,7 +591,7 @@ interface paths {
         put?: never;
         /**
          * Structured SERP capture with AI Overview/AI Mode detection, entity IDs, and location-match evidence
-         * @description Costs 0.1 credit. Rate-limited to 60 requests/minute per account.
+         * @description Costs 1 credit. Rate-limited to 60 requests/minute per account.
          */
         post: operations["serpIntelligenceCapture"];
         delete?: never;
@@ -611,7 +611,7 @@ interface paths {
         put?: never;
         /**
          * Fetch and archive full-content snapshots (HTML/text/markdown/screenshot) of specific URLs
-         * @description Costs 0.1 credit per URL (max 25 per call). Rate-limited to 60 requests/minute per account.
+         * @description Costs 1 credit per URL (max 25 per call). Rate-limited to 60 requests/minute per account.
          */
         post: operations["serpIntelligencePageSnapshots"];
         delete?: never;
@@ -786,7 +786,7 @@ interface paths {
         put?: never;
         /**
          * Call one memory.mcpscraper.dev tool by name, using this account's mcpscraper.dev API key
-         * @description Generic dispatch: names one of the 86 tools documented in this repo's
+         * @description Generic dispatch: names one of the 87 tools documented in this repo's
          *     `contracts/memory.tools.json` and forwards `args` to it, using a memory identity
          *     auto-provisioned for the calling mcpscraper.dev account. The response shape depends
          *     entirely on which tool was called — see that tool's `outputSchema` in the manifest.

package/dist/index.d.ts

@@ -17,9 +17,9 @@ interface paths {
         put?: never;
         /**
          * Run a Google SERP search, or a full People-Also-Ask harvest
-         * @description Set `serpOnly: true` for a pure organic-results/SERP call (~0.1 credit). Omit or
+         * @description Set `serpOnly: true` for a pure organic-results/SERP call (1 credit). Omit or
          *     set `false` for a full People-Also-Ask harvest, which also returns SERP data
-         *     (~1 credit base + 0.2 credit per question actually returned; unused estimate is
+         *     (55 credit base + 3 credits per question actually returned; unused estimate is
          *     refunded). Runs synchronously and returns the result inline.
          */
         post: operations["harvestSync"];
@@ -108,7 +108,7 @@ interface paths {
         put?: never;
         /**
          * Extract a single page (markdown/HTML, headings, optional screenshot/branding/media)
-         * @description Costs 0.1 credit per page.
+         * @description Costs 1 credit per page.
          */
         post: operations["extractUrl"];
         delete?: never;
@@ -128,7 +128,7 @@ interface paths {
         put?: never;
         /**
          * Spider a site and return its discovered URL inventory
-         * @description Flat 0.5 credit per call, regardless of URL count discovered.
+         * @description Flat 5 credits per call, regardless of URL count discovered.
          */
         post: operations["mapSiteUrls"];
         delete?: never;
@@ -148,7 +148,7 @@ interface paths {
         put?: never;
         /**
          * Crawl and extract every page of a site (also serves audit_site)
-         * @description 0.1 credit per page crawled (estimated up front against `maxPages`, then
+         * @description 1 credit per page crawled (estimated up front against `maxPages`, then
          *     reconciled to the actual page count crawled; unused estimate refunded). Set
          *     `background: true` to enqueue an async crawl and poll
          *     `GET /extract-site/status/{id}` instead of waiting inline — recommended above a
@@ -189,7 +189,7 @@ interface paths {
         put?: never;
         /**
          * Search YouTube, or list a channel's videos
-         * @description Costs 0.2 credit per call.
+         * @description Costs 2 credits per call.
          */
         post: operations["youtubeHarvest"];
         delete?: never;
@@ -209,7 +209,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe a YouTube video's captions
-         * @description 0.2 credit per minute; a 5-minute hold is taken up front and reconciled to actual duration.
+         * @description 2 credits per minute; a 5-minute hold is taken up front and reconciled to actual duration.
          */
         post: operations["youtubeTranscribe"];
         delete?: never;
@@ -229,7 +229,7 @@ interface paths {
         put?: never;
         /**
          * Capture a full-page PNG screenshot of a URL
-         * @description Costs 0.1 credit. Returns the raw PNG bytes, not JSON.
+         * @description Costs 1 credit. Returns the raw PNG bytes, not JSON.
          */
         post: operations["screenshot"];
         delete?: never;
@@ -249,7 +249,7 @@ interface paths {
         put?: never;
         /**
          * Extract one Facebook Ad Library ad (all its variants) by URL or library ID
-         * @description Costs 0.2 credit.
+         * @description Costs 2 credits.
          */
         post: operations["facebookAd"];
         delete?: never;
@@ -269,7 +269,7 @@ interface paths {
         put?: never;
         /**
          * List an advertiser's active/recent ads by page ID, library ID, or search query
-         * @description Costs 0.2 credit.
+         * @description Costs 2 credits.
          */
         post: operations["facebookPageIntel"];
         delete?: never;
@@ -289,7 +289,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe a Facebook ad's video by direct video URL
-         * @description 0.2 credit per minute; a 5-minute hold is taken and reconciled to actual duration.
+         * @description 333 credits per minute (typical); a hold is taken and reconciled to actual duration and vendor cost.
          */
         post: operations["facebookAdTranscribe"];
         delete?: never;
@@ -309,7 +309,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe an organic Facebook video, reel, or share URL (not an ad)
-         * @description 0.2 credit per minute; a 5-minute hold is taken and reconciled to actual duration.
+         * @description 333 credits per minute (typical); a hold is taken and reconciled to actual duration and vendor cost.
          */
         post: operations["facebookVideoTranscribe"];
         delete?: never;
@@ -329,7 +329,7 @@ interface paths {
         put?: never;
         /**
          * Search the Facebook Ad Library by keyword and return matching advertisers
-         * @description Costs 0.6 credit.
+         * @description Costs 6 credits.
          */
         post: operations["facebookSearch"];
         delete?: never;
@@ -369,7 +369,7 @@ interface paths {
         put?: never;
         /**
          * Find advertisers in the Google Ads Transparency Center by keyword
-         * @description Costs 0.6 credit.
+         * @description Costs 6 credits.
          */
         post: operations["googleAdsSearch"];
         delete?: never;
@@ -389,7 +389,7 @@ interface paths {
         put?: never;
         /**
          * List one advertiser's creatives by advertiser ID or domain
-         * @description Costs 0.2 credit.
+         * @description Costs 2 credits.
          */
         post: operations["googleAdsPageIntel"];
         delete?: never;
@@ -409,7 +409,7 @@ interface paths {
         put?: never;
         /**
          * Transcribe a Google ad's video by direct video URL
-         * @description 0.2 credit per minute; a 5-minute hold is taken and reconciled to actual duration.
+         * @description 333 credits per minute (typical); a hold is taken and reconciled to actual duration and vendor cost.
          */
         post: operations["googleAdsTranscribe"];
         delete?: never;
@@ -429,7 +429,7 @@ interface paths {
         put?: never;
         /**
          * List a public Instagram profile's grid content
-         * @description Costs 0.4 credit per profile scan. Provide `handle` or `url`.
+         * @description Costs 4 credits per profile scan. Provide `handle` or `url`.
          */
         post: operations["instagramProfileContent"];
         delete?: never;
@@ -449,7 +449,7 @@ interface paths {
         put?: never;
         /**
          * Extract and optionally download media from an Instagram post, reel, or tv URL
-         * @description Costs 0.4 credit; +0.05 credit if `includeTranscript` is used.
+         * @description Costs 4 credits per post or reel; when `includeTranscript` is used, transcription is typically 333 credits per minute and is reconciled to actual duration and vendor cost.
          */
         post: operations["instagramMediaDownload"];
         delete?: never;
@@ -469,7 +469,7 @@ interface paths {
         put?: never;
         /**
          * Capture a Reddit post and its comment tree
-         * @description Costs 2 credits. Refunded automatically if Reddit blocks the request after retries.
+         * @description Costs 30 credits for the thread plus 2 credits per comment actually returned. Refunded automatically if Reddit blocks the request after retries.
          */
         post: operations["redditThread"];
         delete?: never;
@@ -492,7 +492,7 @@ interface paths {
          * @description Full multi-lens breakdown: samples frames across a video (up to 30 minutes),
          *     analyzes each with vision AI, transcribes audio, then produces summary,
          *     pacing/energy, words-per-minute, topic outline, key points, hook analysis,
-         *     visual style, and a how-to-replicate recipe. ~0.667 credit per 120 frames
+         *     visual style, and a how-to-replicate recipe. 6,667 credits per 120 frames
          *     requested (max 480 frames); billed down automatically if the video can't use
          *     the requested frames, refunded fully if the run fails.
          */
@@ -531,7 +531,7 @@ interface paths {
         put?: never;
         /**
          * Search Google Maps for businesses matching a query and location
-         * @description Costs 0.5 credit. Returns up to 50 business/profile candidates.
+         * @description Costs 5 credits. Returns up to 50 business/profile candidates.
          */
         post: operations["mapsSearch"];
         delete?: never;
@@ -551,7 +551,7 @@ interface paths {
         put?: never;
         /**
          * Deep-dive one Google Maps business by name and location, with reviews
-         * @description 3 credits base; +0.1 credit per review card when `includeReviews` is true.
+         * @description 60 credits base; +1 credit per review card when `includeReviews` is true.
          */
         post: operations["mapsPlaceIntel"];
         delete?: never;
@@ -571,7 +571,7 @@ interface paths {
         put?: never;
         /**
          * Run Google Maps business search across many cities in a state/region at once
-         * @description Cost is `0.5 credit × number of markets resolved` for the query — see `GET /workflows/definitions` for related workflow shapes. Failed cities are refunded individually.
+         * @description Cost is `5 credits × number of markets resolved` for the query — see `GET /workflows/definitions` for related workflow shapes. Failed cities are refunded individually.
          */
         post: operations["directoryWorkflow"];
         delete?: never;
@@ -591,7 +591,7 @@ interface paths {
         put?: never;
         /**
          * Structured SERP capture with AI Overview/AI Mode detection, entity IDs, and location-match evidence
-         * @description Costs 0.1 credit. Rate-limited to 60 requests/minute per account.
+         * @description Costs 1 credit. Rate-limited to 60 requests/minute per account.
          */
         post: operations["serpIntelligenceCapture"];
         delete?: never;
@@ -611,7 +611,7 @@ interface paths {
         put?: never;
         /**
          * Fetch and archive full-content snapshots (HTML/text/markdown/screenshot) of specific URLs
-         * @description Costs 0.1 credit per URL (max 25 per call). Rate-limited to 60 requests/minute per account.
+         * @description Costs 1 credit per URL (max 25 per call). Rate-limited to 60 requests/minute per account.
          */
         post: operations["serpIntelligencePageSnapshots"];
         delete?: never;
@@ -786,7 +786,7 @@ interface paths {
         put?: never;
         /**
          * Call one memory.mcpscraper.dev tool by name, using this account's mcpscraper.dev API key
-         * @description Generic dispatch: names one of the 86 tools documented in this repo's
+         * @description Generic dispatch: names one of the 87 tools documented in this repo's
          *     `contracts/memory.tools.json` and forwards `args` to it, using a memory identity
          *     auto-provisioned for the calling mcpscraper.dev account. The response shape depends
          *     entirely on which tool was called — see that tool's `outputSchema` in the manifest.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Official Node.js client for all 159 mcpscraper.dev MCP tools and the REST API",
   "license": "MIT",
   "type": "module",
@@ -31,7 +31,7 @@
     "seo-api"
   ],
   "dependencies": {
-    "mcpscraper-memory-sdk": "^0.11.1"
+    "mcpscraper-memory-sdk": "^0.11.2"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"