mcp-scraper 0.72.7 → 0.73.0

package/dist/{chunk-FVL4GUTP.js → chunk-EQJRPDUS.js}

@@ -213,8 +213,8 @@ var PUBLIC_PRODUCT_CONTRACT = {
     "freeSignupCredits": 0
   },
   "inventory": {
-    "totalTools": 330,
-    "scraperTools": 229,
+    "totalTools": 331,
+    "scraperTools": 230,
     "memoryTools": 101
   },
   "concurrencyPack": {

package/dist/{chunk-RRZAYUEX.js → chunk-JIWGG7Z4.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var PACKAGE_VERSION = "0.72.7";
+var PACKAGE_VERSION = "0.73.0";
 
 export {
   PACKAGE_VERSION

package/dist/{chunk-ZSVXNLLM.js → chunk-KRIIVDV2.js}

@@ -32,7 +32,7 @@ import {
 } from "./chunk-VXLU74YZ.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-RRZAYUEX.js";
+} from "./chunk-JIWGG7Z4.js";
 import {
   createPrivateArtifact,
   privateArtifactOwnerId,
@@ -45,7 +45,7 @@ import {
   PAA_QUESTION_CREDITS,
   PAGE_SCRAPE_CREDITS,
   SERP_SEARCH_CREDITS
-} from "./chunk-FVL4GUTP.js";
+} from "./chunk-EQJRPDUS.js";
 import {
   PUBLIC_ERROR_CODES,
   buildPublicErrorEnvelope,
@@ -12326,9 +12326,17 @@ var AnalyticsExplorerInputSchema = {
   maximumDurationMs: z11.number().int().min(0).max(31536e6).optional().describe("Maximum measured session duration in milliseconds."),
   journeyTier: z11.enum(["confirmed", "best_guess", "all"]).default("confirmed").describe("Confirmed is the default. Best-guess totals remain separate and cannot drive CRM or advertising actions.")
 };
+var AnalyticsJourneysInputSchema = {
+  siteId: z11.string().uuid().describe("Analytics Site id returned by analytics_list_sites."),
+  journeyTier: z11.enum(["confirmed", "best_guess", "all"]).default("confirmed").describe("Select confirmed journeys, separately labeled best-guess journeys, or both branches. Confirmed is the default; best-guess evidence can never drive CRM or advertising actions."),
+  limit: z11.number().int().min(1).max(100).default(50).describe("Maximum rows returned in each selected journey branch."),
+  cursor: z11.string().max(1e3).optional().describe("Opaque keyset cursor returned in a selected branch pageInfo.nextCursor.")
+};
 var AnalyticsExplorerDetailInputSchema = {
   siteId: z11.string().uuid().describe("Analytics Site id returned by analytics_list_sites."),
-  reference: AnalyticsOpaqueRef
+  reference: AnalyticsOpaqueRef,
+  from: z11.string().datetime({ offset: true }).optional().describe("Inclusive ISO time. Defaults to 90 days before to; max window 366 days."),
+  to: z11.string().datetime({ offset: true }).optional().describe("Exclusive ISO time. Defaults to now; max window 366 days.")
 };
 var AnalyticsFunnelStage = z11.object({
   key: z11.string().regex(/^[a-z][a-z0-9_]{1,79}$/).describe("Stable stage key."),
@@ -12578,6 +12586,7 @@ var AnalyticsActivationAssetsInputSchema = {
 };
 var AnalyticsActivationMappingInputSchema = {
   siteId: z11.string().uuid().describe("Analytics Site id returned by analytics_list_sites."),
+  journeyTier: z11.literal("confirmed").default("confirmed").describe("External activation is confirmed-only. Best-guess and candidate-assisted journey evidence is schema-invalid."),
   platform: z11.enum(["meta", "google", "tiktok", "reddit"]).describe("Destination provider."),
   externalDatasetId: z11.string().min(1).max(500).describe("Authorized dataset, Pixel, or conversion-action id."),
   eventMapping: z11.record(z11.string().regex(/^[a-z][a-z0-9_]{1,79}$/), z11.string().min(1).max(160)).describe("Confirmed X-Ray event to provider event mapping. Candidate-assisted events are ineligible.")
@@ -12635,6 +12644,154 @@ var AnalyticsSafeOutputRecord = z11.record(z11.string(), z11.unknown());
 var AnalyticsSafeOutputRecords = z11.array(AnalyticsSafeOutputRecord);
 var analyticsRecordOutput = (field) => ({ ok: z11.boolean(), [field]: AnalyticsSafeOutputRecord });
 var analyticsRecordsOutput = (field) => ({ ok: z11.boolean(), [field]: AnalyticsSafeOutputRecords });
+var AnalyticsJourneyRevenueSchema = z11.object({
+  valueMinor: z11.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
+  currency: z11.string().length(3).nullable()
+}).strict();
+var AnalyticsJourneyPageInfoSchema = z11.object({
+  nextCursor: z11.string().min(8).max(1e3).nullable(),
+  hasNextPage: z11.boolean()
+}).strict();
+var AnalyticsConfirmedJourneyPageSchema = z11.object({
+  journeyTier: z11.literal("confirmed"),
+  items: z11.array(z11.object({
+    journeyTier: z11.literal("confirmed"),
+    personRef: AnalyticsOpaqueRef,
+    firstSeenAt: z11.string().datetime().nullable(),
+    lastSeenAt: z11.string().datetime().nullable(),
+    sessions: z11.number().int().min(0),
+    events: z11.number().int().min(0),
+    conversions: z11.number().int().min(0),
+    revenue: AnalyticsJourneyRevenueSchema.nullable(),
+    evidenceClass: z11.literal("deterministic")
+  }).strict()).max(100),
+  pageInfo: AnalyticsJourneyPageInfoSchema
+}).strict();
+var AnalyticsBestGuessJourneyPageSchema = z11.object({
+  journeyTier: z11.literal("candidate_assisted"),
+  totalsAreSeparated: z11.literal(true),
+  items: z11.array(z11.object({
+    journeyTier: z11.literal("candidate_assisted"),
+    inferenceRef: AnalyticsOpaqueRef,
+    confirmedTotals: z11.object({
+      sessions: z11.number().int().min(0),
+      events: z11.number().int().min(0),
+      conversions: z11.number().int().min(0),
+      revenue: AnalyticsJourneyRevenueSchema.nullable()
+    }).strict(),
+    inferredIncrementalTotals: z11.object({
+      sessions: z11.number().int().min(0),
+      events: z11.number().int().min(0),
+      conversions: z11.number().int().min(0),
+      revenue: AnalyticsJourneyRevenueSchema.nullable()
+    }).strict(),
+    candidateCount: z11.number().int().min(1),
+    confidenceBand: z11.literal("high"),
+    modelVersion: z11.string().min(1).max(160),
+    featureClasses: z11.array(z11.string().min(1).max(160)).max(100),
+    coverage: z11.enum(["incremental_sessions_available", "no_incremental_sessions"]),
+    expiresAt: z11.string().datetime(),
+    provenance: z11.literal("consented_high_confidence_candidate_association")
+  }).strict()).max(100),
+  pageInfo: AnalyticsJourneyPageInfoSchema
+}).strict();
+var AnalyticsJourneysResultSchema = z11.discriminatedUnion("journeyTier", [
+  z11.object({ ok: z11.boolean(), journeyTier: z11.literal("confirmed"), confirmed: AnalyticsConfirmedJourneyPageSchema, bestGuess: z11.null(), totalsAreSeparated: z11.literal(false) }).strict(),
+  z11.object({ ok: z11.boolean(), journeyTier: z11.literal("best_guess"), confirmed: z11.null(), bestGuess: AnalyticsBestGuessJourneyPageSchema, totalsAreSeparated: z11.literal(false) }).strict(),
+  z11.object({ ok: z11.boolean(), journeyTier: z11.literal("all"), confirmed: AnalyticsConfirmedJourneyPageSchema, bestGuess: AnalyticsBestGuessJourneyPageSchema, totalsAreSeparated: z11.literal(true) }).strict()
+]);
+var AnalyticsJourneysOutputSchema = {
+  ok: z11.boolean(),
+  journeyTier: z11.enum(["confirmed", "best_guess", "all"]),
+  confirmed: AnalyticsConfirmedJourneyPageSchema.nullable(),
+  bestGuess: AnalyticsBestGuessJourneyPageSchema.nullable(),
+  totalsAreSeparated: z11.boolean()
+};
+var AnalyticsEnhancedJourneyMoneySchema = z11.object({
+  valueMinor: z11.number().int().safe(),
+  currency: z11.string().regex(/^[A-Z]{3}$/).nullable()
+}).strict();
+var AnalyticsEnhancedJourneyAcquisitionSchema = z11.object({
+  source: z11.string().nullable(),
+  medium: z11.string().nullable(),
+  campaign: z11.string().nullable(),
+  referrer: z11.string().url().nullable()
+}).strict();
+var AnalyticsEnhancedJourneyDataSchema = z11.object({
+  subject: z11.object({
+    kind: z11.enum(["person", "visitor", "session"]),
+    reference: z11.string().min(8),
+    personRef: z11.string().min(8).nullable()
+  }).strict(),
+  range: z11.object({
+    from: z11.string().datetime({ offset: true }),
+    to: z11.string().datetime({ offset: true }),
+    fromInclusive: z11.literal(true),
+    toExclusive: z11.literal(true)
+  }).strict(),
+  journeyTier: z11.literal("confirmed"),
+  candidateAssisted: z11.null(),
+  summary: z11.object({
+    sessions: z11.number().int().nonnegative(),
+    pageviews: z11.number().int().nonnegative(),
+    events: z11.number().int().nonnegative(),
+    conversions: z11.number().int().nonnegative(),
+    revenue: AnalyticsEnhancedJourneyMoneySchema.nullable(),
+    totalEngagementMs: z11.number().nonnegative().nullable(),
+    averageEngagementMs: z11.number().nonnegative().nullable()
+  }).strict(),
+  commonPages: z11.array(z11.object({
+    path: z11.string(),
+    visits: z11.number().int().nonnegative(),
+    uniqueSessions: z11.number().int().nonnegative(),
+    engagedMs: z11.number().nonnegative().nullable(),
+    conversions: z11.number().int().nonnegative()
+  }).strict()),
+  acquisition: z11.array(AnalyticsEnhancedJourneyAcquisitionSchema.extend({
+    sessions: z11.number().int().nonnegative(),
+    events: z11.number().int().nonnegative(),
+    conversions: z11.number().int().nonnegative()
+  }).strict()),
+  eventBreakdown: z11.array(z11.object({
+    name: z11.string().min(1),
+    count: z11.number().int().nonnegative(),
+    uniqueSessions: z11.number().int().nonnegative(),
+    conversions: z11.number().int().nonnegative()
+  }).strict()),
+  sessions: z11.array(z11.object({
+    sessionRef: z11.string().min(8),
+    startedAt: z11.string().datetime({ offset: true }),
+    endedAt: z11.string().datetime({ offset: true }).nullable(),
+    durationMs: z11.number().nonnegative().nullable(),
+    pageviews: z11.number().int().nonnegative(),
+    events: z11.number().int().nonnegative(),
+    conversions: z11.number().int().nonnegative(),
+    revenue: AnalyticsEnhancedJourneyMoneySchema.nullable(),
+    landingPath: z11.string().nullable(),
+    exitPath: z11.string().nullable(),
+    acquisition: AnalyticsEnhancedJourneyAcquisitionSchema.nullable()
+  }).strict()),
+  items: z11.array(z11.object({
+    occurredAt: z11.string().datetime({ offset: true }),
+    type: z11.string().min(1),
+    name: z11.string().min(1),
+    path: z11.string().nullable(),
+    referrer: z11.string().url().nullable(),
+    acquisition: AnalyticsEnhancedJourneyAcquisitionSchema.omit({ referrer: true }).nullable(),
+    value: AnalyticsEnhancedJourneyMoneySchema.nullable(),
+    evidenceClass: z11.enum(["deterministic", "candidate"]),
+    provenance: z11.string().min(1)
+  }).strict()),
+  pageInfo: z11.object({
+    nextCursor: z11.string().min(1).nullable(),
+    hasNextPage: z11.boolean()
+  }).strict()
+}).strict();
+var AnalyticsEnhancedJourneyResultSchema = z11.object({
+  ok: z11.literal(true),
+  data: AnalyticsEnhancedJourneyDataSchema
+}).strict();
+var AnalyticsEnhancedJourneyOutputSchema = AnalyticsEnhancedJourneyResultSchema.shape;
 var AnalyticsOnboardingOutputSchema = analyticsRecordOutput("onboarding");
 var AnalyticsOnboardingPreferencesOutputSchema = analyticsRecordOutput("presentation");
 var AnalyticsExplorerOutputSchema = analyticsRecordOutput("data");
@@ -12867,8 +13024,9 @@ var productionOutputSchemas = {
   analytics_update_onboarding_preferences: AnalyticsOnboardingPreferencesOutputSchema,
   analytics_list_sessions: AnalyticsExplorerOutputSchema,
   analytics_list_visitors: AnalyticsExplorerOutputSchema,
-  analytics_get_session_timeline: AnalyticsExplorerOutputSchema,
-  analytics_get_visitor_journey: AnalyticsExplorerOutputSchema,
+  analytics_list_journeys: AnalyticsJourneysOutputSchema,
+  analytics_get_session_timeline: AnalyticsEnhancedJourneyOutputSchema,
+  analytics_get_visitor_journey: AnalyticsEnhancedJourneyOutputSchema,
   analytics_list_funnels: AnalyticsFunnelDefinitionsOutputSchema,
   analytics_get_funnel: AnalyticsFunnelReportOutputSchema,
   analytics_create_funnel: AnalyticsFunnelDefinitionOutputSchema,
@@ -12994,7 +13152,7 @@ function registerAnalyticsMcpTools(server, executor) {
     ["analytics_list_conversion_rules", "List Conversion Rules", "List deterministic versioned rules that turn canonical phone, CRM, transaction, and server events into conversions.", AnalyticsSiteResourceInputSchema, "analyticsListConversionRules"],
     ["analytics_list_event_definitions", "List Browser Event Definitions", "List declarative page, click, and form-submit tags applied by the first-party X-Ray Pixel.", AnalyticsSiteResourceInputSchema, "analyticsListEventDefinitions"],
     ["analytics_get_coverage", "Get Attribution Coverage", "Measure click-ID coverage and call/CRM journey join rates. Null rates mean there is not yet a denominator.", AnalyticsSiteResourceInputSchema, "analyticsGetCoverage"],
-    ["analytics_get_person_journey", "Get Person Journey", "Read one identified person timeline across sessions, immutable touches, calls, CRM stages, conversions, and ad-delivery receipts.", AnalyticsJourneyInputSchema, "analyticsGetPersonJourney"]
+    ["analytics_get_person_journey", "Get Person Journey", "Read CRM-oriented identified-person history: touches, calls, CRM stages, conversions, and delivery receipts. For analytics chronology use analytics_get_visitor_journey.", AnalyticsJourneyInputSchema, "analyticsGetPersonJourney"]
   ];
   for (const [name, title, description, inputSchema, handler] of reads) {
     server.registerTool(name, {
@@ -13077,9 +13235,10 @@ function registerAnalyticsMcpTools(server, executor) {
   const productionReads = [
     ["analytics_get_onboarding_state", "Get X-Ray Setup State", "Read evidence-derived setup milestones. Client input cannot mark evidence milestones complete.", AnalyticsSiteResourceInputSchema, "analyticsGetOnboardingState"],
     ["analytics_list_sessions", "List X-Ray Sessions", "Read bounded sessions using opaque references. Raw visitor/session/device identifiers, contact data, IP, and click IDs are omitted.", AnalyticsExplorerInputSchema, "analyticsListSessions"],
-    ["analytics_list_visitors", "List X-Ray Visitors", "Read bounded visitor summaries using opaque references and separately labeled confirmed or candidate-assisted tiers.", AnalyticsExplorerInputSchema, "analyticsListVisitors"],
-    ["analytics_get_session_timeline", "Get Session Timeline", "Read one safe chronological session timeline by opaque Site-scoped reference.", AnalyticsExplorerDetailInputSchema, "analyticsGetSessionTimeline"],
-    ["analytics_get_visitor_journey", "Get Visitor Journey", "Read one safe visitor journey by opaque Site-scoped reference. Candidate evidence is labeled and never treated as confirmed identity.", AnalyticsExplorerDetailInputSchema, "analyticsGetVisitorJourney"],
+    ["analytics_list_visitors", "List X-Ray Visitors", "Read bounded visitor summaries with opaque references, visit counts, returning status, and confirmed conversion status.", AnalyticsExplorerInputSchema, "analyticsListVisitors"],
+    ["analytics_list_journeys", "List X-Ray Journeys", "List confirmed cross-session paths, separately labeled best-guess paths, or both. Candidate-assisted evidence cannot drive CRM or advertising actions.", AnalyticsJourneysInputSchema, "analyticsListJourneys"],
+    ["analytics_get_session_timeline", "Get Session Timeline", "Read confirmed session summary, pages, events, acquisition, session rollups, and chronology. Use visitor journey for cross-session history.", AnalyticsExplorerDetailInputSchema, "analyticsGetSessionTimeline"],
+    ["analytics_get_visitor_journey", "Get Visitor Journey", "Read one confirmed cross-session visitor/person journey: summary, pages, events, acquisition, session rollups, and chronology. Candidate evidence is excluded.", AnalyticsExplorerDetailInputSchema, "analyticsGetVisitorJourney"],
     ["analytics_list_funnels", "List Lead Funnels", "List versioned lead-stage funnel definitions.", AnalyticsSiteResourceInputSchema, "analyticsListFunnels"],
     ["analytics_get_funnel", "Get Lead Funnel Report", "Read a bounded lead-stage funnel report with documented denominators and safe drill-down references.", AnalyticsFunnelReportInputSchema, "analyticsGetFunnel"],
     ["analytics_list_saved_views", "List Saved Analytics Views", "List account-scoped validated report views without unrestricted sharing.", AnalyticsSiteResourceInputSchema, "analyticsListSavedViews"],
@@ -15026,11 +15185,26 @@ var HttpMcpToolExecutor = class {
   analyticsListVisitors(input) {
     return this.getJson(this.analyticsExplorerPath(input, "visitors"));
   }
+  analyticsListJourneys(input) {
+    const query = new URLSearchParams({
+      journeyTier: input.journeyTier ?? "confirmed",
+      limit: String(input.limit ?? 50)
+    });
+    if (input.cursor) query.set("cursor", input.cursor);
+    return this.getJson(`${analyticsSitePath(input.siteId, "journeys")}?${query}`);
+  }
   analyticsGetSessionTimeline(input) {
-    return this.getJson(analyticsSitePath(input.siteId, `journeys/${encodeURIComponent(input.reference)}/timeline`));
+    return this.getJson(this.analyticsJourneyTimelinePath(input));
   }
   analyticsGetVisitorJourney(input) {
-    return this.getJson(analyticsSitePath(input.siteId, `journeys/${encodeURIComponent(input.reference)}/timeline`));
+    return this.getJson(this.analyticsJourneyTimelinePath(input));
+  }
+  analyticsJourneyTimelinePath(input) {
+    const path = analyticsSitePath(input.siteId, `journeys/${encodeURIComponent(input.reference)}/timeline`);
+    const query = new URLSearchParams();
+    if (input.from) query.set("from", input.from);
+    if (input.to) query.set("to", input.to);
+    return query.size ? `${path}?${query}` : path;
   }
   analyticsListFunnels(input) {
     const query = new URLSearchParams({ limit: String(input.limit ?? 50) });
@@ -15170,18 +15344,18 @@ var HttpMcpToolExecutor = class {
   }
   analyticsExportPrivacySubject(input) {
     const { siteId, idempotencyKey, ...body } = input;
-    return this.call(analyticsSitePath(siteId, "privacy/subject/export"), { ...body, idempotencyKey }, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-privacy-export", idempotencyKey));
+    return this.call(analyticsSitePath(siteId, "privacy/subject/export"), body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-privacy-export", idempotencyKey));
   }
   analyticsDeletePrivacySubject(input) {
     const { siteId, idempotencyKey, ...body } = input;
-    return this.call(analyticsSitePath(siteId, "privacy/subject/delete"), { ...body, idempotencyKey }, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-privacy-delete", idempotencyKey));
+    return this.call(analyticsSitePath(siteId, "privacy/subject/delete"), body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-privacy-delete", idempotencyKey));
   }
   analyticsDiscoverActivationAssets(input) {
     const query = new URLSearchParams({ platform: input.platform, connectionRef: input.connectionRef });
     return this.getJson(`${analyticsSitePath(input.siteId, "activation-assets")}?${query}`);
   }
   analyticsValidateActivationMapping(input) {
-    const { siteId, ...body } = input;
+    const { siteId, journeyTier: _journeyTier, ...body } = input;
     return this.call(analyticsSitePath(siteId, "activation-mappings/validate"), body, this.timeoutMs, "POST");
   }
   commonsSearchEntities(input) {

package/dist/{chunk-RAFQEPJ4.js → chunk-Q2J23DHY.js}

@@ -55,7 +55,7 @@ function renderInstallTerminal(options) {
     "1/1 install surfaces ready",
     colorize(`Newest in v${options.version}: ${release_message_default.message}`, "lime", color),
     "",
-    `${colorize("Tools", "cyan", color)}  ${colorize("(330 MCP tools)", "muted", color)}`,
+    `${colorize("Tools", "cyan", color)}  ${colorize("(331 MCP tools)", "muted", color)}`,
     toolRow("search", ["harvest_paa", "search_serp", "maps_search", "maps_place_intel"], color),
     toolRow("extract", ["extract_url", "map_site_urls", "extract_site", "audit_site", "directory_workflow"], color),
     toolRow("build", ["create_editorial_reading_room", "rank_tracker_workflow", "portable HTML"], color),

package/dist/{chunk-I45JV4EU.js → chunk-RV2D27R4.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-DNM65UCK.js";
 import {
   LedgerOperation
-} from "./chunk-FVL4GUTP.js";
+} from "./chunk-EQJRPDUS.js";
 import {
   CREDIT_LOT_TTL,
   getDb,

package/dist/{chunk-K2SXQGKM.js → chunk-S45DGELW.js}

@@ -23,7 +23,7 @@ import {
   LedgerOperation,
   MC_PER_CREDIT,
   calculateConnectedUsageCharge
-} from "./chunk-FVL4GUTP.js";
+} from "./chunk-EQJRPDUS.js";
 import {
   debitMcIdempotent,
   getDb,

package/dist/{extract-bundle-337ZDIIQ.js → extract-bundle-2V22S7EU.js}

@@ -18,9 +18,9 @@ import {
   createSiteExtractContentReader,
   createSiteExtractImageArtifact,
   extractJobLimitInfo
-} from "./chunk-I45JV4EU.js";
+} from "./chunk-RV2D27R4.js";
 import "./chunk-DNM65UCK.js";
-import "./chunk-FVL4GUTP.js";
+import "./chunk-EQJRPDUS.js";
 import {
   getDb
 } from "./chunk-WEFPBAAG.js";

package/dist/{gmail-service-QXDGNWUJ.js → gmail-service-JHL4PQFN.js}

@@ -7,11 +7,11 @@ import {
   GmailServiceError,
   normalizeGmailMessage,
   parseGmailAddresses
-} from "./chunk-K2SXQGKM.js";
+} from "./chunk-S45DGELW.js";
 import "./chunk-PJEEKOUM.js";
 import "./chunk-T3MZISOF.js";
 import "./chunk-CXY5WV45.js";
-import "./chunk-FVL4GUTP.js";
+import "./chunk-EQJRPDUS.js";
 import "./chunk-WEFPBAAG.js";
 export {
   GMAIL_ATTACHMENT_REF_TTL_MS,