{
  "name": "realping",
  "description": "Taiwan real estate transactions cleaned to real-area (去車位、去公設後實坪) price per ping. Issued by 內政部不動產交易實價查詢服務網, derivative layer computed by RealPing with public methodology.",
  "version": "0.2.0",
  "homepage": "https://realping.tw",
  "developers_page": "https://realping.tw/developers",
  "methodology": "https://realping.tw/methodology",
  "source": "資料來源：內政部不動產交易實價查詢服務網",
  "license": "資料源無償、非專屬、得再授權；須註明出處",
  "contact": {
    "self_serve_key": "https://realping.tw/developers#signup"
  },
  "servers": [
    {
      "name": "realping",
      "transport": "streamable-http",
      "url": "https://mcp.realping.tw/mcp",
      "auth": {
        "type": "bearer",
        "header": "Authorization",
        "format": "Bearer rp_<token>",
        "obtain_key_url": "https://realping.tw/developers#signup"
      }
    }
  ],
  "tools": [
    {
      "name": "search_transactions",
      "title": "查成交",
      "description": "查台灣不動產成交明細，回傳去車位去公設修正後的實坪單價、公設比與三層單價對照。預設只回實坪可用案件。",
      "parameters": [
        "縣市",
        "區",
        "建物型態",
        "date_from",
        "date_to",
        "limit"
      ]
    },
    {
      "name": "filter_transactions",
      "title": "進階篩選找物件",
      "description": "依條件反向找物件：可疊加實坪單價區間、公設比上限（百分比）、屋齡區間、總價區間、房數下限。預設只回實坪可用、由實坪單價低到高排序。",
      "parameters": [
        "縣市",
        "區",
        "建物型態",
        "實坪單價下限",
        "實坪單價上限",
        "公設比上限",
        "屋齡下限",
        "屋齡上限",
        "總價下限",
        "總價上限",
        "房數下限",
        "limit"
      ]
    },
    {
      "name": "area_stats",
      "title": "區域行情",
      "description": "查某區近 N 個月成交行情：去車位去公設的實坪每坪中位 / P25 / P75（萬元）與平均公設比。",
      "parameters": [
        "縣市",
        "區",
        "建物型態",
        "months"
      ]
    },
    {
      "name": "lookup_address",
      "title": "門牌查詢",
      "description": "以門牌關鍵字查附近成交。",
      "parameters": [
        "門牌關鍵字",
        "limit"
      ]
    },
    {
      "name": "building_stats",
      "title": "單棟公設比信用分",
      "description": "把同門牌（同棟）成交聚合，算這棟實際公設比中位，對照該區同型態中位回偏高/偏低/接近。",
      "parameters": [
        "門牌關鍵字",
        "建物型態",
        "limit"
      ]
    },
    {
      "name": "parking_stats",
      "title": "車位行情榜",
      "description": "單一車位成交價（萬元）的中位 / P25 / P75 行情榜。只算乾淨單車位（車位筆數=1、車位價>0、非特殊、非多物件）。",
      "parameters": [
        "縣市",
        "區",
        "min_n",
        "limit"
      ]
    },
    {
      "name": "value_check",
      "title": "看屋值不值得",
      "description": "算這間的去車位去公設實坪單價，並比對該區同型態的真實實坪行情（中位/四分位），回貴/便宜判斷 + 議價建議。",
      "parameters": [
        "縣市",
        "區",
        "建物型態",
        "總價",
        "房屋坪數",
        "公設比",
        "車位價"
      ]
    },
    {
      "name": "comps_estimate",
      "title": "同棟實坪估值",
      "description": "估某棟的去公設實坪行情：同棟（正規化門牌歸戶）近 12/24 月實坪成交的中位估值 + P25–P75 區間，信心分層依同棟成交密度（分層 backtest 校準：電梯物件同棟24月≥5筆信心「高」；公寓/透天誠實標不覆蓋）。進階工具：免費層每月 30 次試用，Pro 不限次數。",
      "parameters": [
        "縣市",
        "區",
        "門牌",
        "建物型態"
      ]
    }
  ],
  "rest_api": {
    "base_url": "https://api.realping.tw",
    "openapi_url": "https://api.realping.tw/openapi.json",
    "docs_url": "https://api.realping.tw/docs",
    "auth": {
      "type": "api_key",
      "header": "X-API-Key",
      "format": "rp_<token>"
    },
    "free_tier": {
      "monthly_calls": 1000,
      "obtain_at": "https://realping.tw/developers#signup"
    },
    "premium_endpoints": {
      "/comps-estimate": {
        "free_tier_monthly_calls": 30,
        "note": "Pro（NT$1,500/月起）不限次數；詳見 https://realping.tw/developers#pricing"
      }
    }
  }
}