Add purpose-aware property assessor intake

docs/web-automation.md

@@ -15,6 +15,7 @@ Automated web browsing and scraping using Playwright-compatible CloakBrowser, wi
 - Use `node skills/web-automation/scripts/extract.js "<URL>"` for one-shot extraction from a single URL
 - Use `npx tsx scrape.ts ...` for markdown scraping modes
 - Use `npx tsx browse.ts ...`, `auth.ts`, or `flow.ts` for interactive or authenticated flows
+- Use `node skills/web-automation/scripts/zillow-discover.js "<street-address>"` or `har-discover.js` to resolve a real-estate listing URL from an address
 - Use `node skills/web-automation/scripts/zillow-photos.js "<listing-url>"` or `har-photos.js` for real-estate photo extraction before attempting generic gallery automation
 
 ## Requirements
@@ -93,6 +94,7 @@ Notes:
 - If matching is inconsistent, replace `~/.openclaw/...` with the full absolute path for the machine.
 - Keep the allowlist scoped to the main agent unless there is a clear reason to widen it.
 - Prefer file-based commands like `node check-install.js`, `node zillow-photos.js ...`, and `node har-photos.js ...` over inline `node -e ...`. Inline interpreter eval is more likely to trigger approval friction.
+- The same applies to `zillow-discover.js` and `har-discover.js`: keep discovery file-based, not inline.
 
 ## Common commands
 
@@ -104,6 +106,12 @@ node check-install.js
 # One-shot JSON extraction
 node skills/web-automation/scripts/extract.js "https://example.com"
 
+# Zillow listing discovery from address
+node skills/web-automation/scripts/zillow-discover.js "4141 Whiteley Dr, Corpus Christi, TX 78418"
+
+# HAR listing discovery from address
+node skills/web-automation/scripts/har-discover.js "4141 Whiteley Dr, Corpus Christi, TX 78418"
+
 # Zillow photo extraction
 node skills/web-automation/scripts/zillow-photos.js "https://www.zillow.com/homedetails/..."
 
@@ -123,9 +131,35 @@ npx tsx auth.ts --url "https://example.com/login"
 npx tsx flow.ts --instruction 'go to https://search.fiorinis.com then type "pippo" then press enter then wait 2s'
 ```
 
-## Real-estate photo extraction
+## Real-estate listing discovery and photo extraction
 
-Use the dedicated Zillow and HAR extractors before trying a free-form gallery flow.
+Use the dedicated Zillow and HAR discovery/photo commands before trying a free-form gallery flow.
+
+### Zillow discovery
+
+```bash
+cd ~/.openclaw/workspace/skills/web-automation/scripts
+node zillow-discover.js "4141 Whiteley Dr, Corpus Christi, TX 78418"
+```
+
+What it does:
+- opens the Zillow address URL with CloakBrowser
+- resolves directly to a property page when Zillow supports the address slug
+- otherwise looks for a `homedetails` listing link in the rendered page
+- returns the discovered listing URL as JSON
+
+### HAR discovery
+
+```bash
+cd ~/.openclaw/workspace/skills/web-automation/scripts
+node har-discover.js "4141 Whiteley Dr, Corpus Christi, TX 78418"
+```
+
+What it does:
+- opens the HAR address search page
+- looks for a confident `homedetail` match in rendered results
+- returns the discovered listing URL when HAR exposes a strong enough match
+- returns `listingUrl: null` when HAR discovery is not confident enough
 
 ### Zillow
 
@@ -169,6 +203,8 @@ From `skills/web-automation/scripts`:
 ```bash
 node check-install.js
 npm run test:photos
+node zillow-discover.js "<street-address>"
+node har-discover.js "<street-address>"
 node zillow-photos.js "<zillow-listing-url>"
 node har-photos.js "<har-listing-url>"
 ```