Housing Sentinel MCP server

🏠 房哨兵 Housing Sentinel — AI 接入中心

把中国 12 城官方房产成交数据与进攻/防守市场信号，接入你的 AI Agent 和自动化工作流

Connect official daily housing-transaction data & market signals for 12 major Chinese citiesto your AI agents and workflows.

中文 | English

目录

• 这是什么
• 覆盖城市与数据
• 核心概念：进攻/防守市场信号
• 快速开始（3 步）
• 方式 A：MCP 接入（推荐）
• 方式 B：REST API
• 方式 C：Claude Skill
• API 一览
• 示例与模板
• 使用规则与限制
• FAQ
• English Summary

这是什么

房哨兵是一个房产市场数据监控 SaaS：每日自动抓取各市住建局/房管局官方发布的住宅成交与库存数据，计算库存去化周期，输出"防守 / 观察 / 进攻 / 快速进攻"四档市场信号，帮助购房者和投资者把握交易时机。

本仓库是它的 AI 接入中心——通过 MCP、REST API 或 Claude Skill，把这些数据和信号接进 Claude、Cursor、扣子、Dify、n8n 或任何自建 Agent 工作流。新用户免费试用：登录生成密钥后，首次调用起 3 天内可查询全部 12 城；试用结束后深圳当前信号永久免费；点数包 ¥39/1000 次或订阅解锁全量。无需密钥的公开端点 GET /api/v1/cities/{city}/card 可直接拿到任一城市当日成交与市场档位。

📌 本仓库只包含公开接入文档与示例，不包含房哨兵实现代码。

覆盖城市与数据

12 城：深圳 · 上海 · 北京 · 广州 · 杭州 · 南京 · 苏州 · 无锡 · 成都 · 重庆 · 东莞 · 厦门

数据每日更新一次（北京时间 07:00–23:59 各城市不同）。

核心概念：进攻/防守市场信号

判断框架以二手住宅库存去化周期为核心：

无去化周期数据的城市降级为月成交量判断（荣枯线/暴涨线，各城市阈值不同，见 GET /api/v1/cities）。一手与二手信号矛盾时，以二手为准。

快速开始（3 步）

1. 登录：在 housingsentinel.cn 或微信小程序"房哨兵"登录（不订阅也有 3 天全 12 城免费试用，之后深圳当前信号永久免费；点数包 ¥39/1000 次/30 天；订阅单城市或全国套餐解锁完整历史与更高限额）
2. 取密钥：登录后进入 我的 → 接入 AI Agent，生成 API Key（hslive...）
3. 接入（任选其一）：

方式 A：MCP 接入（Claude / Cursor 等，推荐）

零安装——房哨兵 MCP 是远程服务，填 URL + 密钥即用。

Claude Code 一条命令：

claude mcp add --transport http housing-sentinel https://api.housingsentinel.cn/mcp \
  --header "Authorization: Bearer hs_live_你的密钥"

Claude Desktop / Cursor 配置文件：

{
  "mcpServers": {
    "housing-sentinel": {
      "type": "http",
      "url": "https://api.housingsentinel.cn/mcp",
      "headers": { "Authorization": "Bearer hs_live_你的密钥" }
    }
  }
}

然后直接问你的 AI：

"厦门现在是什么市场阶段？该进攻还是防守？"

"对比一下我订阅的所有城市，哪个最接近买入期？"

"分析深圳近90天二手去化周期趋势"

MCP 工具：listcities · getmarketsignal · getmetrics · get_history

方式 B：REST API（任意语言 / n8n / 扣子 / Dify）

curl https://api.housingsentinel.cn/api/v1/signals \
  -H "Authorization: Bearer hs_live_你的密钥"

OpenAPI 3.0 描述文件：openapi.yaml —— 可直接导入扣子（Coze）插件、Dify 自定义工具、n8n、Custom GPT Actions。

方式 C：Claude Skill（方法论 + 工具，一键安装）

skills/housing-sentinel/SKILL.md 让你的 Claude 掌握完整的"库存去化周期进攻/防守判断框架"——不只是会调 API，还知道怎么解读：二手优先原则、趋势重于水平、各城市口径差异、回答规范。

# Claude Code 安装（复制到项目 skills 目录）
mkdir -p .claude/skills/housing-sentinel
curl -o .claude/skills/housing-sentinel/SKILL.md \
  https://raw.githubusercontent.com/SheldonZhuang/housing-sentinel-ai/main/skills/housing-sentinel/SKILL.md

API 一览

Shortened. The full README is on GitHub.