# 📊 中指数据 MCP

> 为 AI 助手提供「土地市场 / 新房市场 / 二手房市场 / 房企数据」全方位查询分析能力的 MCP Server。覆盖近三十年地产行业数据，为投资投拓、客研、营销等场景提供权威数据支撑。

---

## ✨ 功能特性

- **土地市场全链路**：支持土地明细查询与宏观统计，覆盖推出、成交、流拍、取消、中止等多种交易状态，可按用地性质、价格、面积、容积率等 40+ 维度筛选。
- **新房市场多维分析**：楼盘级别明细搜索 + 跨城宏观统计 + 单项目内部交易拆解，支持按户型、面积段、单价段、总价段深入分析。
- **二手房市场全景洞察**：成交走势、新增/存量挂牌、单小区成交/挂牌/网签全量统计。
- **房企投资与销售**：企业拿地分布（含权益拆分）与新房销售业绩查询。
- **全局检索**：一站式搜索，覆盖土地、新房、二手房、企业多维度数据。
- **企业级安全认证**：通过 APPID 授权机制确保数据安全。

---

## 🚀 快速开始

### 1. 获取授权 (APPID)

使用本服务前，您需要先获取有效的 `APPID`。

📧 **请联系**: `creiskefu@fang.com` 获取您的专属 `APPID`。

### 2. 配置 MCP 客户端

您可以在任何支持 Model Context Protocol (MCP) 的客户端中，通过以下配置来启用本服务。

```json
{
  "mcpServers": {
    "creis-data-mcp": {
      "url": "https://creis.cih-index.com/datamcp/sse",
      "headers": {
        "MCP-INDUSTRY-APPID": "您的APPID"
      }
    }
  }
}
```

### 3. 验证连接

配置完成后，重启您的 MCP 客户端。如果配置正确，您应该能在客户端的可用工具列表中看到 11 个数据查询工具。

---

## 🔑 授权与认证

本服务需要有效的 `MCP-INDUSTRY-APPID` 才能正常使用。如需获取授权，请联系客服人员申请，联系邮箱：`creiskefu@fang.com`

---

## 🛠️ 支持的工具与 API

中指数据 MCP 服务器提供以下符合 MCP 标准的 API（工具）：

| 工具名称 | 描述 |
| --- | --- |
| `land_search` | 查询招拍挂土地地块明细列表，返回地块级别的详细信息，如用地性质、面积、容积率、楼面价、成交价、受让单位、溢价率等。 |
| `land_statistics` | 统计土地市场的宏观聚合指标，按时间、城市、用地性质等维度返回供应量、成交量、楼面均价、平均溢价率等。 |
| `project_search` | 查询城市新房楼盘明细列表，返回楼盘级别信息，如开发企业、成交套数/面积/金额、可售量、开盘/交房时间等。 |
| `project_statistics` | 统计新房市场的宏观聚合指标，按时间、城市、区县、板块、户型、面积段等维度返回成交量、均价、供求比、出清周期等。 |
| `project_detail_statistics` | 统计单个指定项目的新房交易数据，分析户型、面积段、单价段等内部成交结构。 |
| `esf_statistics` | 统计二手房市场的成交聚合指标，按时间、城市、面积段、总价段等维度返回成交套数、面积、均价。 |
| `esf_listings` | 统计二手房市场的挂牌聚合指标，按时间、城市、户型、面积段等维度返回新增挂牌/存量挂牌套数与均价。 |
| `esf_detail_statistics` | 统计单个指定项目的二手房成交、挂牌、网签等全量数据，分析面积段、单价段等内部成交结构。 |
| `enterprise_landdimension` | 统计房地产开发企业的拿地聚合指标，返回拿地宗数、面积、规划建面、拿地金额、权益占比、平均溢价率等。 |
| `enterprise_saledata` | 统计房地产开发企业的新房销售聚合指标，返回销售套数、面积、金额、权益销售、销售均价等。 |
| `creis_comprehensive_search` | 一站式全局搜索，支持关键词检索土地、新房、二手房、企业等多维度数据。 |

所有 API 均遵循 MCP 协议，可以从任何符合 MCP 标准的客户端、LLM 或代理平台调用。

---

## 🤝 合作与支持

- **联系我们**: 如需获取 `APPID`、商务合作或技术支持，请联系 `creiskefu@fang.com`。

---

_由 CIH Web Team 开发维护_