boliga

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Boliga Skill

Boliga Skill

Access live Danish property data from the Boliga.dk public API. No authentication needed. Covers ~42,000 active listings, ~1.8 million sold records, and comprehensive BBR building data.
通过Boliga.dk公开API获取丹麦实时房产数据,无需身份验证。涵盖约42,000条有效房源、约180万条已售记录,以及全面的BBR建筑数据。

When to use this skill

何时使用该Skill

Invoke this skill when the user wants to:
  • Search for homes, apartments, or other properties currently for sale in Denmark
  • Find recent property sales and sold prices in a Danish area or address
  • Look up the full history of a specific Danish address (BBR, prior sales, valuations)
  • Get real-time Danish housing market statistics (total listings, price drops, new today)
  • Analyse historical price trends by property type, zip code, or area
  • Find the most-viewed active listings on the market
  • Autocomplete or resolve a Danish address, street, zip code, or city name
  • Compare asking price vs. sold price (the
    change
    field in sold results)
当用户需要以下服务时,调用该Skill:
  • 搜索丹麦当前在售的住宅、公寓或其他房产
  • 查询丹麦某区域或地址的近期房产成交记录及成交价
  • 查看丹麦特定地址的完整历史信息(BBR数据、过往成交记录、估值)
  • 获取丹麦住房市场实时统计数据(总房源量、降价房源、新增房源等)
  • 按房产类型、邮政编码或区域分析历史价格趋势
  • 查找市场上浏览量最高的有效房源
  • 自动补全或解析丹麦地址、街道、邮政编码或城市名称
  • 对比挂牌价与成交价(已售结果中的
    change
    字段)

Commands

命令

Search for-sale properties

搜索在售房产

bash
bun run skills/boliga/cli/src/cli.ts search [flags]
Key flags:
  • --zip-codes <codes>
    — e.g.
    2100,2200
  • --municipality <code>
    — e.g.
    101
    for Copenhagen
  • --property-type <code>
    — 1=Villa, 2=Townhouse, 3=Apartment, 4=Holiday, 5=Co-op, 6=Residential plot, 7=Holiday plot, 8=Farm, 9=Other
  • --price-min / --price-max
    — DKK
  • --size-min / --size-max
    — m²
  • --rooms <n>
  • --build-year-min / --build-year-max
  • --energy-class <classes>
    — e.g.
    a,b,c
  • --sort <order>
    date-d
    (default),
    views-d
    ,
    price-a
    ,
    price-d
    ,
    sqmPrice-a
    ,
    sqmPrice-d
    ,
    daysForSale-d
  • --page / --page-size / --limit
  • --format json|table|plain
bash
bun run skills/boliga/cli/src/cli.ts search [flags]
关键参数:
  • --zip-codes <codes>
    — 示例:
    2100,2200
  • --municipality <code>
    — 示例:
    101
    (哥本哈根)
  • --property-type <code>
    — 1=独栋别墅(Villa)、2=联排别墅(Townhouse)、3=公寓(Apartment)、4=度假屋(Holiday)、5=合作公寓(Co-op)、6=住宅用地(Residential plot)、7=度假用地(Holiday plot)、8=农场(Farm)、9=其他(Other)
  • --price-min / --price-max
    — 丹麦克朗(DKK)
  • --size-min / --size-max
    — 平方米(m²)
  • --rooms <n>
    — 房间数量
  • --build-year-min / --build-year-max
    — 建造年份范围
  • --energy-class <classes>
    — 示例:
    a,b,c
  • --sort <order>
    date-d
    (默认,按发布日期降序)、
    views-d
    (按浏览量降序)、
    price-a
    (按价格升序)、
    price-d
    (按价格降序)、
    sqmPrice-a
    (按每平米价格升序)、
    sqmPrice-d
    (按每平米价格降序)、
    daysForSale-d
    (在售天数降序)
  • --page / --page-size / --limit
    — 分页参数
  • --format json|table|plain
    — 输出格式

Search sold properties

搜索已售房产

bash
bun run skills/boliga/cli/src/cli.ts sold [flags]
Same location/size/type filters as
search
, plus:
  • --sort
    soldDate-d
    (default),
    price-d
    ,
    price-a
    ,
    sqmPrice-d
Do not use
soldDate-a
— the API returns HTTP 500 for ascending sold date sort.
When using
--zip-codes
with
sold
, filtering is done client-side (the API does not support it natively). The CLI fetches in batches of 100 and filters locally — it may be slower than
search
with zip codes.
bash
bun run skills/boliga/cli/src/cli.ts sold [flags]
拥有与
search
相同的位置/面积/类型筛选参数,额外参数:
  • --sort
    soldDate-d
    (默认,按成交日期降序)、
    price-d
    (按成交价降序)、
    price-a
    (按成交价升序)、
    sqmPrice-d
    (按每平米成交价降序)
