car-finder-il

Scores Yad2 used-car listings against peer cohorts and pushes new matches to phone channels.

2|1|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/Kaidanov/grekai-skills-4all --skill car-finder-il-kaidanov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: car-finder-il
Source: https://github.com/Kaidanov/grekai-skills-4all/tree/main/skills/car-finder-il
Command: npx skills add https://github.com/Kaidanov/grekai-skills-4all --skill car-finder-il-kaidanov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Yad2's built-in saved-search alerts fire on every crude filter match, flooding you with noise. This Skill fetches the same listings, scores each car against its own peer cohort (same make+model, year ±1), and pings your phone only when a listing genuinely beats comparable cars or drops in price. ## Core Features & Use Cases - Cohort-relative scoring: Benchmarks each car's price against the median of comparable listings from the same fetch, plus hand, owner type, km-per-year, and photo count — no external price-guide API needed. - Reads-only data access: Pulls live Yad2 listings through an Apify actor over HTTPS with no login and no browser, so it can never post, bump, or message sellers. - Smart scheduled alerts: A cron-friendly run command dedupes against Supabase (or a local file) and pushes only new matches and real price drops to WhatsApp (wa-ai), Telegram, or ntfy. - Use Case: Describe "family SUV, private owner, under 90k" and the assistant writes a criteria JSON, shows a ranked shortlist with per-car reasons, then sets up twice-daily phone alerts via the bundled GitHub Actions workflow. ## Quick Start Ask the assistant to run the car finder search with the example criteria file in mock mode to see a ranked shortlist of used cars with a reason line for each.

Frequently Asked Questions about car-finder-il

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search used cars on Yad2 with ranked results?

Run scripts/carfinder.py with the search command and a criteria JSON file defining price, year, km, hand, and owner-type filters. It fetches listings via an Apify actor, scores each car against comparable listings, and prints a ranked shortlist with a reason line per car.

How do I get phone alerts for new Yad2 car listings?

Use the run command on a schedule, such as the bundled GitHub Actions workflow that runs twice daily. It dedupes against Supabase or a local file and pushes only new matches and real price drops to WhatsApp via wa-ai, Telegram, or ntfy.

Can I test the car scoring without an Apify token?

Yes, run the search command with --source mock to use the bundled sample listings file. This exercises the full filtering and scoring pipeline offline with zero tokens and zero network access.

Does this tool work without a Levi Yitzhak price-guide API?

Yes, because no public price-guide API exists, each car is benchmarked against its own cohort of same make and model within one year, pulled in the same fetch. Statements like "12% under comparable listings" are computed from that self-contained data.

Can this skill post, bump, or message sellers on Yad2?

No, it is strictly reads-only by design. There is no posting API on Israeli car boards, and the skill never logs in or drives a browser, so it cannot publish, bump, message sellers, or buy anything.

Why am I getting re-notified about the same car?

Re-notifications happen when runs execute on different machines without shared Supabase credentials, so the local seen-file does not carry over. Point all runs at the same SUPABASE_URL and SUPABASE_KEY to share dedupe state.