van-rental-search
gaoxiaowei2117/van-rental-search
Claude Code skill: search vanpeople + vansky for Vancouver rentals by city/bedrooms/price/facilities, dedupe, classify above-ground, export Markdown/HTML contact lists
Instalação
npx convez-ai gaoxiaowei2117/van-rental-search1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
van-rental-search
A Claude Code Agent Skill that searches
the two main Vancouver Chinese-classifieds — vanpeople (c.vanpeople.com/zufang)
and vansky (vansky.com/info 出租版) — for rental listings, filters them by
the sites' real fields, de-duplicates landlords who repost, and emits a clean
report (table or detailed contact list), optionally opening hits in Chrome.
The sites' own dropdown filters are AJAX/JS and don't work via plain URLs, so this
skill calls the real endpoints (vanpeople's /ajax/pc/list.html) and parses the
structured results directly — filtering is exact, not best-effort scraping.
Daily cloud sync (git-as-a-data-bus)
A GitHub Actions cron runs the engine daily in the cloud and commits the results back into the repo, so a local skill can read them without scraping live:
Actions (cron, UTC) the repo (public) local consumer
scripts/bus_generate.py scripts/bus_consume.py
│ run_search() × queries │ │
│ ── write bus/data.json ──────► │ (push: producer writes) │
│ + bus/state.json │ ◄── raw HTTP GET ───────── │ (pull)
- Producer (
scripts/bus_generate.py): runs every query inconfig/bus_queries.json, merges + de-dups by phone across queries, and writesbus/data.json(full snapshot — each item flagged"new": true/false) plusbus/state.json(which phones were seen before, TTL-pruned). Pure stdlib. - Consumer (
scripts/bus_consume.py): the repo is public, so it just fetchesbus/data.jsonover plain HTTP fromraw.githubusercontent.com— no clone, no auth.--new-onlyshows just the day's new listings;--out report.mdwrites Markdown;--jsonprints the raw payload. - Schedule:
.github/workflows/update-rentals.yml, daily at 13:23 UTC (≈ 05:23 Vancouver). Edit the cron there; edit the search criteria inconfig/bus_queries.json.
# locally, read the latest cloud-synced results:
python3 scripts/bus_consume.py --new-only # just today's new listings
python3 scripts/bus_consume.py --out ~/rentals.md # full snapshot to a file
Features
- Real site filters: city, bedrooms, price range, rent type (整租/分租), house type (公寓/独立屋/连排屋/后巷屋), rent-includes (水/电/网/气), facilities (独立卫浴/厨房/家具/空调/车位…), pets (猫/狗).
- Freshness & move-in:
--posted-since Ndays;--available-from/--available-toreads each detail page's 起租时间 / 最短租期. - Above-ground vs basement classification (全地上 / 半地下) from listing text.
- De-dup by phone — collapses repost spam to one row with
×N+ all links. - Junk filter — drops room-share / short-term posts mislabeled as 整租.
- Outputs: Markdown table,
--contactsdetailed list (联系人 / 电话 / 邮箱 / 微信 / 链接),--jsonstructured array, or--htmlstyled clickable page;--outto a file;--open/--htmlopen in the default browser (cross-platform).
Use from any agent (not only Claude Code)
The engine has no framework lock-in:
-
CLI:
python3 scripts/search.py ... --json -
Python:
from search import run_search; run_search(city="Burnaby", bedrooms=2, ...) -
MCP:
scripts/mcp_server.py— a zero-dependency stdio MCP server exposing asearch_rentalstool, usable by any MCP-capable agent (Claude, Cursor, open agents…).{ "mcpServers": { "van-rental-search": { "command": "python3", "args": ["/abs/path/scripts/mcp_server.py"] } } }
Install
Clone into your Claude Code skills directory:
git clone <your-repo-url> ~/.claude/skills/van-rental-search
Claude Code auto-discovers it. Invoke by asking in plain language ("找 Burnaby 1800 以下的两室") or run the script directly.
Usage
python3 scripts/search.py --city Burnaby --bedrooms 2 --max-price 1800 --above-ground
# detailed contact list of recent above-ground hits, saved + opened
python3 scripts/search.py --city Burnaby --bedrooms 2 --max-price 1800 \
--posted-since 60 --above-ground --source both --contacts \
--out burnaby.md
See SKILL.md for the full option reference and field/id maps.
Notes
- Prices are landlord-stated approximations.
- Requires Python 3 (standard library only) and, for
--open, Google Chrome on macOS. - If vanpeople changes its filter ids, re-scrape them from the
option_item/child_lielements onhttps://c.vanpeople.com/zufang/(see SKILL.md → Extending).
License
MIT