io.github.chrischall由 GitHub 账号 chrischall 发布v1.2.0更新于 Nov 7, 2026
Hemnet.se real estate for Claude: search, sold prices, listings & market stats
检索瑞典最大房产门户 hemnet.se，让助手查找在售与已售房源、获取详情和照片、统计市场行情，并做瑞典房贷月供计算。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
An MCP server for hemnet.se, Sweden's largest real-estate portal. Search for-sale listings, look up sold prices (slutpriser), pull full listing detail and photos, compute market statistics, resolve addresses, and run a Swedish mortgage calculation — all from Claude.
⚠️ This project is built and maintained by AI (Claude). It reads hemnet.se through its public GraphQL API. Use at your own discretion and within hemnet.se's terms of service.
npx hemnet-mcp just works (a browser extension is
only needed if Hemnet serves a Cloudflare challenge — see below).bostadsrätt
fees (avgift), energy class, and a mortgage model that follows Swedish
rules (amorteringskrav, ränteavdrag).Hemnet sometimes fronts its GraphQL API with a Cloudflare bot challenge.
When that happens the server switches (under the default
HEMNET_TRANSPORT=auto) to a browser bridge that sends the same anonymous
queries from a www.hemnet.se tab in your own browser — no Hemnet login
needed. That needs the ContextMint Bridge extension, installed from
its releases:
in Chrome, unzip the chrome zip and load it unpacked, then approve the
pairing prompt the first time. Safari isn't available yet (it will ship
inside the ContextMint app, which has no public download), so use Chrome
for now.
ContextMint Bridge is the fetchproxy browser extension under its new name,
from the same maintainer — fetchproxy's own README
(https://github.com/chrischall/fetchproxy#extension) points to it. Its source
is public at https://github.com/nullnet-app/contextmint-bridge: build it
yourself, or check a release zip against the .sha256 file published beside
it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).
Or pass a free-text location to any search tool and it resolves the top
hit for you.
All output records use numbers: price / final_price /
fee_monthly in SEK, living_area_sqm / land_area_sqm in m², rooms
as a number. A derived price_per_sqm is always included when price and
living area allow it (even when Hemnet omits it, common on houses). The
original Hemnet-formatted strings are kept alongside as *_formatted.
hemnet-mcp is also importable, so it can serve as a Hemnet portal source inside a larger project (e.g. a cross-portal realty orchestrator):
The library entry (import … from 'hemnet-mcp') re-exports the client,
the normalised record types, the pure derivations
(computeMarketStats, calculateSwedishMortgage, money/url helpers),
and every tool registrar (registerHemnetTools(server, client) to graft
the tools onto your own MCP server).
Tests drive every tool and the client through an in-memory fake
transport — no live hemnet.se calls. See CLAUDE.md for architecture,
the GraphQL quirks, and contribution conventions.
MIT
来源：README.md，提交 1c70117
Resolve a place name to Hemnet location ids
Look up Hemnet location ids for a free-text place name (municipality, district, or area). Returns ranked hits with `location_id`, `full_name`, and `parent_full_name`. Feed a `location_id` into hemnet_search_listings / hemnet_search_sold. Read-only.
limitquery必填Search Hemnet for-sale listings
Search active for-sale property listings on hemnet.se by location and optional filters (price band in SEK, rooms, living area in m², property-type groups, keywords). Returns listing summaries with price, fee, m², rooms, price-per-m², and coordinates. Provide `location_ids` (from hemnet_autocomplete_location) or a free-text `location`. Read-only.
sortlimitoffsetkeywordslocationprice_maxprice_minrooms_maxrooms_minlocation_idsliving_area_maxliving_area_min另有 1 个Get a Hemnet for-sale listing by id or URL
Fetch the full detail of a single active for-sale listing by its Hemnet id or a /bostad/ URL. Returns price, monthly fee, yearly running costs, living/land area in m², rooms, tenure, construction year, energy class, broker, description, status labels, coordinates, and gallery photo URLs. For a SOLD listing use hemnet_get_sold_listing instead. Read-only.
id必填photo_limitGet photo URLs for a Hemnet listing
Return the gallery photo URLs for an active for-sale Hemnet listing by id or /bostad/ URL. Read-only.
id必填limitSearch Hemnet sold listings (slutpriser)
Search SOLD property listings ("slutpriser") on hemnet.se by location and optional filters. Each result carries the achieved final price, the asking price, and the over/under-asking percentage — the core comps signal for valuation. Provide `location_ids` (from hemnet_autocomplete_location) or a free-text `location`. Read-only.
sortlimitoffsetkeywordslocationprice_maxprice_minrooms_maxrooms_minlocation_idsliving_area_maxliving_area_min另有 1 个Get a Hemnet sold listing by id or URL
Fetch the full detail of a single SOLD listing by its Hemnet id or a /salda/ URL. Returns final price, asking price, price change, m², rooms, tenure, broker, and coordinates. Read-only.
id必填Compare several Hemnet listings
Fetch and normalise multiple active for-sale Hemnet listings at once (by id or /bostad/ URL) for side-by-side comparison. Up to 20 targets; input order preserved; per-row errors captured. Read-only.
ids必填Resolve a street address to a Hemnet listing
Resolve a free-text Swedish street address to a live Hemnet for-sale listing. Give the `address` (street + number) and a `location` (city/area/municipality). Returns the matched listing with a `matched: true`, the match `score`, and `matched_via`, or `{ resolved: false }` when nothing matches. Scans up to 500 listings in the location; a miss with `truncated: true` is not definitive — pass price_min/price_max or a smaller location to narrow it. Read-only.
address必填location必填price_maxprice_minHemnet sold-price market statistics
Aggregate median/average statistics from recent SOLD listings for a location (and optional property-type/size filters): median & average final price, median & average price-per-m², and average over/under-asking percentage. The stats cover the most recent `max_sales` sales (default 200, max 500), not necessarily every match — compare `sampled_sales` with `total_matching_sales`. Provide `location_ids` or a free-text `location`. Read-only.
sortlimitoffsetkeywordslocationmax_salesprice_maxprice_minrooms_maxrooms_minlocation_idsliving_area_max另有 2 个Calculate a Swedish monthly mortgage cost
Local-only Swedish mortgage calculator (all amounts SEK). Returns the monthly cost broken into interest, mandated amortisation (amorteringskrav from LTV, rules as of 1 April 2026), BRF fee (avgift), and operating cost — with both gross and after-tax (ränteavdrag) totals. Provide `down_payment` OR `down_payment_percent` (defaults to the legal 10% minimum). No network call.
price必填monthly_feedown_paymentinterest_rate必填amortization_rategross_yearly_incomedown_payment_percentmonthly_operating_costVerify the ContextMint Bridge connection end-to-end
Round-trips a small public www.hemnet.se URL (/graphql) through ContextMint Bridge (your signed-in browser tab) and returns diagnostics: the bridge's role (host/peer/null), port, version, the extension link (linked / pair pending / not attached / never answered), the elapsed round-trip time, and a plain-English hint distinguishing 'bridge never came up' from 'extension not connected' from 'this browser can't serve a capability' from 'real www.hemnet.se-side problem'. Read-only, no auth required. Call this when a real tool fails and you want to know which hop broke.
无需输入参数。
已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
{ "mcpServers": { "hemnet": { "command": "npx", "args": ["-y", "hemnet-mcp"] } }}git clone https://github.com/chrischall/hemnet-mcpcd hemnet-mcpnpm installnpm run buildnode dist/index.js1. hemnet_autocomplete_location { query: "Vasastan" } → location_id 9259702. hemnet_search_listings { location_ids: ["925970"], rooms_min: 2, price_max: 6000000 } → listing summaries3. hemnet_get_market_stats { location_ids: ["925970"], housing_form_groups: ["APARTMENTS"] } → median final price, price-per-m²4. hemnet_calculate_mortgage { price: 4695000, interest_rate: 3.9, monthly_fee: 2800 } → monthly cost, gross and after-taximport { createHemnetClient, computeMarketStats } from 'hemnet-mcp';
const hemnet = createHemnetClient();const { cards } = await hemnet.searchSales({ locationIds: ['925970'] }, { limit: 50 });const stats = computeMarketStats(cards.map(formatSaleCard));npm test # vitest (mocked transport, no network)npm run test:coverage # 100% coverage enforced on src/**npm run typechecknpm run build