mcp-scraper 0.32.3 → 0.33.0

package/dist/{worker-ZZCZNY3R.js → worker-JU5FX3NE.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-SDHPQTFM.js";
 import {
   harvest
-} from "./chunk-AEMABLEL.js";
+} from "./chunk-ERORC7AP.js";
 import {
   browserServiceApiKey,
   runWithCostContext
@@ -139,4 +139,4 @@ export {
   startWorker,
   tickOnce
 };
-//# sourceMappingURL=worker-ZZCZNY3R.js.map
+//# sourceMappingURL=worker-JU5FX3NE.js.map

package/docs/adr/0003-waive-unrecoverable-scheduled-model-cost.md

@@ -0,0 +1,22 @@
+# ADR-0003: Waive unrecoverable scheduled model cost during repair
+
+**Status:** Accepted
+
+**Date:** 2026-07-22
+
+## Context
+
+An agent-mode scheduled run completed provider/model work on 2026-07-14, but OpenRouter did not return a model-cost value. The 75-Credit base charge was already captured. Its settlement remained `cost_pending`, which correctly prevented an unverified model delta from being guessed but also blocked every later scheduled run for the account. The original authorization token and exact vendor cost are not recoverable.
+
+## Decision
+
+For this historical repair, preserve the captured base charge, waive the unknown model-cost delta, and close the settlement and authorization as settled with an explicit `model_cost_unavailable_waived` audit reason. Do not invent or estimate a vendor cost.
+
+Future runs continue to require exact reported OpenRouter cost under the existing billing contract. A new missing-cost occurrence must retain enough durable provider evidence for reconciliation or be explicitly waived by an audited operator repair; it must never be silently estimated.
+
+## Consequences
+
+- The account is no longer permanently blocked by an unrecoverable historical delta.
+- MCP Scraper absorbs the unknown model expense for this run.
+- The repair remains visible in billing-event metadata and preserves the original base-charge receipt.
+- A productized recovery path is still needed if missing provider cost recurs.

package/docs/adr/README.md

@@ -10,3 +10,4 @@ Write one when a decision is hard to reverse, surprising, or encodes a constrain
 ## Index
 - [0001 — In-page API interception for anti-bot scraping (Facebook Ad Library)](./0001-in-page-graphql-interception-for-anti-bot-scraping.md)
 - [0002 — Hybrid Smart RAG retrieval for memory vaults](./0002-hybrid-smart-rag-vault-retrieval.md)
+- [0003 — Waive unrecoverable scheduled model cost during repair](./0003-waive-unrecoverable-scheduled-model-cost.md)

package/docs/mcp-tool-manifest.generated.json

@@ -1,9 +1,9 @@
 {
-  "generatedAt": "2026-07-22T14:23:17.207Z",
+  "generatedAt": "2026-07-22T17:24:08.984Z",
   "generatedFrom": "dist/bin/mcp-stdio-server.js",
   "serverInfo": {
     "name": "mcp-scraper",
-    "version": "0.32.3"
+    "version": "0.33.0"
   },
   "counts": {
     "unified_stdio": 166
@@ -4622,12 +4622,11 @@
           "proxyMode": {
             "type": "string",
             "enum": [
-              "location",
               "configured",
               "none"
             ],
             "default": "none",
-            "description": "Leave unset (clean egress). Do NOT set \"location\" just because a city was named — that comes from city-in-query wording. \"location\" forces residential geo-IP, is frequently CAPTCHA-blocked, and accepts failures."
+            "description": "Leave unset for clean egress (the default). Country/region localization comes from gl/hl plus the city or region in the query — not from a proxy."
           },
           "proxyZip": {
             "type": "string",
@@ -6294,12 +6293,11 @@
           "proxyMode": {
             "type": "string",
             "enum": [
-              "location",
               "configured",
               "none"
             ],
             "default": "none",
-            "description": "Proxy behavior per city search. Leave unset for the default route (stealth browser on the managed ISP proxy, retried fresh on a Google block). location forces an explicit residential proxy — not recommended for Google."
+            "description": "Proxy behavior per city search. Leave unset for the default route (stealth browser on the managed ISP proxy, retried fresh on a Google block). Country/region localization comes from the city or region in the query plus gl/hl — not from a proxy."
           },
           "proxyZip": {
             "type": "string",
@@ -9791,12 +9789,11 @@
           "proxyMode": {
             "type": "string",
             "enum": [
-              "location",
               "configured",
               "none"
             ],
             "default": "none",
-            "description": "Leave unset (clean egress). Do NOT set \"location\" just because a city was named — that comes from city-in-query wording. \"location\" forces residential geo-IP for rank-tracking fidelity, is frequently CAPTCHA-blocked, and accepts failures."
+            "description": "Leave unset for clean egress (the default). Country/region localization comes from gl/hl plus the city or region in the query — not from a proxy."
           },
           "proxyZip": {
             "type": "string",
@@ -12512,12 +12509,11 @@
           "proxyMode": {
             "type": "string",
             "enum": [
-              "location",
               "configured",
               "none"
             ],
             "default": "none",
-            "description": "Leave unset for the default route (stealth browser on the managed ISP proxy, retried on a fresh session when Google blocks). Localization comes from the city in the query plus gl/hl. location forces an explicit residential proxy — not recommended for Google."
+            "description": "Leave unset for the default route (stealth browser on the managed ISP proxy, retried on a fresh session when Google blocks). Country/region localization comes from the city or region in the query plus gl/hl — not from a proxy."
           },
           "proxyZip": {
             "type": "string",
@@ -17479,12 +17475,11 @@
           "proxyMode": {
             "type": "string",
             "enum": [
-              "location",
               "configured",
               "none"
             ],
             "default": "none",
-            "description": "Leave unset (clean egress). Do NOT set \"location\" just because a city was named — that comes from city-in-query wording. \"location\" forces residential geo-IP for rank-tracking fidelity, is frequently CAPTCHA-blocked, and accepts failures."
+            "description": "Leave unset for clean egress (the default). Country/region localization comes from gl/hl plus the city or region in the query — not from a proxy."
           },
           "proxyZip": {
             "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-scraper",
-  "version": "0.32.3",
+  "version": "0.33.0",
   "description": "MCP server for MCP Scraper web intelligence tools",
   "type": "module",
   "main": "./dist/index.cjs",