brickwise 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 eljommys
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# 🧱 Brickwise
+
+App web local (Next.js) para buscar inmuebles en venta en [Property Finder UAE](https://www.propertyfinder.ae) y analizar su **rentabilidad bruta de alquiler** con el histórico real de transacciones DLD (compra y alquiler) del propio edificio.
+
+## Arranque en un comando
+
+App **100% local**: el servidor y la base de datos corren en tu máquina, sin nube. Solo necesitas
+tener [Node.js](https://nodejs.org) 18.18+ instalado.
+
+```bash
+npx brickwise
+```
+
+Eso es todo: **instala las dependencias y arranca** (la primera vez tarda ~1 min instalando),
+elige un puerto libre y abre la app en tu navegador. No hay nada más que configurar.
+
+<details>
+<summary>¿Prefieres clonarlo?</summary>
+
+```bash
+git clone https://github.com/eljommys/brickwise.git
+cd brickwise
+npm install
+npm run dev      # → http://localhost:3000
+```
+</details>
+
+### Base de datos local
+
+Todo (favoritos, análisis, transacciones, ubicaciones, gimnasios) se guarda en un único fichero
+**SQLite** en **`~/.brickwise/brickwise.db`** (en tu carpeta de usuario). Se crea solo al primer uso
+y **persiste entre reinicios y actualizaciones**. Para copia de seguridad o mover tus datos, basta con
+**copiar ese fichero**. Puedes cambiar su ubicación con la variable de entorno `BRICKWISE_DB`.
+
+## Qué hace
+
+- **/search** — buscador con filtros: ubicación (autocompletado local con las +16k ubicaciones de PF), precio, superficie, habitaciones, baños, tipo, amenities (gimnasio, parking, piscina…) y distancia máxima al gimnasio externo más cercano (OpenStreetMap).
+- Cada resultado se analiza en segundo plano: se scrapea la ficha del anuncio y el histórico completo de transacciones de su torre (`/en/transactions/{buy|rent}/dubai/{torre}`), y se calcula:
+  - **Rentabilidad bruta** = mediana de rentas anuales (últimos 24 meses, mismas habitaciones) / precio del anuncio.
+  - **Valor de mercado estimado** = mediana AED/sqft de ventas × superficie, y % de prima/descuento del precio frente a ese valor.
+  - **Distancia al gimnasio más cercano** vía Overpass (OSM), con caché.
+- **/listing/[id]** — ficha con galería de fotos, métricas desglosadas, tablas de transacciones de venta y alquiler del edificio y enlace al anuncio original.
+- **/** — dashboard persistente con todo lo analizado, ordenable por rentabilidad, precio, prima vs mercado o distancia al gym.
+
+## Cómo scrapea
+
+Property Finder es una app Next.js: cada página embebe sus datos en `<script id="__NEXT_DATA__">`. Basta un `fetch` con User-Agent de navegador (sin headless):
+
+- Búsqueda: `/en/search?l={locId}&c=1&pf=&pt=&af=&at=&bdr[]=&am[]=&t=&page=`
+- Ficha: `share_url` del anuncio → `propertyResult.property` (incluye `similar_price_transactions` como fallback).
+- Transacciones: `/en/transactions/{buy|rent}/dubai/{slug}?page=` (paginado, tope 10 págs por tipo).
+- Ubicaciones: `/api/pwa/location/list` (~7,5k filas) + ancestros derivados de los paths → tabla `locations`.
+
+Scraping educado: cola global a **1 req/s**, retry con backoff, caché en SQLite (transacciones 7 días, gimnasios 30 días, análisis 24 h).
+
+## Estructura
+
+```
+src/lib/pf/        cliente HTTP, parser __NEXT_DATA__, search, listing, transactions, locations
+src/lib/yield.ts   cálculo de rentabilidad (medianas, ventana 24 meses, muestra por habitaciones/tamaño)
+src/lib/gyms.ts    gimnasio más cercano vía Overpass/OSM con caché
+src/lib/db.ts      SQLite (better-sqlite3) + esquema
+src/app/api/       /api/search, /api/listing/[id], /api/locations, /api/dashboard
+src/app/           páginas: dashboard, search, listing/[id]
+```
+
+## Notas
+
+- Uso personal/local. Respeta los términos de Property Finder: no elevar el rate-limit ni desplegarlo público.
+- La rentabilidad es **bruta** (sin service charges, vacancy ni costes de compra). Los tamaños muestrales (`N tx`) se muestran como indicador de confianza.

package/bin/brickwise.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/* eslint-disable */
+"use strict";
+
+// Zero-config launcher for Brickwise.
+// Run directly (`npx github:eljommys/brickwise`) or after cloning (`node bin/brickwise.js`).
+//
+// npx installs the package nested under ~/.npm/_npx/<hash>/ next to its own
+// lockfile, which confuses Next's workspace-root detection (breaking module
+// resolution and the bundler). To avoid that entirely we copy the app into a
+// clean, single-lockfile directory (~/.brickwise/app) and run it from there.
+// Data lives in ~/.brickwise/brickwise.db, independent of the app copy.
+
+const { spawnSync, spawn } = require("child_process");
+const fs = require("fs");
+const net = require("net");
+const os = require("os");
+const path = require("path");
+
+const isWin = process.platform === "win32";
+const npm = isWin ? "npm.cmd" : "npm";
+const pkgDir = path.resolve(__dirname, "..");
+const APP = path.join(os.homedir(), ".brickwise", "app");
+
+function step(msg) {
+  process.stdout.write(`\n\x1b[1m\x1b[34m▸ ${msg}\x1b[0m\n`);
+}
+
+function run(cmd, args, cwd) {
+  const r = spawnSync(cmd, args, { cwd, stdio: "inherit", shell: isWin });
+  if (r.status !== 0) {
+    console.error(`\n\x1b[31m✖ Falló: ${cmd} ${args.join(" ")}\x1b[0m`);
+    process.exit(r.status || 1);
+  }
+}
+
+const EXCLUDE = /(^|[\/\\])(node_modules|\.next|\.git|brickwise\.db)/;
+
+function syncSources() {
+  fs.mkdirSync(APP, { recursive: true });
+  fs.cpSync(pkgDir, APP, {
+    recursive: true,
+    filter: (src) => !EXCLUDE.test(path.relative(pkgDir, src)),
+  });
+}
+
+function findFreePort(start) {
+  return new Promise((resolve) => {
+    const srv = net.createServer();
+    srv.once("error", () => resolve(findFreePort(start + 1)));
+    srv.listen(start, () => {
+      const port = srv.address().port;
+      srv.close(() => resolve(port));
+    });
+  });
+}
+
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? "open" : isWin ? "start" : "xdg-open";
+  try {
+    spawn(cmd, [url], { stdio: "ignore", detached: true, shell: isWin });
+  } catch {
+    /* the printed URL is enough */
+  }
+}
+
+(async () => {
+  // If already launched from inside the clean copy, run in place; otherwise sync.
+  const inPlace = path.resolve(pkgDir) === path.resolve(APP);
+  const workdir = inPlace ? pkgDir : APP;
+
+  if (!inPlace) {
+    step("Preparando la app…");
+    syncSources();
+  }
+
+  if (!fs.existsSync(path.join(workdir, "node_modules", "next"))) {
+    step("Instalando dependencias (solo la primera vez, ~1 min)…");
+    run(npm, ["install", "--include=dev", "--no-audit", "--no-fund"], workdir);
+  }
+
+  const port = await findFreePort(Number(process.env.PORT) || 3000);
+  const url = `http://localhost:${port}`;
+
+  step(`Arrancando Brickwise en ${url}`);
+  console.log("  (Ctrl+C para parar · tus datos se guardan en ~/.brickwise/brickwise.db)\n");
+
+  const child = spawn(npm, ["run", "dev", "--", "-p", String(port)], {
+    cwd: workdir,
+    stdio: "inherit",
+    shell: isWin,
+  });
+
+  setTimeout(() => openBrowser(url), 2500);
+
+  const stop = () => child.kill("SIGINT");
+  process.on("SIGINT", stop);
+  process.on("SIGTERM", stop);
+  child.on("exit", (code) => process.exit(code || 0));
+})();

package/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/next.config.ts

@@ -0,0 +1,14 @@
+import type { NextConfig } from "next";
+
+// Pin the workspace root to the current directory. Without it, running via `npx`
+// (which nests the package under ~/.npm/_npx/<hash>/ with its own lockfile) makes
+// Next pick the wrong root and Turbopack fails to build /page. The launcher and the
+// npm scripts always run from the app directory, so process.cwd() is the app root.
+const root = process.cwd();
+
+const nextConfig: NextConfig = {
+  turbopack: { root },
+  outputFileTracingRoot: root,
+};
+
+export default nextConfig;

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "brickwise",
+  "version": "0.1.0",
+  "description": "App local para analizar la rentabilidad de alquiler de inmuebles de Property Finder UAE con el histórico real de transacciones DLD.",
+  "license": "MIT",
+  "author": "eljommys",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eljommys/brickwise.git"
+  },
+  "homepage": "https://github.com/eljommys/brickwise#readme",
+  "keywords": [
+    "property-finder",
+    "dubai",
+    "real-estate",
+    "rental-yield",
+    "scraper",
+    "nextjs"
+  ],
+  "bin": {
+    "brickwise": "bin/brickwise.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "public/",
+    "next.config.ts",
+    "postcss.config.mjs",
+    "eslint.config.mjs",
+    "tsconfig.json",
+    "package-lock.json"
+  ],
+  "engines": {
+    "node": ">=18.18"
+  },
+  "scripts": {
+    "dev": "next dev --webpack",
+    "build": "next build --webpack",
+    "start": "next start",
+    "app": "next build --webpack && next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.11.1",
+    "leaflet": "^1.9.4",
+    "next": "16.2.10",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/leaflet": "^1.9.21",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.10",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

package/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/src/app/api/dashboard/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from "next/server";
+import { listAnalyzed } from "@/lib/store";
+
+export async function GET() {
+  try {
+    const rows = listAnalyzed().map((r) => ({
+      ...r,
+      images: JSON.parse(r.images_json),
+      amenities: JSON.parse(r.amenities_json),
+    }));
+    return NextResponse.json({ results: rows });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}

package/src/app/api/favorites/route.ts

@@ -0,0 +1,71 @@
+import { NextRequest, NextResponse } from "next/server";
+import { analyzeListing } from "@/lib/analyze";
+import { addFavorite, listFavorites, removeFavorite, setFavoriteNotes } from "@/lib/store";
+
+function serialize(rows: ReturnType<typeof listFavorites>) {
+  return rows.map((r) => ({
+    ...r,
+    images: JSON.parse(r.images_json),
+    amenities: JSON.parse(r.amenities_json),
+  }));
+}
+
+export async function GET() {
+  try {
+    return NextResponse.json({ results: serialize(listFavorites()) });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}
+
+/** Accepts any propertyfinder.ae listing URL and extracts the numeric listing id. */
+function parseListingUrl(raw: string): { id: string; url: string } {
+  let url: URL;
+  try {
+    url = new URL(raw.trim());
+  } catch {
+    throw new Error("URL no válida");
+  }
+  if (!/(^|\.)propertyfinder\.ae$/.test(url.hostname)) {
+    throw new Error("La URL debe ser de propertyfinder.ae");
+  }
+  const m = url.pathname.match(/-(\d+)\.html$/) || url.pathname.match(/\/(\d+)(?:\/)?$/);
+  if (!m) throw new Error("No encuentro el id del anuncio en la URL (pega el enlace de la ficha del inmueble)");
+  return { id: m[1], url: url.origin + url.pathname };
+}
+
+export async function POST(req: NextRequest) {
+  try {
+    const body = await req.json();
+    const { id, url } = parseListingUrl(String(body.url || ""));
+    const { listing, analysis } = await analyzeListing(id, url);
+    addFavorite(listing.id);
+    return NextResponse.json({
+      listing: { ...listing, images: JSON.parse(listing.images_json), amenities: JSON.parse(listing.amenities_json) },
+      analysis,
+    });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 400 });
+  }
+}
+
+export async function PATCH(req: NextRequest) {
+  try {
+    const body = await req.json();
+    setFavoriteNotes(String(body.id), String(body.notes ?? ""));
+    return NextResponse.json({ ok: true });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 400 });
+  }
+}
+
+export async function DELETE(req: NextRequest) {
+  try {
+    const id = req.nextUrl.searchParams.get("id");
+    if (!id) throw new Error("id requerido");
+    removeFavorite(id);
+    return NextResponse.json({ ok: true });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 400 });
+  }
+}

