daleads-mcp

DA Leads MCP

DA Leads MCP 让 Claude、Cursor 等 MCP 客户端通过 DA Leads API 查询澳大利亚开发申请和地址级房产情报。

它提供 36 个工具，用于 DA 搜索、规范项目搜索与监控、附近申请/项目查询、市政委员会和类别查询、只读 SQL 分析、通用权益筛选房产情报、受限的公开 Full Property 合约、针对噪声、洪水、丛林火灾和步行便利性的专项筛查、不含评分的 Property Core、Suburb Signals、SA2 情景分析、Neighborhood Context、Solar Resource、免密钥样本以及沙盒地址。

安装

无需全局安装即可运行：

uvx daleads-mcp

或使用 pipx 安装：

pipx install daleads-mcp
daleads-mcp

配置

付费工具需要 DA Leads API 密钥。房产样本工具无需密钥即可使用。

{
  "mcpServers": {
    "da-leads": {
      "command": "uvx",
      "args": ["daleads-mcp"],
      "env": {
        "DALEADS_API_KEY": "dk_live_xxx"
      }
    }
  }
}

DALEADS_API_KEY 是此软件包读取的唯一环境变量。请将其视为机密。它只会发送到固定的官方 HTTPS API 端点 https://daleads.com.au/api。

对于 Claude Code 2.1+，使用以下配置将 stdio 服务添加到当前项目：

claude mcp add --scope project da-leads -- uvx daleads-mcp

免密钥样本工具可立即使用。要使用付费工具，请在已提供 DALEADS_API_KEY 的环境中启动 Claude Code；不要将真实密钥提交到项目 MCP 配置中。

官方 Skills

10 个规范的 Agent Skills 位于 skills/ 中。检出代码库后，Codex 可通过 .agents/skills/ 访问相同文件，Claude Code 则可通过 .claude/skills/ 访问；这两个目录都是相对路径的浅层符号链接，因此只需维护一份指令源。这些 Skills 会指导 Agent 了解主题标识、覆盖范围、归属信息和产品特定限制。它们不会授予 API 使用权益，也不会扩大数据权限。

工具

开发申请

search_das — 按筛选条件搜索澳大利亚开发申请，并按最新申请优先排序。参数：state（NSW、VIC、QLD、SA、WA、TAS、NT、ACT）、council（完整的市政委员会名称，例如 City of Melbourne）、category（行业类别，例如 Renovation / Extension）、suburb（郊区）、postcode（邮政编码）、since（ISO 日期 YYYY-MM-DD，申请日期为该日期或之后）、status_group（pending、advertised、approved、rejected、other）、is_residential（布尔值）、page（默认值为 1）、limit（每页数量，默认值为 20，最大值为 100）。返回 {data: [DA record, ...], meta: {total, page, per_page, pages}}。每条记录包含 id、地址、郊区、邮政编码、市政委员会、州、行业类别、申请日期、状态、状态组、纬度、经度、信息 URL 和文档链接；付费套餐还会提供 description、summary、sub_category、cost_of_development、decision 字段、number_of_dwellings、building_type、storeys 和完整的 documents 列表。任何套餐都不会返回申请人姓名。

get_da — 完整检索一项开发申请。参数：da_id（记录 id，整数，由 search_das 或 nearby_das 返回）。返回 {data: DA record}，字段集与上述相同。

nearby_das — 查找指定坐标一定半径范围内的开发申请，并按距离从近到远排序。参数：lat、lng（WGS84 十进制度数）、radius_km（默认值为 5，最大值为 50）、category、since、status_group、page、limit（最大值为 100）。返回与 search_das 相同的 {data, meta} 结构，每条记录额外包含 distance_km。

list_categories — 列出所有行业类别及其记录数量，用于查找有效的 category 值。无需参数。返回 {data: [{name, slug, is_residential, record_count}, ...], meta: {total}}——类别包括 Renovation / Extension、Swimming Pool / Spa、Granny Flat / Secondary Dwelling 和 Demolition 等。

list_councils — 列出市政委员会及其覆盖范围和数据新鲜度，用于查找有效的 council 值。参数：limit（返回的市政委员会数量上限，默认值为 50）。返回 {data: [{council, state, record_count, last_lodgement, last_fetched}, ...], meta}。

