房源信息查询服务

MCP SERVER AD CODE

只要你提供一个香港中原外网的房源编号(房源编号可以在这里查找：https://hk.centanet.com ) ，就可以得到盤源和所屬屋苑的盤源基本信息。

✨ Features

1. GetUnitBaseByAdCode: 获取盤源和所屬屋苑業基本和周邊信息，返回了集合 DataUnitBase-盤源 盤源：盤源名稱、實用面積、居室數、HMA_ID、HMA_CN、cencode21、cencode21_c、Region_CN、District_CN；其中英文名稱分別表示中原市場分區編碼，名稱；中原樓宇組群編碼、名稱；大區、18區 DataEstateBase-盤源所屬屋苑 屋苑：屋苑名称、基本信息、建築年代、期數、棟座數、房屋數、地鐵站及時間、屋苑地址、物業公司、開發商、學校情況、特徵標簽、周邊信息.
2. GetUnitMarketByAdCode:获取盤源歷史成交和盤源所屬屋苑歷史成交，返回了集合DataUnitMarket-盤源 盤源：換手次數，成交均尺價，平均賺蝕比 .
3. GetUnitMarketByCode: 获取盤源歷史成交和盤源所屬屋苑歷史成交，返回了集合DataUnitMarket-盤源 盤源：換手次數，成交均尺價，平均賺蝕比.
4. GetUnitODCByAdCode: 获取盤源和所屬屋苑近30天業務員作業信息和屋苑最新庫存信息，返回了集合 DataUnitODC-盤源 盤源：帶客睇樓、查看電話、樓盤跟進、致電業主、查看樓盤 DataEstateODC-盤源所屬屋苑 屋苑：新開盤、簽委託書、人均聯絡業主次數、人均跟進量、樓盤庫存-7天內有跟進、樓盤庫存-14天內有跟進、樓盤庫存-簽委託、樓盤庫存-有廣告、樓盤庫存-總盤量、樓盤庫存-有效盤.
5. GetUnitPostByAdCode: 获取盤源和盤源所屬屋苑近30天放盤等外網活動情況，返回了集合 DataUnitPost-盤源 盤源：放盤類型，放售價（萬元），放售均呎價（元），放租價（元），放租均呎價，是否筍盤，是否董事推介，是否獨家，瀏覽點擊量,聯係量,BookMark量,銀行估價查詢次數 DataEstatePost-盤源所屬屋苑 屋苑：日期，瀏覽點擊量,聯係量,BookMark量,銀行估價查詢次數.
6. GetUnitValuationByAdCode: 获取盤源歷史估價走勢数据，返回了集合DataVulation-盤源，10年估總價和估尺價明細，返回數據保留整數,其中均估總價除以10000，換算成萬元，包括：年份，均估尺價，均估總價.

🤖 Usage

To use with Desktop APP, such as Claude, VSCode, Cline, Cherry Studio, Cursor, and so on, add the MCP server config below. On Mac system:

{
  "mcpServers": {
    "mcp-server-ad-code": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-ad-code"
      ],
      "env": {
        "API_KEY": "***********************************"
      }
    }
  }
}

On Window system:

{
  "mcpServers": {
    "mcp-server-ad-code": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-server-ad-code"
      ],
      "env": {
        "API_KEY": "***********************************"
      }
    }
  }
}

🚰 Run with SSE or Streamable transport

Install the package globally.

npm install -g mcp-server-ad-code

Run the server with your preferred transport option:

# For SSE transport (default endpoint: /sse)
export API_KEY="your-api-key-here"
mcp-server-ad-code --transport sse

# For Streamable transport with custom endpoint
set API_KEY=your-api-key-here
mcp-server-ad-code --transport streamable

Then you can access the server at:

• SSE transport: http://localhost:1122/sse
• Streamable transport: http://localhost:1122/mcp

🎮 CLI Options

You can also use the following CLI options when running the MCP server. Command options by run cli with -h.

MCP Server Chart CLI

Options:
  --transport, -t  Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
  --port, -p       Specify the port for SSE or streamable transport (default: 1122)
  --endpoint, -e   Specify the endpoint for the transport:
                   - For SSE: default is "/sse"
                   - For streamable: default is "/mcp"
  --help, -h       Show this help message

⚙️ Environment Variables

申请 API_KEY 地址 https://onehub.centanet.com 注册就送100万额度，或联系我们

{
  "mcpServers": {
    "mcp-server-ad-code": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-ad-code"
      ],
      "env": {
        "API_KEY": "***********************************"
      }
    }
  }
}

🔨 Development

Install dependencies:

npm install

Build the server:

npm run build

Start the MCP server:

npm run start

📄 License