请勿使用
soldDate-a
——API会返回HTTP 500错误。
当在
sold
命令中使用
--zip-codes
时,筛选是在客户端完成的(API本身不支持该筛选)。CLI会批量获取100条记录并本地筛选——这可能比带邮编筛选的
search
命令速度慢。

Full listing detail

完整房源详情

bash
bun run skills/boliga/cli/src/cli.ts detail <id> [--format json|plain]
id
is the numeric estate ID from
search
results. Returns full listing with agent info, images, connectivity data (4G/5G), and cadastral info.
bash
bun run skills/boliga/cli/src/cli.ts detail <id> [--format json|plain]
id
search
结果中的数字房源ID。返回包含中介信息、图片、网络连接数据(4G/5G)和地籍信息的完整房源详情。

Comprehensive address data (BBR + history + valuations)

全面地址数据(BBR + 历史记录 + 估值)

bash
bun run skills/boliga/cli/src/cli.ts property <ouId> [--format json|plain]
ouId
is the ownership unit ID — stable across listing cycles, returned as
ouId
in all search/detail results. This endpoint returns everything about a physical address: current listing, BBR building data, all prior sales, all prior listings, and official valuations.
bash
bun run skills/boliga/cli/src/cli.ts property <ouId> [--format json|plain]
ouId
是所有权单元ID——在房源多次挂牌周期中保持稳定,会在所有search/detail结果中返回为
ouId
。该端点返回某物理地址的所有信息:当前挂牌信息、BBR建筑数据、所有过往成交记录、所有过往挂牌记录以及官方估值。

Location autocomplete

位置自动补全

bash
bun run skills/boliga/cli/src/cli.ts suggestions --query "<text>" [--area-limit 10] [--address-limit 10]
Use this to resolve an address, street, city, or zip code into structured IDs before passing them to other commands.
bash
bun run skills/boliga/cli/src/cli.ts suggestions --query "<text>" [--area-limit 10] [--address-limit 10]
使用该命令将地址、街道、城市或邮政编码解析为结构化ID,再传入其他命令中使用。

Market snapshot

市场快照

bash
bun run skills/boliga/cli/src/cli.ts stats [--format json|plain]
Returns real-time counts: total for-sale listings, new today, price drops today, foreclosures, etc.
bash
bun run skills/boliga/cli/src/cli.ts stats [--format json|plain]
返回实时统计数据:总在售房源量、当日新增房源、当日降价房源、法拍房数量等。

Quarterly price index

季度价格指数

bash
bun run skills/boliga/cli/src/cli.ts prices [--property-type <n>] [--area-type zip] [--area-id <zip>] [--limit <n>]
RKR (Realkreditrådet) quarterly data back to ~1992. Filter by property type and zip code area.
bash
bun run skills/boliga/cli/src/cli.ts prices [--property-type <n>] [--area-type zip] [--area-id <zip>] [--limit <n>]
提供RKR(Realkreditrådet)自1992年左右以来的季度数据。可按房产类型和邮政编码区域筛选。

Most viewed listings

浏览量最高的房源

bash
bun run skills/boliga/cli/src/cli.ts mostviewed [--page <n>] [--page-size <n>] [--limit <n>]

bash
bun run skills/boliga/cli/src/cli.ts mostviewed [--page <n>] [--page-size <n>] [--limit <n>]

How to use effectively

高效使用技巧

Resolve locations first. Use
suggestions
to find the correct zip code or municipality code before passing them to
search
or
sold
:
bash
bun run skills/boliga/cli/src/cli.ts suggestions --query "Nørrebro" --format plain
Natural workflow:
search
detail
property
.
  1. Use
    search
    to get a list of matching estates with their
    id
    and
    ouId
    .
  2. Call
    detail <id>
    to get the full listing with agent info and images.
  3. Call
    property <ouId>
    to get the complete address history (all prior sales, BBR data, valuations).
Use
--format table
for comparisons
,
--format json
for data processing, and
--format plain
for single-record detail views.
Pagination:
--page-size
controls server-side results per page.
--limit
caps what the CLI outputs regardless of page size. Use
--page
+
--page-size
to iterate through large result sets.
ouId vs id:
id
identifies a specific listing (changes each time a property is re-listed).
ouId
identifies the physical address and is stable — use it for
property
to get the full history.

先解析位置信息。在将邮政编码或市政代码传入
search
sold
命令前,使用
suggestions
命令找到正确的代码:
bash
bun run skills/boliga/cli/src/cli.ts suggestions --query "Nørrebro" --format plain
推荐工作流:
search
detail
property
  1. 使用
    search
    获取匹配房源的
    id
    ouId
    列表。
  2. 调用
    detail <id>
    获取包含中介信息和图片的完整房源详情。
  3. 调用
    property <ouId>
    获取该地址的完整历史记录(所有过往成交、BBR数据、估值)。