get_stats — 整个数据集的覆盖情况摘要。无需参数。返回 {data: {total_records, records_last_7_days, date_range: {earliest, latest}, by_state: [...], by_category: [...]}}。

sql_query — 执行只读 SQL 查询，以完成筛选工具无法表达的自定义聚合。**仅限 Pro 套餐。**参数：query（针对 das 表执行的单条 SELECT 语句）、params（可选的值列表，用于 %s 占位符）。可用列：id、address、address_suburb、address_postcode、council_name、council_reference、state、trade_category、sub_category、application_type、is_residential、lodgement_date、status、cost_of_development、decision_date、decision_status、on_notice_from、on_notice_to、number_of_dwellings、lot_count、land_use、building_type、storeys、latitude、longitude、data_source、date_fetched、documents、info_url。此处有意不提供 description 和 summary，因为市政委员会的自由文本中可能包含个人联系信息。仅限 SELECT，最多返回 1000 行，超时时间为 10 秒。返回 {columns: [...], rows: [[...], ...], row_count, truncated}。

项目情报

这些工具与所有其他付费工具使用相同的 DALEADS_API_KEY。API 会强制执行密钥的 project_intelligence 权限，以及经过权利审核的字段投影； MCP 软件包不会维护第二份功能列表。

search_projects — 搜索规范项目，而不是独立的 DA 记录。参数：q、state、规范化的 stage、规范化的 project_type、 changed_since（ISO-8601 时间戳）、page 和 limit（最大值为 100）。客户端 会发送服务提供方的规范 per_page 参数。返回包含 contract_version: project-intelligence-v1 的 {data, meta} 封装。

get_project — 获取一个规范项目。参数：project_uid （由 search_projects 返回的稳定标识符）。当前的 v1 响应 包含身份信息、规范化状态、位置、关联申请和项目关系。受权限控制的字段会被省略，而不会表示为覆盖范围 或冲突元数据。

get_project_changes — 获取一个项目的持久变更。参数： project_uid、可选的初始 since、续传 cursor 和 limit （最大值为 100）。每次响应后都要持久保存 meta.cursor。仅当要立即获取下一页时，才使用非空的 meta.next_cursor。在字段级交付来源信息可用之前，变更值会继续被隐去。

nearby_projects — 搜索 WGS84 坐标点附近的规范项目。参数： lat、lng、radius_km、可选的 stage 和 project_type、page 以及 limit。

create_project_watch — 为某个 project_uid 创建或幂等重放一个持久的签名 回调，以接收未来经过权利审核的事件。参数：project_uid、公开的 HTTPS callback_url 和稳定的 idempotency_key。 此工具会更改外部状态并返回签名密钥。

list_project_watches — 列出当前 API 密钥拥有的监听项。列表操作绝不会返回签名 密钥。

deactivate_project_watch — 通过 watch_uid 停用一个自有监听项。投递 审计记录会持久保留。待处理任务会被抑制，但已在传输中的 HTTPS 请求无法撤回，且仍会显示在审计记录中。 接收方必须根据稳定的回调 Idempotency-Key 标头进行去重。

仓库包含用于游标轮询 和显式回调管理的 skills/daleads-project-monitoring。它从 GitHub 仓库安装，不包含在 PyPI wheel 中。

房产情报

property_intelligence — 通用的、按权限筛选的地址级房产查询，适用于现有密钥和手动签发的密钥。参数：address （自由文本，例如 34 Mary St Clayton VIC），或同时提供 lat + lng，以及 可选的 components（以逗号分隔的请求子集）。请求某个名称并不会授予相应能力：API 会将其与密钥的服务端权限和字段级权利策略取交集。此工具不能证明密钥拥有 Full Self-Serve 权限；新的 Full 工作流应使用下方的封闭工具。

full_property_intelligence — 封闭的公开 Full Property Intelligence Self-Serve 查询。参数：address（推荐），或同时提供 lat + lng。它会请求基础事实 das、poi、planning、transport、utilities、administrative 和 public_housing；丛林火灾、洪水、海岸、滑坡和火灾历史的具名灾害叶项；以及土壤、保护区、遗产、受威胁物种、Ramsar、考拉、生态、EPBC、生物区和生物多样性背景的具名环境叶项。确切的环境叶项名称固定在 contracts/focused-api-v1.json 中。

