Booli (booli.se)

Tools for the Swedish property portal Booli, reading its consumer GraphQL API. Money is in SEK, areas in m², rooms as a number.

Setup — the browser bridge

booli.se is behind a Cloudflare bot wall that blocks server-side requests, so booli-mcp routes each query through your own signed-in www.booli.se browser tab via the fetchproxy bridge (the ContextMint Bridge extension). No Booli login is needed — just a normal, Cloudflare-cleared page view.

• Install ContextMint Bridge from https://github.com/nullnet-app/contextmint-bridge/releases (Chrome: load the chrome zip unpacked; Safari isn't available yet — use Chrome for now) and keep a www.booli.se tab open in that browser. On the first request, approve the one-time pairing prompt. It's the fetchproxy extension renamed, same maintainer; source at https://github.com/nullnet-app/contextmint-bridge (build it, or verify a release zip with its published .sha256).
• BOOLI_TRANSPORT picks the path: auto (default — tries a direct fetch first, falls back to the bridge when walled), fetchproxy (always the bridge), direct (fail if walled). The fleet shares WS port 37149 (BOOLI_WS_PORT).
• Run booli_healthcheck to confirm the path is working.

Start with an area

Booli's searches scope by a numeric area id, not a place name. Resolve first, or pass a free-text location and the search tools resolve the top hit for you.

1. booli_search_areas — { query: "Nacka" } → areas with area_id and display_name. Pass an area_id into the search tools.

For-sale listings

• booli_search_listings — search active listings by area_id or free-text location, plus optional min_list_price/max_list_price (SEK), min_list_sqm_price/max_list_sqm_price, min_rooms/max_rooms, min_living_area/max_living_area (m²), min_plot_area/max_plot_area, object_type (comma-separated: Lägenhet, Villa, Kedjehus-Parhus-Radhus, Fritidshus, Gård, Tomt/Mark), min_construction_year/max_construction_year, is_new_construction, sort + ascending. Paginated by page — check total_count/pages. Returns slim summaries by default (compact: false for full raw records).
• booli_get_listing — full detail for one property by its residence id (the number in a booli.se/bostad/ URL, or a result's residence_id). Works for both active and sold properties.

Sold prices (slutpriser) — the comparables

• booli_search_sold — sold properties with the achieved sold price, sold date, and over/under-asking %. Same scope/filters as the for-sale search, plus min_sold_price/max_sold_price, min_sold_sqm_price/max_sold_sqm_price, and min_sold_date/max_sold_date (YYYYMMDD). sort also accepts soldDate/soldPrice; the default is soldDate descending (most recent sales first), as for booli_market_stats.
• booli_market_stats — median/average sold price, price per m², and average over/under-asking % for an area (same filters as the sold search, over ONE page — page/pages say which; total_count is the whole matching set, not the sample). sample_size is the rows on the page and sold_price_count/price_per_sqm_count/price_change_count the rows behind each metric — check them before trusting a thin median.

Diagnostics

• booli_healthcheck — one-call probe of the data path (direct or bridge).

All tools are read-only.