---
name: comparable-finder
description: "Pull and rank comparable evidence for a valuation prep pack. Returns three SSTC and three sold in the last 12 months within the profile's comparable radius. Built for use inside valuation-prep; the operator does not invoke it directly."
---

# Comparable finder

A building-block skill called by `valuation-prep` to assemble the comparables section.

## What it does

Given a subject property, the skill queries the portal data feeds and Land Registry within the profile's comparable radius (default 0.5 miles). It picks six properties: three sold subject to contract and three sold and completed in the last 12 months.

Selection criteria, in priority order:

1. Location proximity. Same street ranks above same postcode, which ranks above adjacent postcode.
2. Property type match. Detached with detached, semi with semi, flat with flat.
3. Size match. Similar bedroom count, then similar square footage when known.
4. Tenure match. Freehold with freehold, leasehold with leasehold.
5. Condition match if observable. Similar standard of finish, similar age.

The profile's exclude filters apply: distressed sales, off-market sales, agent-bought sales, probate sales, anything the operator has previously asked to exclude.

## Output shape

A table, one row per comparable, six rows total when data permits. Columns:

- Address
- Asking or sold price
- Beds
- Square footage (blank if unknown)
- Time on market in days
- Agent who marketed it

A price-per-square-foot column is added only if at least four of the six rows have square footage. Showing it on a sparse set is misleading.

If the radius is too tight to return three SSTC plus three sold, the skill widens the radius once and notes it in the output: "extended search to 0.75 miles to find six comparables".

## What it does not do

- It does not produce price recommendations. That is `pricing-scenario-builder`.
- It does not write to anything.
- It does not store the comparables for re-use; each appointment runs fresh, with the Pi 5 cache providing the speed.

## Connectors

Read: Rightmove, Zoopla, OnTheMarket data feeds; Land Registry. No writes.

## Profile keys

- `realagent.comparable_radius_miles` (default 0.5)
- `realagent.comparable_exclude_filters` (list)