它还会恰好请求以下评分叶项：scores.noise、 scores.aircraft_noise、scores.flood 和 scores.bushfire。它绝不会请求顶层的 hazards、environment 或 scores，因此新的提供方字段不会自动纳入 Full。明确的官方事实以及受权限控制的污染和登记信息，可能作为 Property Core 背景返回；但这不会授予 scores.contamination 权限，也不会发布独立的 Contamination 产品。太阳能、Neighbourhood Heat、Landscape Openness 和 Walkability Pilot 均不包含在内。Full 密钥具有独立的 property_core 和 suburb_intelligence 能力，但这些能力不会向此响应添加字段。提供方侧的来源和权利门控仍适用于每个返回字段。

property_core — 不含评分的封闭房产背景查询。参数：address （推荐），或 lat + lng。返回解析后的地址／地块身份、开发申请、POI、规划、灾害、环境、交通、公用设施、行政和公共住房事实，以及针对该响应的覆盖情况和来源义务。它绝不会返回评分、图层或未知的未来数据块。密钥必须包含完整且明确的 Core 组件集。

郊区和区域情报

find_suburbs — 在调用信号查询前，将郊区名称前缀解析为 ABS SAL 代码。参数：query、可选的 state、limit（最大值为 100）。返回现有的许可 Census 行及其 sal_code；同名项会分别保留，而不会被猜测合并。

suburb_signals — 针对单个 SAL 代码的 Census 背景和精简隐私的开发活动数据。参数：sal_code。返回当前／此前 12 个月的 DA 记录数量、趋势、状态和住宅发布覆盖情况、类别构成，以及一项机器契约，声明尚未应用项目去重。它绝不会将 SA2 绝对人口预测附加到 SAL。

find_sa2_regions — 将完整或部分区域名称解析为 ASGS 2021 SA2 代码。参数：query、可选的 state、limit（最大值为 50）。将返回的代码用于 sa2_population_forecast；切勿根据郊区名称推断代码。

sa2_population_forecast — 以代码为键的区域人口情景 Beta。参数：九位数的 sa2_code。返回历史数据、模型／版本、住房约束状态，以及匹配的 1／3／5 年滚动起点误差。已建立的 SA2 区域包含低／中／高情景。若数据制品没有 DA 住宅约束，高增长和绿地未来值将被暂不提供；暂不提供不等于零增长。 noise_screening — 专项噪声情报查询。参数： address（推荐）或 lat + lng。此工具只请求 scores.noise 和 scores.aircraft_noise，并返回建模的道路／铁路背景信息、Lden／昼间／夜间 估算值、立面方向分区、置信度依据和航空器噪声叠加评估。 这不是现场测量、LA90 结果或声学合规评估。 请使用 property_sample 中的 Noise 字段查看当前无需密钥的结构预览； 通用样例中的其他字段不属于 Noise 权限范围。

flood_screening — 专项洪水情报查询。参数：address （推荐）或 lat + lng。此工具只请求 scores.flood,hazards.flood， 并分别呈现全国筛查模型、官方地图证据和特定研究的水深数据。缺少水深或地图数据 表示覆盖状态，不代表水深为零或证明不存在洪水风险。筛查覆盖全国； 目前，官方建模水深数据来自 55 个生产栅格（布里斯班 48 个、NSW 7 个）。

bushfire_screening — 专项商业丛林火灾筛查查询。 参数：address（推荐），或同时提供 lat + lng。此工具始终只请求 scores.bushfire,hazards.bushfire，并返回目标身份、官方叠加状态、许可的灾害命中项、 建模植被燃料、地形、可用火灾历史、覆盖情况和注意事项。在数据可用时，响应会包含 初步参考 BAL 等级范围和置信度，以及必需的免责声明。这不是经认证的 BAL 评估， 不可用于建筑审批。仅使用坐标的查询会明确标注为此类查询，且不得视为建筑物位置。

walkability_screening — 专项便利设施与步行性筛查试点查询。 参数：address（推荐）或 lat + lng。此工具只请求 scores.walkability：返回到 24 种便利设施场景的直线距离（米），以及已披露的高速公路、 主要水域和区域坡度调整。结果不是步行路线、等时圈或出行时间。请查看每个 coverage 状态；当名称或坐标出现时，请保留 meta.amenity_sources 归属信息。

