mcp-scraper 0.63.1 → 0.63.2

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to MCP Scraper are documented here. The format is based on [
 
 ## [Unreleased]
 
+## [0.63.2] - 2026-08-24
+
+### Fixed
+
+- Kept base-plan, bundled and standalone Memory, and concurrency-pack entitlements active while Stripe retries a `past_due` renewal, while terminal subscription states still remove access.
+- Reused an existing active, trialing, or past-due base subscription during plan changes instead of risking a duplicate subscription when the local subscription reference is missing.
+- Replaced unavailable credit-top-up guidance with the supported larger-plan path and a terminal upgrade command that lists only publicly purchasable tiers.
+
 ## [0.63.1] - 2026-08-23
 
 ### Fixed
@@ -1005,7 +1013,10 @@ All notable changes to MCP Scraper are documented here. The format is based on [
 - Write actions remain unavailable until the account owner explicitly enables them.
 - Provider-specific connection data is normalized into one agent-facing contract.
 
-[Unreleased]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.55.0...HEAD
+[Unreleased]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.63.2...HEAD
+[0.63.2]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.63.1...v0.63.2
+[0.63.1]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.63.0...v0.63.1
+[0.63.0]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.60.0...v0.63.0
 [0.55.0]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.54.4...v0.55.0
 [0.54.4]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.54.3...v0.54.4
 [0.54.3]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.54.2...v0.54.3

package/README.md

@@ -90,7 +90,7 @@ Build the branded one-click bundle:
 npm run build:mcpb
 ```
 
-The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.63.1`, SHA-256 `10646568735791bcf6235db18fcec2aac9b2e53d0c926140af51ba299e4d3ddd`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
+The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.63.2`, SHA-256 `31a2725eb363da4d38e12559eedf83160916550294795203031dc003a78afb7c`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
 
 The MCPB install exposes every tool — web-intelligence plus all `browser_*` tools — through the one `mcp-scraper` server.
 

package/dist/bin/api-server.cjs

@@ -12964,24 +12964,30 @@ function concurrencyPackBillingInfo() {
 function mcToCredits(mc) {
   return mc / MC_PER_CREDIT;
 }
+function purchasablePlanTiers() {
+  return Object.values(SUBSCRIPTION_TIERS).filter((tier) => !tier.private_offer).sort((a, b) => a.credits_mc - b.credits_mc);
+}
 function insufficientBalanceResponse(balanceMc, requiredMc) {
-  const topupUrl = process.env.TOPUP_URL ?? "https://mcpscraper.dev/billing";
+  const billingUrl = process.env.TOPUP_URL ?? "https://mcpscraper.dev/billing";
   const balanceCredits = mcToCredits(balanceMc);
   const requiredCredits = mcToCredits(requiredMc);
+  const planKeys = purchasablePlanTiers().map((tier) => tier.tier).join("|");
+  const upgradeCommand = `${SUBSCRIPTION_TERMINAL_COMMAND} <${planKeys}>`;
   return {
     error: "insufficient_balance",
     error_code: "insufficient_balance",
-    message: `Insufficient credits. Balance: ${balanceCredits} credits. This call requires ${requiredCredits} credits. Top up at ${topupUrl}`,
+    message: `Insufficient credits. Balance: ${balanceCredits} credits. This call requires ${requiredCredits} credits. Credits refresh when your plan renews; for more now, move to a larger plan at ${billingUrl} (terminal: ${upgradeCommand})`,
     balance_credits: balanceCredits,
     required_credits: requiredCredits,
-    topup_url: topupUrl
+    topup_url: billingUrl,
+    upgrade_command: upgradeCommand
   };
 }
 function mediaTranscribeChargeMc(durationSecs) {
   const mins = Math.max(1, Math.ceil((durationSecs || 60) / 60));
   return MEDIA_TRANSCRIBE_FLAT_MC + MEDIA_TRANSCRIBE_PER_MIN_MC * mins;
 }
-var MC_COSTS, MC_PER_BROWSER_MS, BROWSER_OPEN_MIN_BALANCE_MC, MC_PER_CREDIT, SERP_SEARCH_CREDITS, PAA_BASE_CREDITS, PAA_QUESTION_CREDITS, PAGE_SCRAPE_CREDITS, LISTING_WRITE_RATE_POLICY, BILLING_MC_PER_USD_NUMERATOR, BILLING_MC_PER_USD_DENOMINATOR, BILLING_BASIS_POINTS, USD_NANOS, SCHEDULED_RUN_BASE_CREDITS, SCHEDULED_RUN_BASE_MC, SCHEDULED_AGENT_LLM_MARKUP_BPS, SCHEDULED_AGENT_LLM_MARKUP, SCHEDULED_RUN_DEFAULT_MAX_CREDITS, CONNECTED_USAGE_RATE_POLICY_VERSION, CONNECTED_ACTIVE_CONNECTION_MONTHLY_CREDITS, CONNECTED_ACTIVE_CONNECTION_MONTHLY_MC, CONNECTED_FUNCTION_RUN_CREDITS, CONNECTED_PROXY_REQUEST_CREDITS, CONNECTED_COMPUTE_CREDITS_PER_SECOND, CONNECTED_FUNCTION_RUN_MC, CONNECTED_PROXY_REQUEST_MC, CONNECTED_COMPUTE_MC_PER_SECOND, CONNECTED_USAGE_RATE_POLICY, CREDIT_COST_CATALOG, CONCURRENCY_PRICE_ID, SUBSCRIPTION_TIERS, SUBSCRIPTION_TIER_BY_KEY, PRIVATE_OFFERS, CONCURRENCY_PACK_PRICE_USD, CONCURRENCY_PACK_PRICE_CURRENCY, CONCURRENCY_PACK_PRICE_INTERVAL, CONCURRENCY_SLOTS_PER_PACK, CONCURRENCY_PACK_RATE_POLICY_VERSION, CONCURRENCY_PACK_PRICE_LABEL, CONCURRENCY_PACK_INVOICE_DESCRIPTION, CONCURRENCY_PACK_INVOICE_FOOTER, CONCURRENCY_PACK_TERMINAL_COMMAND, MEMORY_FREE_QUOTA_BYTES, MEMORY_PLANS, MEMORY_PLAN_QUOTA, MEMORY_MARGIN_MULTIPLE, MEMORY_PRO_COST_BUDGET_USD, LedgerOperation, MEMORY_AI_MARGIN_MULTIPLE, SITE_AUDIT_LLM_MARGIN_MULTIPLE, VIDEO_ANALYSIS_LLM_MARGIN_MULTIPLE, MEDIA_TRANSCRIBE_FLAT_MC, MEDIA_TRANSCRIBE_PER_MIN_MC, MEDIA_TRANSCRIBE_HOLD_MC, MC_PER_USD;
+var MC_COSTS, MC_PER_BROWSER_MS, BROWSER_OPEN_MIN_BALANCE_MC, MC_PER_CREDIT, SERP_SEARCH_CREDITS, PAA_BASE_CREDITS, PAA_QUESTION_CREDITS, PAGE_SCRAPE_CREDITS, LISTING_WRITE_RATE_POLICY, BILLING_MC_PER_USD_NUMERATOR, BILLING_MC_PER_USD_DENOMINATOR, BILLING_BASIS_POINTS, USD_NANOS, SCHEDULED_RUN_BASE_CREDITS, SCHEDULED_RUN_BASE_MC, SCHEDULED_AGENT_LLM_MARKUP_BPS, SCHEDULED_AGENT_LLM_MARKUP, SCHEDULED_RUN_DEFAULT_MAX_CREDITS, CONNECTED_USAGE_RATE_POLICY_VERSION, CONNECTED_ACTIVE_CONNECTION_MONTHLY_CREDITS, CONNECTED_ACTIVE_CONNECTION_MONTHLY_MC, CONNECTED_FUNCTION_RUN_CREDITS, CONNECTED_PROXY_REQUEST_CREDITS, CONNECTED_COMPUTE_CREDITS_PER_SECOND, CONNECTED_FUNCTION_RUN_MC, CONNECTED_PROXY_REQUEST_MC, CONNECTED_COMPUTE_MC_PER_SECOND, CONNECTED_USAGE_RATE_POLICY, CREDIT_COST_CATALOG, CONCURRENCY_PRICE_ID, SUBSCRIPTION_TIERS, SUBSCRIPTION_TIER_BY_KEY, PRIVATE_OFFERS, CONCURRENCY_PACK_PRICE_USD, CONCURRENCY_PACK_PRICE_CURRENCY, CONCURRENCY_PACK_PRICE_INTERVAL, CONCURRENCY_SLOTS_PER_PACK, CONCURRENCY_PACK_RATE_POLICY_VERSION, CONCURRENCY_PACK_PRICE_LABEL, CONCURRENCY_PACK_INVOICE_DESCRIPTION, CONCURRENCY_PACK_INVOICE_FOOTER, CONCURRENCY_PACK_TERMINAL_COMMAND, SUBSCRIPTION_TERMINAL_COMMAND, MEMORY_FREE_QUOTA_BYTES, MEMORY_PLANS, MEMORY_PLAN_QUOTA, MEMORY_MARGIN_MULTIPLE, MEMORY_PRO_COST_BUDGET_USD, LedgerOperation, MEMORY_AI_MARGIN_MULTIPLE, SITE_AUDIT_LLM_MARGIN_MULTIPLE, VIDEO_ANALYSIS_LLM_MARGIN_MULTIPLE, MEDIA_TRANSCRIBE_FLAT_MC, MEDIA_TRANSCRIBE_PER_MIN_MC, MEDIA_TRANSCRIBE_HOLD_MC, MC_PER_USD;
 var init_rates = __esm({
   "src/api/rates.ts"() {
     "use strict";
@@ -13359,6 +13365,7 @@ var init_rates = __esm({
     CONCURRENCY_PACK_INVOICE_DESCRIPTION = "MCP Scraper browser concurrency pack \u2014 each $5 monthly pack adds 2 browsers.";
     CONCURRENCY_PACK_INVOICE_FOOTER = "Billed monthly until canceled. A receipt is emailed after each successful payment.";
     CONCURRENCY_PACK_TERMINAL_COMMAND = "npx -y -p mcp-scraper@latest mcp-scraper-cli billing concurrency checkout";
+    SUBSCRIPTION_TERMINAL_COMMAND = "npx -y -p mcp-scraper@latest mcp-scraper-cli billing subscribe";
     MEMORY_FREE_QUOTA_BYTES = 1e7 * 1;
     MEMORY_PLANS = {
       "price_1TnMSTS8aAcsk3TGBgiwuvqL": { plan: "pro", label: "Pro", price_id: "price_1TnMSTS8aAcsk3TGBgiwuvqL", interval: "month", monthly_usd: 19, quota_bytes: 5e9 },
@@ -18200,7 +18207,7 @@ function publicErrorText(envelope) {
   if (envelope.retry_after_seconds) lines.push(`Retry after: ${envelope.retry_after_seconds} seconds.`);
   if (envelope.charge_status) lines.push(`Charge status: ${envelope.charge_status.replaceAll("_", " ")}.`);
   if (typeof details.upgrade_url === "string") lines.push(`Add capacity: ${details.upgrade_url}`);
-  if (typeof details.topup_url === "string") lines.push(`Top up: ${details.topup_url}`);
+  if (typeof details.topup_url === "string") lines.push(`Plans: ${details.topup_url}`);
   if (typeof details.upgrade_command === "string") lines.push(`Terminal: ${details.upgrade_command}`);
   if (envelope.retryable) lines.push("Retryable: yes.");
   return lines.join(" ");
@@ -34262,6 +34269,25 @@ var init_inbox_routes = __esm({
   }
 });
 
+// src/api/subscription-status-policy.ts
+function isEntitledSubscriptionStatus(status) {
+  return ENTITLED_SUBSCRIPTION_STATUSES.includes(status);
+}
+function findPreferredEntitledSubscription(subscriptions, predicate) {
+  for (const status of ENTITLED_SUBSCRIPTION_STATUSES) {
+    const match = subscriptions.find((subscription) => subscription.status === status && predicate(subscription));
+    if (match) return match;
+  }
+  return void 0;
+}
+var ENTITLED_SUBSCRIPTION_STATUSES;
+var init_subscription_status_policy = __esm({
+  "src/api/subscription-status-policy.ts"() {
+    "use strict";
+    ENTITLED_SUBSCRIPTION_STATUSES = ["active", "trialing", "past_due"];
+  }
+});
+
 // src/api/connected-account-billing.ts
 function connectedBillingPeriodStart(now = /* @__PURE__ */ new Date()) {
   return `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, "0")}`;
@@ -34338,6 +34364,12 @@ function connectedAccountBillingView(actualQuantity, state) {
 function findBasePlanItem(subscription) {
   return subscription.items.data.find((item) => !!item.price?.id && item.price.id in SUBSCRIPTION_TIERS);
 }
+function findAdoptableBasePlanSubscription(subscriptions) {
+  return findPreferredEntitledSubscription(
+    subscriptions,
+    (subscription) => !!findBasePlanItem(subscription)
+  );
+}
 function safeErrorCode(error) {
   if (error instanceof ConnectedAccountBillingError) return error.code;
   return "stripe_connection_billing_failed";
@@ -34455,6 +34487,7 @@ var DEFAULT_CONNECTED_ACCOUNT_PRICE_ID, BILLABLE_LIFECYCLE, ConnectedAccountBill
 var init_connected_account_billing = __esm({
   "src/api/connected-account-billing.ts"() {
     "use strict";
+    init_subscription_status_policy();
     init_db();
     init_rates();
     init_connected_cost_telemetry();
@@ -45467,7 +45500,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.63.1";
+    PACKAGE_VERSION = "0.63.2";
   }
 });
 
@@ -61267,7 +61300,7 @@ async function processStripeEvent(event2) {
     if (concurrencyItem) {
       const user2 = await getUserByStripeCustomerId(sub.customer);
       if (!user2) return;
-      const live = sub.status === "active" || sub.status === "trialing";
+      const live = isEntitledSubscriptionStatus(sub.status);
       await setConcurrencyPackQuantity(user2.id, live ? subscriptionItemQuantity(concurrencyItem) : 0);
       await setConcurrencySubId(user2.id, live ? sub.id : null);
       return;
@@ -61277,7 +61310,7 @@ async function processStripeEvent(event2) {
       const mem = MEMORY_PLANS[priceId];
       const user2 = await resolveUser3(sub.customer, sub.customer_email);
       if (user2) {
-        const live = sub.status === "active" || sub.status === "trialing";
+        const live = isEntitledSubscriptionStatus(sub.status);
         const newMemoryPlan = live ? mem.plan : "free";
         await setMemoryPlan(user2.id, newMemoryPlan, live ? sub.id : null);
         await syncMemoryKeyPlan(user2, resolveEffectiveMemoryPlan({ ...user2, memory_plan: newMemoryPlan }));
@@ -61288,7 +61321,7 @@ async function processStripeEvent(event2) {
     if (!user) return;
     if (priceId && priceId in SUBSCRIPTION_TIERS) {
       const tier = SUBSCRIPTION_TIERS[priceId];
-      const live = sub.status === "active" || sub.status === "trialing";
+      const live = isEntitledSubscriptionStatus(sub.status);
       const newTier = live ? tier.tier : null;
       await setSubscriptionTier(user.id, newTier, live ? tier.concurrency : 0, live ? sub.id : null);
       if (tier.includes_memory) {
@@ -61391,6 +61424,7 @@ var init_stripe_routes = __esm({
     init_rates();
     init_memory();
     init_connected_account_billing();
+    init_subscription_status_policy();
     init_stripe_credit_policy();
     stripe = new import_stripe.default(process.env.STRIPE_SECRET_KEY, { apiVersion: "2026-02-25.clover" });
     stripeApp = new import_hono23.Hono();
@@ -80410,6 +80444,10 @@ function desiredConcurrencyPackQuantity(value) {
 function stripeSubscriptionCustomerId(subscription) {
   return typeof subscription.customer === "string" ? subscription.customer : subscription.customer.id;
 }
+async function findExistingBasePlanSubscriptionId(stripeClient, customerId) {
+  const subs = await stripeClient.subscriptions.list({ customer: customerId, status: "all", limit: 100 });
+  return findAdoptableBasePlanSubscription(subs.data)?.id;
+}
 function concurrencyAccountView(user, quantityOverride) {
   const packQuantity = quantityOverride ?? concurrencyPackQuantityForUser(user);
   const extraSlots = packQuantity * CONCURRENCY_SLOTS_PER_PACK;
@@ -83465,9 +83503,7 @@ var init_server = __esm({
         let existingSubId = user.subscription_id;
         if (!existingSubId) {
           try {
-            const active = await stripeClient.subscriptions.list({ customer: customerId, status: "active", limit: 20 });
-            const baseSub = active.data.find((s) => findBasePlanItem(s));
-            if (baseSub) existingSubId = baseSub.id;
+            existingSubId = await findExistingBasePlanSubscriptionId(stripeClient, customerId) ?? null;
           } catch (err) {
             console.warn("[billing/subscribe] could not check for existing subscription", err instanceof Error ? err.message : err);
           }
@@ -83622,9 +83658,7 @@ var init_server = __esm({
         let existingSubId = user.subscription_id;
         if (!existingSubId) {
           try {
-            const active = await stripeClient.subscriptions.list({ customer: customerId, status: "active", limit: 20 });
-            const baseSub = active.data.find((s) => findBasePlanItem(s));
-            if (baseSub) existingSubId = baseSub.id;
+            existingSubId = await findExistingBasePlanSubscriptionId(stripeClient, customerId) ?? null;
           } catch (err) {
             console.warn("[billing/subscribe] could not check for existing subscription", err instanceof Error ? err.message : err);
           }