universal-parcel-scraper 0.69.3-main.891 → 0.69.5-main.893

package/data/catalog.json

@@ -2702,8 +2702,8 @@
       "browserRecognitionRank": 65
     },
     "canaryUrl": "https://www.usps.com/",
-    "trackingUrlTemplate": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-    "trackingSearchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+    "trackingUrlTemplate": "https://tools.usps.com/tracking/{trackingNumber}",
+    "trackingSearchUrl": "https://tools.usps.com/tracking/",
     "linkRules": [
       {
         "domains": [
@@ -2712,7 +2712,8 @@
         ],
         "params": [
           "tLabels"
-        ]
+        ],
+        "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
       }
     ],
     "detectionRules": [

package/dist/browser/scraper.js

@@ -2290,11 +2290,12 @@ var ye = {
 			browserRecognitionRank: 65
 		},
 		canaryUrl: "https://www.usps.com/",
-		trackingUrlTemplate: "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-		trackingSearchUrl: "https://tools.usps.com/go/TrackConfirmAction",
+		trackingUrlTemplate: "https://tools.usps.com/tracking/{trackingNumber}",
+		trackingSearchUrl: "https://tools.usps.com/tracking/",
 		linkRules: [{
 			domains: ["tools.usps.com", "usps.com"],
-			params: ["tLabels"]
+			params: ["tLabels"],
+			path: "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
 		}],
 		detectionRules: [
 			{

package/dist/carriers/usps/adapter.js

@@ -12,21 +12,12 @@ import { uspsStage, uspsStatus } from './status.js';
 /**
  * USPS, through the server-rendered tracking page.
  *
- * The page at `go/TrackConfirmAction?tLabels=` carries the verdict, the
- * status and the history in its own HTML: no tracking XHR exists to capture.
- * Plain HTTP probes returned 403. Browser checks on 2026-09-22 first returned
- * a challenge shell, then succeeded with matching shipment timelines. Access
- * can vary by session. The lookup has a single
- * step: the private browser service loads the page, and the rendered DOM is
- * parsed. Nothing is ever replayed over plain HTTP.
- *
- * Markup provenance: the live page shell (`.track-bar-container`,
- * `#trackingNum`, `.latest-update-banner-wrapper .banner-header`,
- * `.current-tracking-status-wrapper`), inspected 2026-09-20. Positive lookups
- * on 2026-09-22 use `.tb-step` timeline cards, including collapsed history.
- * The older table-shaped fixture remains a parsing fallback.
+ * The `/tracking/{number}` page carries the verdict and collapsed history
+ * in its HTML. The legacy query route can return only the global header,
+ * so load the package path directly. The browser handles verification;
+ * nothing is replayed over plain HTTP.
  */
-const TRACKING_BASE = 'https://tools.usps.com/go/TrackConfirmAction';
+const TRACKING_BASE = 'https://tools.usps.com/tracking/';
 const MAX_BYTES = 10_000_000;
 const DEFAULT_TIMEOUT_MS = 90_000;
 const MAX_EVENTS_TO_RETURN = 100;
@@ -47,9 +38,7 @@ export function normalizeUSPSNumber(raw) {
     return value;
 }
 export function uspsTrackingUrl(trackingNumber) {
-    const url = new URL(TRACKING_BASE);
-    url.searchParams.set('tLabels', normalizeUSPSNumber(trackingNumber));
-    return url.toString();
+    return new URL(normalizeUSPSNumber(trackingNumber), TRACKING_BASE).toString();
 }
 const MONTHS = '(January|February|March|April|May|June|July|August|September|October|November|December)';
 const DATE_PATTERN = new RegExp(`${MONTHS}\\s+\\d{1,2},?\\s+\\d{4}`, 'i');
@@ -149,6 +138,11 @@ export function parseUSPSTrackingHtml(page, trackingNumber) {
     const $ = load(page);
     $('script, style, noscript').remove();
     if ($('.track-bar-container').length === 0) {
+        // A completed USPS header without the tracking application is not a
+        // missing shipment. A second browser read can recover this partial page.
+        if ($('.Widgets_Container #g-navigation').length && /^USPS Tracking/.test($('title').text())) {
+            throw new ChallengeError('USPS', 'USPS returned an incomplete tracking page', { reason: 'incomplete_page' });
+        }
         throw new ChallengeError('USPS', 'USPS challenged the browser tracking session');
     }
     const echoed = clean($('#trackingNum').first().text()).toLocaleUpperCase('en-US');
@@ -236,6 +230,8 @@ export class USPSTracker {
             recorder: this.#recorder,
         }, [
             { id: 'trawl', run: ({ remainingMs, signal }) => this.#trawlResult(trawl, number, Math.max(1, Math.floor(Math.min(this.timeoutMs, remainingMs))), signal) },
+            { id: 'trawl', recovers: error => error instanceof ChallengeError && error.reason === 'incomplete_page',
+                run: ({ remainingMs, signal }) => this.#trawlResult(trawl, number, Math.max(1, Math.floor(Math.min(this.timeoutMs, remainingMs))), signal) },
         ]);
         // A typed routing barcode opens with the recipient's ZIP code. The package
         // identifier after it is the number USPS tracks, so consumers can keep that.

package/dist/carriers/usps/carrier.json

@@ -30,8 +30,8 @@
     "eta"
   ],
   "portal": {
-    "url": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-    "searchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+    "url": "https://tools.usps.com/tracking/{trackingNumber}",
+    "searchUrl": "https://tools.usps.com/tracking/",
     "canaryUrl": "https://www.usps.com/",
     "shows": [
       "status",
@@ -60,7 +60,8 @@
       ],
       "params": [
         "tLabels"
-      ]
+      ],
+      "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
     }
   ],
   "detection": [

package/dist/data/catalog.json

@@ -2702,8 +2702,8 @@
             "browserRecognitionRank": 65
         },
         "canaryUrl": "https://www.usps.com/",
-        "trackingUrlTemplate": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-        "trackingSearchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+        "trackingUrlTemplate": "https://tools.usps.com/tracking/{trackingNumber}",
+        "trackingSearchUrl": "https://tools.usps.com/tracking/",
         "linkRules": [
             {
                 "domains": [
@@ -2712,7 +2712,8 @@
                 ],
                 "params": [
                     "tLabels"
-                ]
+                ],
+                "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
             }
         ],
         "detectionRules": [

package/dist/generated/catalog.d.ts

@@ -1830,11 +1830,12 @@ export declare const CARRIER_CATALOG: {
             readonly browserRecognitionRank: 65;
         };
         readonly canaryUrl: "https://www.usps.com/";
-        readonly trackingUrlTemplate: "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}";
-        readonly trackingSearchUrl: "https://tools.usps.com/go/TrackConfirmAction";
+        readonly trackingUrlTemplate: "https://tools.usps.com/tracking/{trackingNumber}";
+        readonly trackingSearchUrl: "https://tools.usps.com/tracking/";
         readonly linkRules: readonly [{
             readonly domains: readonly ["tools.usps.com", "usps.com"];
             readonly params: readonly ["tLabels"];
+            readonly path: "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$";
         }];
         readonly detectionRules: readonly [{
             readonly pattern: "^(?!9[23]61)(?:91\\d{2}9\\d{17}|92\\d{3}9\\d{16}|93\\d{3}[0-8]\\d{16}|9[45]\\d{20})$";

package/dist/generated/catalog.js

@@ -2703,8 +2703,8 @@ export const CARRIER_CATALOG = {
             "browserRecognitionRank": 65
         },
         "canaryUrl": "https://www.usps.com/",
-        "trackingUrlTemplate": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-        "trackingSearchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+        "trackingUrlTemplate": "https://tools.usps.com/tracking/{trackingNumber}",
+        "trackingSearchUrl": "https://tools.usps.com/tracking/",
         "linkRules": [
             {
                 "domains": [
@@ -2713,7 +2713,8 @@ export const CARRIER_CATALOG = {
                 ],
                 "params": [
                     "tLabels"
-                ]
+                ],
+                "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
             }
         ],
         "detectionRules": [

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.69.3"
+    "version": "0.69.5"
   },
   "paths": {
     "/health": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-parcel-scraper",
-  "version": "0.69.3-main.891",
+  "version": "0.69.5-main.893",
   "description": "Self-hosted parcel tracking: carrier detection, dedicated scrapers and optional universal providers.",
   "type": "module",
   "license": "Apache-2.0",