Defer property assessor email gate

skills/web-automation/scripts/har-discover.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 
+import { pathToFileURL } from "node:url";
+
 import {
   createPageSession,
   dismissCommonOverlays,
@@ -57,8 +59,8 @@ async function collectListingUrl(page) {
   });
 }
 
-async function main() {
-  const address = String(process.argv[2] || "").trim();
+export async function discoverHarListing(rawAddress) {
+  const address = String(rawAddress || "").trim();
   const identity = parseAddressIdentity(address);
   const searchUrl = buildSearchUrl(address);
   const { context, page } = await createPageSession({ headless: process.env.HEADLESS !== "false" });
@@ -101,30 +103,36 @@ async function main() {
       }
     }
 
-    process.stdout.write(
-      `${JSON.stringify(
-        {
-          source: "har",
-          address,
-          searchUrl,
-          finalUrl: page.url(),
-          title: await page.title(),
-          listingUrl,
-          attempts,
-        },
-        null,
-        2
-      )}\n`
-    );
+    const result = {
+      source: "har",
+      address,
+      searchUrl,
+      finalUrl: page.url(),
+      title: await page.title(),
+      listingUrl,
+      attempts,
+    };
     await context.close();
+    return result;
   } catch (error) {
     try {
       await context.close();
     } catch {
       // Ignore close errors after the primary failure.
     }
+    throw new Error(`HAR discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+async function main() {
+  try {
+    const result = await discoverHarListing(process.argv[2]);
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  } catch (error) {
     fail("HAR discovery failed.", error instanceof Error ? error.message : String(error));
   }
 }
 
-main();
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main();
+}

skills/web-automation/scripts/har-photos.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 
+import { pathToFileURL } from "node:url";
+
 import {
   clickPhotoEntryPoint,
   collectRenderedImageCandidates,
@@ -29,8 +31,8 @@ async function getAnnouncedPhotoCount(page) {
   });
 }
 
-async function main() {
-  const requestedUrl = parseTarget(process.argv[2]);
+export async function extractHarPhotos(rawUrl) {
+  const requestedUrl = parseTarget(rawUrl);
   const { context, page } = await createPageSession({ headless: process.env.HEADLESS !== "false" });
 
   try {
@@ -68,16 +70,27 @@ async function main() {
       notes: ["Opened HAR all-photos flow and extracted large rendered image URLs from the photo page."],
     };
 
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
     await context.close();
+    return result;
   } catch (error) {
     try {
       await context.close();
     } catch {
       // Ignore close errors after the primary failure.
     }
+    throw new Error(error instanceof Error ? error.message : String(error));
+  }
+}
+
+async function main() {
+  try {
+    const result = await extractHarPhotos(process.argv[2]);
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  } catch (error) {
     fail("HAR photo extraction failed.", error instanceof Error ? error.message : String(error));
   }
 }
 
-main();
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main();
+}

skills/web-automation/scripts/zillow-discover.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 
+import { pathToFileURL } from "node:url";
+
 import {
   createPageSession,
   dismissCommonOverlays,
@@ -61,8 +63,8 @@ async function collectListingUrl(page) {
   });
 }
 
-async function main() {
-  const address = String(process.argv[2] || "").trim();
+export async function discoverZillowListing(rawAddress) {
+  const address = String(rawAddress || "").trim();
   const identity = parseAddressIdentity(address);
   const searchUrl = `https://www.zillow.com/homes/${encodeURIComponent(buildZillowAddressSlug(address))}_rb/`;
   const { context, page } = await createPageSession({ headless: process.env.HEADLESS !== "false" });
@@ -105,30 +107,36 @@ async function main() {
       }
     }
 
-    process.stdout.write(
-      `${JSON.stringify(
-        {
-          source: "zillow",
-          address,
-          searchUrl,
-          finalUrl: page.url(),
-          title: await page.title(),
-          listingUrl,
-          attempts,
-        },
-        null,
-        2
-      )}\n`
-    );
+    const result = {
+      source: "zillow",
+      address,
+      searchUrl,
+      finalUrl: page.url(),
+      title: await page.title(),
+      listingUrl,
+      attempts,
+    };
     await context.close();
+    return result;
   } catch (error) {
     try {
       await context.close();
     } catch {
       // Ignore close errors after the primary failure.
     }
+    throw new Error(`Zillow discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+async function main() {
+  try {
+    const result = await discoverZillowListing(process.argv[2]);
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  } catch (error) {
     fail("Zillow discovery failed.", error instanceof Error ? error.message : String(error));
   }
 }
 
-main();
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main();
+}

skills/web-automation/scripts/zillow-photos.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 
+import { pathToFileURL } from "node:url";
+
 import {
   clickPhotoEntryPoint,
   createPageSession,
@@ -102,8 +104,8 @@ async function collectZillowStructuredPhotoCandidates(page) {
   return extractZillowStructuredPhotoCandidatesFromNextDataScript(scriptText || "");
 }
 
-async function main() {
-  const requestedUrl = parseTarget(process.argv[2]);
+export async function extractZillowPhotos(rawUrl) {
+  const requestedUrl = parseTarget(rawUrl);
   const { context, page } = await createPageSession({ headless: process.env.HEADLESS !== "false" });
 
   try {
@@ -167,16 +169,27 @@ async function main() {
       notes,
     };
 
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
     await context.close();
+    return result;
   } catch (error) {
     try {
       await context.close();
     } catch {
       // Ignore close errors after the primary failure.
     }
+    throw new Error(error instanceof Error ? error.message : String(error));
+  }
+}
+
+async function main() {
+  try {
+    const result = await extractZillowPhotos(process.argv[2]);
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  } catch (error) {
     fail("Zillow photo extraction failed.", error instanceof Error ? error.message : String(error));
   }
 }
 
-main();
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main();
+}