← Back to Skills Marketplace
sonim1

Hauscout

by sonim1 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
283
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install hauscout
Description
Hauscout 부동산 데이터 수집/분석 파이프라인. HouseSigma에서 매물을 자동 수집하고 AI 분석 후 Neon PostgreSQL에 저장. '매물 수집', '부동산 데이터 수집', 'hauscout', '수집 실행', '부동산 크롤링' 요청 시 사용.
README (SKILL.md)

Hauscout 데이터 수집

프로젝트 위치

/Users/kendrick/projects/hauscout

수집 실행

cd /Users/kendrick/projects/hauscout
npx tsx scripts/collect.ts

CLI 옵션

  • --url \x3Curl> — 특정 매물 1개만 수집
  • --profile \x3Cid> — 특정 검색 프로필만
  • --headed — 브라우저 표시 (디버깅용)
  • --dry-run — AI 분석만, DB 저장 안 함

수집 파이프라인 요약

  1. Playwright로 HouseSigma 맵 검색 → 매물 목록
  2. 가격/침실/타입 코드 필터링
  3. 상세 페이지 방문 → DOM 텍스트 추출 (Comparables 섹션 제외)
  4. GPT-4o-mini AI 분석 → 구조화 데이터 + 가성비 분석
  5. Neon PostgreSQL 저장 (신규/업데이트/가격변동 추적)

수집 후 체크리스트

  1. 에러 없이 완료됐는지 확인 (exit code, 에러 카운트)
  2. 신규 매물이 있으면 주소/가격/AI 요약 기록
  3. 가격 변동이 있으면 기록
  4. memory/YYYY-MM-DD.md에 수집 결과 요약 작성
  5. git commit & push (변경사항 있을 때만)

DB 확인 (필요시)

cd /Users/kendrick/projects/hauscout
npx tsx -e "
import { neon } from '@neondatabase/serverless';
import { drizzle } from 'drizzle-orm/neon-http';
import * as schema from './src/db/schema';
// .env.local 로드 필요
const sql = neon(process.env.DATABASE_URL!);
const db = drizzle(sql, { schema });
const all = await db.select().from(schema.listings);
console.log(JSON.stringify(all, null, 2));
"

검색 프로필 (현재 2개)

  1. Queensway 근처 콘도 (2-3bed, $800K 이하)
  2. 미시사가 단독주택 ($800K 이하)

주의사항

  • HouseSigma는 SPA → domcontentloaded + waitForTimeout 사용
  • 가격 추출은 "Listed for: $XXX" 패턴만 사용 (Comparables 가격 혼입 방지)
  • 요청 간 2-4초 랜덤 딜레이 (rate limit 방지)
Usage Guidance
Do not run this skill blindly. Before installing or executing: 1) Inspect the repository files (especially scripts/collect.ts, package.json) to see exactly which secrets and APIs it uses (DATABASE_URL, OPENAI_API_KEY or similar), what network calls it makes, and whether it actually contains Playwright/browser automation. 2) Expect to supply a DATABASE_URL and likely an OpenAI/API key and git credentials — verify those are only used for the declared purpose. 3) Because the SKILL.md uses an absolute user path, either run it from a controlled copy in an isolated environment (VM/container) or update paths to a safe workspace. 4) Review and test in a sandbox (no production DB), and confirm compliance with HouseSigma's terms of service and rate limits. 5) If you cannot inspect the underlying scripts or the author cannot justify the undeclared credentials and the use of absolute paths, avoid installing — the metadata/instructions mismatch makes the skill suspicious.
Capability Analysis
Type: OpenClaw Skill Name: hauscout Version: 1.0.0 The 'hauscout' skill bundle describes a legitimate real estate data collection and analysis pipeline. It automates web scraping of HouseSigma using Playwright, processes data with GPT-4o-mini, and stores results in a Neon PostgreSQL database. The instructions in SKILL.md are consistent with the stated purpose, involving standard development tasks like running TypeScript scripts (scripts/collect.ts), managing local logs, and performing git operations within a specific project directory (/Users/kendrick/projects/hauscout).
Capability Assessment
Purpose & Capability
The described purpose (crawl HouseSigma, analyze with an LLM, store into Neon Postgres) matches the instructions, but the skill metadata declares no required env vars/credentials while the instructions explicitly require a DATABASE_URL (via .env.local) and implicitly require API credentials for AI calls and git push credentials. The absence of those declarations is incoherent.
Instruction Scope
SKILL.md directs the agent to run commands in a user-specific absolute path (/Users/kendrick/projects/hauscout), run Playwright to visit external sites, extract DOM text, write summary files under memory/YYYY-MM-DD.md, and git commit & push. It also shows a DB-check snippet that expects .env.local. These actions read/write local files, network resources, and potentially push to remote git — broader scope than the metadata implies.
Install Mechanism
There is no install spec (instruction-only), which is low risk in itself. However the instructions assume a Node/TS environment (npx tsx), Playwright, and database/ORM packages are present. The skill will fail or behave differently unless those dependencies exist, and those dependencies could pull in binaries (Playwright browsers) when installed.
Credentials
Metadata lists no required env vars, but the SKILL.md uses process.env.DATABASE_URL (via .env.local) and references GPT-4o-mini analysis (which typically requires model/API credentials). It also triggers git push which requires git remote credentials. Requesting database and API credentials would be proportionate to the task, but they must be declared — the omission is a red flag.
Persistence & Privilege
always:false and model invocation not disabled (normal). The skill does not request permanent platform-level privileges, but it does mutate local state (writes memory/*.md, database writes, git commits/pushes). That local persistence is expected for the stated purpose but should be made explicit in metadata and user consent prompts.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hauscout
  3. After installation, invoke the skill by name or use /hauscout
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
hauscout 1.0.0 – Initial release - Automated pipeline to collect and analyze HouseSigma real estate listings with AI, storing results in Neon PostgreSQL. - CLI supports targeted listing/profile, headless/headed browser, and dry-run options. - Playwright used for search, AI models for analysis, and price history tracked. - Post-collection checklist ensures data integrity and supports easy reporting. - Includes database query and profile management instructions. - Special handling for SPA content, accurate price extraction, and rate-limiting strategies.
Metadata
Slug hauscout
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Hauscout?

Hauscout 부동산 데이터 수집/분석 파이프라인. HouseSigma에서 매물을 자동 수집하고 AI 분석 후 Neon PostgreSQL에 저장. '매물 수집', '부동산 데이터 수집', 'hauscout', '수집 실행', '부동산 크롤링' 요청 시 사용. It is an AI Agent Skill for Claude Code / OpenClaw, with 283 downloads so far.

How do I install Hauscout?

Run "/install hauscout" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Hauscout free?

Yes, Hauscout is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Hauscout support?

Hauscout is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Hauscout?

It is built and maintained by sonim1 (@sonim1); the current version is v1.0.0.

💬 Comments