neighbourhood_context — 专项邻里环境 Beta 查询。 参数：address（推荐），或同时提供 lat + lng。此工具只请求 scores.heat_island,scores.view_quality。Neighbourhood Heat 将约 1 km 温度数据与 10 m 土地覆盖背景分开，并报告数据来源版本和借用像元状态。 旧版 view_quality 键返回公开的 Landscape Openness 产品，包含六项因素、 缺失／部分覆盖情况，以及明确排除的视线范围。它不是地块温度、实时天气、室内舒适度、 建筑能耗或有保证的景观视野。

solar_resource — 专项太阳能资源开发者预览查询。 参数：address（推荐），或同时提供 lat + lng。此工具只请求 scores.solar，并返回区域级开阔地平线 GHI／DNI／GTI、PVOUT、最佳倾角、 各字段分辨率、数据版本、许可和归属信息。它不会识别屋顶平面、可用面积、建筑或树木遮挡、 障碍物、电价、自发自用或电池，也不得用于屋顶设计。

property_sample — 查看通用 Property Intelligence 响应结构， 无需密钥。无需 API 密钥。 无参数。返回 Carlton VIC Grattan St 163 号的真实 生产环境载荷（带有开发审批活动的遗产排屋）。Noise 和公开 Full 目前共用此预览， 因为它们尚无专用样例路由。这是架构示例，而非权限清单：其中存在的预览字段 并不因此包含在 Noise 或公开 Full Self-Serve 权限中。

property_core_sample — 查看不含评分的 Property Core v1 封闭契约。 无需 API 密钥。 返回 Carlton 的真实响应，其中只包含明确列出的 Core 事实信息块、 覆盖情况和来源清单。 suburb_signals_sample — 查看真实的 Carlton SAL 开发信号 Beta 响应。无需 API 密钥。

sa2_population_forecast_sample — 查看 Carlton SA2 预测 Beta，包括匹配的滚动起点误差证据。无需 API 密钥。

property_walkability_sample — 查看 Carlton 专项便利设施与步行性筛查契约。**无需 API 密钥。**距离明确采用直线距离，不提供路线时间。

property_flood_sample — 详细查看一个已评分的灾害分项。**无需 API 密钥。**无需参数。返回生产环境中的 scores.flood 区块，数据来自 Rocklea QLD 一个研究覆盖点：官方 1% AEP 模拟深度、覆盖层状态、地形背景、覆盖说明和来源信息。

property_bushfire_sample — 查看标准丛林火灾筛查契约。**无需 API 密钥。**无需参数。返回一份真实的 Katoomba NSW 专项样本，其中包含已解析的主体身份、官方／模拟证据、覆盖范围、来源归属，以及明确标注为响应专属的指示性 BAL 状态。预设快照可能早于该字段；实时响应可能包含初步等级。

property_context_sample — 查看协调后的邻里环境 Beta 和太阳能资源开发者预览契约。**无需 API 密钥。**无需参数。返回一份符合生产环境结构的真实 Carlton 响应，仅包含邻里热环境、景观开阔度和太阳能资源，并附带其旧版 v1 键、测量级别、来源、注意事项和未建模边界。

property_sandbox_addresses — 列出可免费评估的地址。**无需 API 密钥。**无需参数。返回 {sandbox_addresses: [{address, label}, ...], note} — 12 个真实地址，覆盖全部八个州，按不同的灾害和规划特征选取。通过 property_intelligence 查询这些地址，绝不会计入密钥的月度配额。

数据边界

适配器代码与 DA Leads 返回的数据受不同许可约束。安装此软件包并不意味着获得 API 使用资格或 API 数据再分发权。公开的 Full Self-Serve 方案支持在点击接受条款的约束下进行内部分析，并向客户提供注明来源的静态报告。交互式嵌入、白标、向下游提供访问权限、转售、原始数据再分发、特殊几何数据和自定义 SLA 均需 Publisher 或 Enterprise 权限。请参阅 DA Leads 条款、隐私政策和数据来源归属。

该服务复用 DA Leads API 的身份验证、套餐限制和隐私控制。公开 API 和 MCP 响应不会暴露申请人姓名。

版权所有 2026 Limon Tech。保留所有权利。