package/src/app/api/gyms/route.ts

@@ -0,0 +1,30 @@
+import { NextResponse } from "next/server";
+import { gymsNear } from "@/lib/gyms";
+import { listFavorites } from "@/lib/store";
+
+/** All gyms within 2 km of every located favorite, deduplicated. */
+export async function GET() {
+  try {
+    const favorites = listFavorites().filter((f) => f.lat != null && f.lon != null);
+    const seen = new Map<string, { name: string; lat: number; lon: number }>();
+    let failed = 0;
+    for (const f of favorites) {
+      const gyms = await gymsNear(f.lat!, f.lon!);
+      if (gyms == null) {
+        failed++;
+        continue;
+      }
+      for (const g of gyms) {
+        const key = `${g.lat.toFixed(5)},${g.lon.toFixed(5)}`;
+        if (!seen.has(key)) seen.set(key, { name: g.name, lat: g.lat, lon: g.lon });
+      }
+    }
+    return NextResponse.json({
+      gyms: [...seen.values()],
+      favoritesQueried: favorites.length,
+      failed,
+    });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}

package/src/app/api/listing/[id]/route.ts

@@ -0,0 +1,30 @@
+import { NextRequest, NextResponse } from "next/server";
+import { analyzeListing } from "@/lib/analyze";
+import { getTransactions } from "@/lib/pf/transactions";
+
+export async function GET(req: NextRequest, ctx: { params: Promise<{ id: string }> }) {
+  const { id } = await ctx.params;
+  const url = req.nextUrl.searchParams.get("url") || undefined;
+  const force = req.nextUrl.searchParams.get("force") === "1";
+  const withTx = req.nextUrl.searchParams.get("tx") === "1";
+  try {
+    const { listing, analysis } = await analyzeListing(id, url, force);
+    return NextResponse.json({
+      listing: {
+        ...listing,
+        images: JSON.parse(listing.images_json),
+        amenities: JSON.parse(listing.amenities_json),
+      },
+      analysis,
+      transactions:
+        withTx && listing.tower_slug
+          ? {
+              buy: getTransactions(listing.tower_slug, "buy"),
+              rent: getTransactions(listing.tower_slug, "rent"),
+            }
+          : null,
+    });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}

package/src/app/api/locations/route.ts

@@ -0,0 +1,13 @@
+import { NextRequest, NextResponse } from "next/server";
+import { searchLocations } from "@/lib/pf/locations";
+
+export async function GET(req: NextRequest) {
+  const q = req.nextUrl.searchParams.get("q") || "";
+  if (q.trim().length < 2) return NextResponse.json({ locations: [] });
+  try {
+    const locations = await searchLocations(q);
+    return NextResponse.json({ locations });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}

package/src/app/api/recompute/route.ts

@@ -0,0 +1,28 @@
+import { NextResponse } from "next/server";
+import { getDb } from "@/lib/db";
+import { getTransactions } from "@/lib/pf/transactions";
+import { computeYield } from "@/lib/yield";
+import { getAnalysis, saveAnalysis } from "@/lib/store";
+import { ListingRow } from "@/lib/types";
+
+/** Recompute every stored analysis from the cached transactions (no scraping). */
+export async function POST() {
+  try {
+    const db = getDb();
+    const listings = db
+      .prepare(`SELECT l.* FROM listings l JOIN analyses a ON a.listing_id = l.id`)
+      .all() as ListingRow[];
+    let updated = 0;
+    for (const l of listings) {
+      const buy = l.tower_slug ? getTransactions(l.tower_slug, "buy") : [];
+      const rent = l.tower_slug ? getTransactions(l.tower_slug, "rent") : [];
+      const y = computeYield(l.price, l.size_sqft, l.bedrooms, buy, rent);
+      const prev = getAnalysis(l.id);
+      saveAnalysis(l.id, y, { gym_name: prev?.gym_name ?? null, distance_m: prev?.gym_distance_m ?? null });
+      updated++;
+    }
+    return NextResponse.json({ updated });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}

package/src/app/api/search/route.ts

@@ -0,0 +1,26 @@
+import { NextRequest, NextResponse } from "next/server";
+import { scrapeSearch } from "@/lib/pf/search";
+import { getAnalysis, upsertListing } from "@/lib/store";
+import { dedupeListings } from "@/lib/dedupe";
+import { SearchFilters } from "@/lib/types";
+
+export async function POST(req: NextRequest) {
+  try {
+    const filters = (await req.json()) as SearchFilters;
+    const { properties, totalCount } = await scrapeSearch(filters);
+    const rows = properties.map((p) => upsertListing(p));
+    // Collapse the same physical unit listed by several agents.
+    const { unique, removed } = dedupeListings(rows);
+    const results = unique.map((row) => ({
+      ...row,
+      images: JSON.parse(row.images_json),
+      amenities: JSON.parse(row.amenities_json),
+      // Cached analysis only — nothing is scraped here; the user analyzes on demand.
+      analysis: getAnalysis(row.id),
+    }));
+    return NextResponse.json({ totalCount, count: results.length, duplicatesRemoved: removed, results });
+  } catch (e) {
+    console.error("search failed:", e);
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}