---
name: hunt
description: "Marketplace lead hunter for RateRight — scrapes Gumtree, Seek, Facebook, and regional job boards to find construction workers and contractors. Reads scripts from the VPS deploy dir (C:\\Users\\mclou\\rateright-growth-deploy on Rocky's machine, or /home/ccuser/rateright-growth on VPS). Vault mirror at HQ-Vault/10_RateRight/Skills/hunt/."
version: 1.1.0
author: hermes
metadata:
  project: RateRight
  vault_skill_path: /home/ccuser/rateright-growth/HQ-Vault/10_RateRight/Skills/hunt
  vps_script_path: /home/ccuser/rateright-growth/scripts
---

# /hunt — Marketplace Lead Hunter

Trigger scraper runs to find construction workers and contractors.

## Invocation

| Command | Script |
|---|---|
| `/hunt` | Run all: job-aggregator.js + worker-hunter.js + contractor-hunter.js |
| `/hunt workers` | Run worker-hunter.js only |
| `/hunt contractors` | Run contractor-hunter.js only |
| `/hunt workers sydney` | Run worker-hunter.js --city sydney |
| `/hunt contractors melbourne` | Run contractor-hunter.js --city melbourne |
| `/hunt jobs` | Run job-aggregator.js only |
| `/hunt --dry-run` | Add --dry-run flag to all scripts |
| `/hunt --status` | Run notion-summary.js for today's stats |
| `/hunt facebook-workers` | Scrape Facebook construction worker pages (Australia-wide) |
| `/hunt facebook-jobs` | Scrape Facebook job posting pages (Australia-wide) |

## Facebook hunt (NEW — 2026-05-09)

Rocky has a list of **237 Australian construction Facebook pages/groups**. These are the primary targets for both worker supply and contractor outreach.

**Browser approach (VPS):**
```
browser_navigate(url="https://www.facebook.com/[page-slug]")
# screenshot → vision AI extract → parse → upsert CRM → digest
```

**Workflow per page:**
1. Navigate to the Facebook page (public posts don't need login)
2. Screenshot the post list
3. Vision AI extracts: name, location, job type, contact, post date
4. Upsert to `hunt-leads` table with `source='facebook-workers'` or `source='facebook-jobs'`
5. After full run: output daily digest of new contacts

**Scope:** 237 pages across all Australian states/territories. Run in batches of 20-30 per session to avoid rate limiting.

**Do NOT:** try to auto-send messages as Rocky — this risks account ban and is explicitly against the Facebook strategy in the vault.

## Final step (Wave 2.2 protocol)

```bash
bash scripts/log-event.sh "<agent-id>" "skill_run" "hunt" "<ok|fail>" "<args> — <count> leads scraped"
```

## Regression fixture

See `fixtures/golden-output.md` for expected output structure.