使用
--format table
进行对比
--format json
用于数据处理,
--format plain
用于单条记录详情查看。
分页
--page-size
控制服务器端每页返回的结果数量。
--limit
限制CLI输出的结果总数,与每页大小无关。使用
--page
+
--page-size
遍历大量结果集。
ouId vs id
id
标识某一特定挂牌(房产重新挂牌时会变化)。
ouId
标识物理地址且保持稳定——使用它调用
property
命令获取完整历史记录。

Usage examples

使用示例

What's for sale in Copenhagen's 2100 zip code?

哥本哈根2100邮编区域有哪些在售房源?

bash
bun run skills/boliga/cli/src/cli.ts search \
  --zip-codes 2100 \
  --sort date-d \
  --page-size 10 \
  --format table
bash
bun run skills/boliga/cli/src/cli.ts search \
  --zip-codes 2100 \
  --sort date-d \
  --page-size 10 \
  --format table

Apartments under 3M DKK in Copenhagen

哥本哈根300万丹麦克朗以下的公寓

bash
bun run skills/boliga/cli/src/cli.ts search \
  --municipality 101 \
  --property-type 3 \
  --price-max 3000000 \
  --sort price-a \
  --format table
bash
bun run skills/boliga/cli/src/cli.ts search \
  --municipality 101 \
  --property-type 3 \
  --price-max 3000000 \
  --sort price-a \
  --format table

What sold recently in Aarhus?

奥胡斯近期有哪些房产成交?

bash
bun run skills/boliga/cli/src/cli.ts sold \
  --zip-codes 8000,8200,8210 \
  --sort soldDate-d \
  --page-size 10 \
  --format table
bash
bun run skills/boliga/cli/src/cli.ts sold \
  --zip-codes 8000,8200,8210 \
  --sort soldDate-d \
  --page-size 10 \
  --format table

Full history of a specific address

特定地址的完整历史记录

bash
undefined
bash
undefined

First find the ouId from search results, then:

先从搜索结果中找到ouId,然后执行:

bun run skills/boliga/cli/src/cli.ts property 1052179426 --format plain
undefined
bun run skills/boliga/cli/src/cli.ts property 1052179426 --format plain
undefined

How have villa prices trended nationally?

全国独栋别墅价格趋势如何?

bash
bun run skills/boliga/cli/src/cli.ts prices --property-type 1 --limit 20 --format table
bash
bun run skills/boliga/cli/src/cli.ts prices --property-type 1 --limit 20 --format table

What are apartment prices in zip 2200?

2200邮编区域的公寓价格情况?

bash
bun run skills/boliga/cli/src/cli.ts prices \
  --property-type 3 \
  --area-type zip \
  --area-id 2200 \
  --limit 8 \
  --format table
bash
bun run skills/boliga/cli/src/cli.ts prices \
  --property-type 3 \
  --area-type zip \
  --area-id 2200 \
  --limit 8 \
  --format table

Current market overview

当前市场概况

bash
bun run skills/boliga/cli/src/cli.ts stats --format plain
bash
bun run skills/boliga/cli/src/cli.ts stats --format plain

Most talked-about listings right now

当前最受关注的房源

bash
bun run skills/boliga/cli/src/cli.ts mostviewed --page-size 10 --format table

bash
bun run skills/boliga/cli/src/cli.ts mostviewed --page-size 10 --format table

Output formats

输出格式

FormatBest for
json
Default — programmatic use, data processing, passing IDs between commands
table
Quick human-readable overviews and comparisons
plain
Single-record detail views (
detail
,
property
,
stats
)
All errors are written to stderr as
{ "error": "...", "code": "..." }
and the process exits with code
1
.

格式适用场景
json
默认格式——用于程序化调用、数据处理、命令间传递ID
table
快速查看人类可读的概览和对比内容
plain
单条记录详情查看(
detail
property
stats
命令)
所有错误会以
{ "error": "...", "code": "..." }
格式写入stderr,进程将以代码
1
退出。

Notes

注意事项

  • All data is from the public
    api.boliga.dk
    REST API — no credentials required.
  • Pagination is 1-indexed (
    --page 1
    is the first page).
  • The
    maxPage
    field in API responses is capped at 6 (display limitation);
    totalPages
    and
    totalCount
    are accurate.
  • mostviewed
    returns a bare JSON array — no
    meta
    wrapper.
  • The
    change
    field in sold results is the % difference between asking price and sold price.
  • Property images:
    https://i.boliga.org/dk/550x/{first4digits}/{id}.jpg
  • 所有数据均来自公开的
    api.boliga.dk
    REST API——无需凭证。
  • 分页为1起始索引(
    --page 1
    为第一页)。
  • API响应中的
    maxPage
    字段上限为6(显示限制);
    totalPages
    totalCount
    是准确的。
  • mostviewed
    返回纯JSON数组——无
    meta
    包装器。
  • 已售结果中的
    change
    字段是挂牌价与成交价的百分比差值。
  • 房产图片地址:
    https://i.boliga.org/dk/550x/{first4digits}/{id}.jpg