Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Housing Sentinel

✓ vom Dienst · housingsentinel.cn

von SheldonZhuangVersion 1.3.0i★ 1iComputer oder CloudOffizielle Website ↗
Name in der Registrycn.housingsentinel/housing-sentinel

So installierst du es

What it does

中国12城官方房产成交数据与进攻/防守买卖信号 MCP。3天全城市免费试用,深圳信号永久免费。Housing data & signals for 12 Chinese cities.

  • Connects Computer oder Cloud
  • Account or key Cloud: Needs Authorization · Local: Needs HOUSING_SENTINEL_API_KEY
  • Category Sonstiges

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit4/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität7/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert19/100

Qualität: 2/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Housing Sentinel. Folge https://mcp.popnx.com/i/cn-housingsentinel-housing-sentinel.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

2/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (api.housingsentinel.cn) · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei Housing Sentinel registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Housing Sentinel öffnen ↗

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameHousing Sentinel
    Remote MCP server URL · Adressehttps://api.housingsentinel.cn/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsHousing Sentinel

  5. Ausprobieren

    Nutze Housing Sentinel und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Housing Sentinel nutzt, oder ein Werkzeug von Housing Sentinel in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Housing Sentinel noch nicht verbinden

Housing Sentinel braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die Housing Sentinel verbinden kann

  • Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen)

B · Andere in Sonstiges, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen)

  1. Bei Housing Sentinel registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Housing Sentinel öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user housing-sentinel https://api.housingsentinel.cn/mcp --header 'Authorization: Bearer your-value'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    Housing Sentinel sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Housing Sentinel und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Housing Sentinel nutzt, oder ein Werkzeug von Housing Sentinel in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen)

  1. Bei Housing Sentinel registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Housing Sentinel öffnen ↗

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Housing Sentinel ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Housing Sentinel und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Housing Sentinel nutzt, oder ein Werkzeug von Housing Sentinel in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von Housing Sentinel (auf der Seite des Anbieters erstellen)

  1. Bei Housing Sentinel registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Housing Sentinel öffnen ↗

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Housing Sentinel ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Housing Sentinel und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Housing Sentinel nutzt, oder ein Werkzeug von Housing Sentinel in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://api.housingsentinel.cn/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Housing Sentinel nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user housing-sentinel https://api.housingsentinel.cn/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "housing-sentinel": {
      "url": "https://api.housingsentinel.cn/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "housing-sentinel": {
      "type": "http",
      "url": "https://api.housingsentinel.cn/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user housing-sentinel --env HOUSING_SENTINEL_API_KEY=your-value -- npx -y housing-sentinel-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "housing-sentinel": {
      "command": "npx",
      "args": [
        "-y",
        "housing-sentinel-mcp"
      ],
      "env": {
        "HOUSING_SENTINEL_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "housing-sentinel": {
      "command": "npx",
      "args": [
        "-y",
        "housing-sentinel-mcp"
      ],
      "env": {
        "HOUSING_SENTINEL_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "housing-sentinel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "housing-sentinel-mcp"
      ],
      "env": {
        "HOUSING_SENTINEL_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • HOUSING_SENTINEL_API_KEY geheim erforderlich env
    API Key(hs_live_...),登录 housingsentinel.cn「我的→接入AI Agent」生成;新用户 3 天全 12 城免费试用
  • HOUSING_SENTINEL_URL env
    可选:覆盖 MCP 端点,默认 https://api.housingsentinel.cn/mcp(中国大陆可用 https://housingpi-proxy-anirmyfaea.cn-shanghai.fcapp.run/mcp)
  • Authorization geheim erforderlich HTTP header
    Bearer hs_live_xxx — API Key,登录 housingsentinel.cn「我的→接入AI Agent」生成(新用户 3 天全 12 城免费试用,之后深圳信号永久免费)

Die Beschreibungen sind noch im englischen Original.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
56/Wo.
Bestätigte Domain
✓ housingsentinel.cn
Lizenzi
Keine Lizenz angegeben
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
1.3.0
Kategoriei
Sonstiges
In der Registry veröffentlichti
1. Okt. 2026
Code zuletzt geänderti
19. Okt. 2026
Zuletzt geprüft
19. Nov. 2026
Entwickler
SheldonZhuang
Pakete
npm: housing-sentinel-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain housingsentinel.cn bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 31 Tagen

  • ✕ Nicht bestanden

    Hat eine Lizenz

    Keine Lizenzdatei im Repo gefunden

  • ! Vorsicht

    Endpunkt antwortet

    Zugriff verweigert (HTTP 401) ohne OAuth-Anmeldung. Braucht vielleicht einen Schlüssel oder blockiert Bots; nicht bestätigt.

  • ! Vorsicht

    Anmeldung mit OAuth

    Braucht einen Schlüssel oder Token, den du selbst kopierst und einfügst

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für housing-sentinel-mcp@1.3.0

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cn-housingsentinel-housing-sentinel.svg)](https://mcp.popnx.com/en/servers/cn-housingsentinel-housing-sentinel)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 86 % der anderen 20749 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 47 % der anderen 20749 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 7 % der anderen 20749 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Housing Sentinel sicher?

Er hat 2 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization, HOUSING_SENTINEL_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 31 Tagen geändert, und die neueste Version (1.3.0) kam vor 2 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

von koala73Weit verbreitet★ 90.934Aktualisiert vor 3 Tagen

Läuft in der Cloud✓ vom Dienst · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

von openstatusHQWeit verbreitet★ 9274Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

von JanDeDobbeleerWeit verbreitet★ 23.770 Sterne des ganzen ReposAktualisiert vor 30 Tagen

Läuft in der Cloud✓ vom Dienst · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

von Klavis-AIWachsend★ 5824Aktualisiert vor 14 Monaten

Läuft in der CloudRepo archiviert✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

von jitsucomWeit verbreitet★ 5136Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · jitsu.com
Im Vergleich mit ähnlichen
Dieser
Housing Sentinel
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen2/54/44/44/41/44/4
Lizenz–AGPL-3.0AGPL-3.0MITApache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

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

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

中文 | English


目录

  • 这是什么
  • 覆盖城市与数据
  • 核心概念:进攻/防守市场信号
  • 快速开始(3 步)
  • 方式 A:MCP 接入(推荐)
  • 方式 B:REST API
  • 方式 C:Claude Skill
  • API 一览
  • 变化驱动:since / ETag 与 Webhook
  • MCP Prompts 与 Resources
  • npm stdio 包
  • 接入配方 recipes/
  • 示例与模板
  • 使用规则与限制
  • 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 各城市不同)。

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

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

去化周期市场阶段含义
≥ 18 月🔴 防守期供过于求,房价下行风险大,观望
12 – 18 月🟠 观察期止跌企稳中,备好资源不急买
8 – 12 月🔵 进攻/买入期供需趋衡,可挑核心区笋盘
< 8 月🟢 快速进攻期供不应求,优质盘大概率上涨

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

快速开始(3 步)

  1. 登录:在 housingsentinel.cn 或微信小程序"房哨兵"登录(不订阅也有 3 天全 12 城免费试用,之后深圳当前信号永久免费;点数包 ¥39/1000 次/30 天;订阅单城市或全国套餐解锁完整历史与更高限额)
  2. 取密钥:登录后进入 我的 → 接入 AI Agent,生成 API Key(hs_live_...)
  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 工具:list_cities · get_market_signal · get_metrics · 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 一览

端点说明
GET /api/v1/signals主接口:全部已订阅城市当前信号快照
GET /api/v1/cities/{city}/signal单城市当前信号
GET /api/v1/cities/{city}/metrics?from=&to=逐日指标时间序列(趋势分析,默认近90天)
GET /api/v1/cities/{city}/history?from=&to=原始日度成交/库存数据(单次最多400条)
GET /api/v1/cities已订阅城市列表 + 阈值元数据
POST/GET /api/v1/webhooks、DELETE /api/v1/webhooks/{id}、POST /api/v1/webhooks/{id}/testWebhook 管理(试用/点数包/订阅/机构版)

城市代码用拼音全拼(xiamen、shenzhen…)。完整字段定义见 openapi.yaml。

信号响应示例(节选):

{

"cityCode": "xiamen", "city": "厦门", "dataDate": "2026-07-12", "phase": "观察期", "phaseSource": "cycle", "secondHand": { "inventoryCycle": 13.4, "inventory": 25495, "avgMonthly": 1901 }, "firstHand": { "inventoryCycle": 29.1, "inventory": 21058, "avgMonthly": 723 }, "thresholds": { "cycleDefense": 18, "cycleWatch": 12, "cycleBuy": 8 } }

变化驱动:since / ETag 与 Webhook

数据每天更新一次,没必要每次都解析全量。

轮询(所有层级可用):首次调 GET /api/v1/signals,之后带上次响应的 nextSince:

curl "https://api.housingsentinel.cn/api/v1/signals?since=2026-09-30T00:00:00.000Z" \

-H "Authorization: Bearer hs_live_xxx" -H 'If-None-Match: W/"上次的ETag"'

  • 带 since 时只返回该时间后有数据变动的城市,响应多出 since、changedSince(变动城市代码数组)、nextSince(下次用);每个城市对象带 updatedAt。非法 since 返回 400 BAD_SINCE。
  • /signals 与 /cities/{city}/signal 返回弱 ETag,带 If-None-Match 且没变化时返回 304。
  • 完整脚本:recipes/polling-etag.sh、recipes/n8n-signals-since.json。

Webhook(试用/点数包/订阅/机构版;免费层与演示密钥返回 403):

curl -X POST https://api.housingsentinel.cn/api/v1/webhooks \

-H "Authorization: Bearer hs_live_xxx" -H "Content-Type: application/json" \ -d '{"url":"https://your.domain/hs-webhook","cities":["shenzhen"],"events":["data.updated","phase.changed"]}'

→ 201,响应里的 secret(whsec_...)只返回这一次

  • 事件:data.updated(城市有新数据)、phase.changed(市场阶段变化,额外带 previousPhase/phase);服务端每 5 分钟检测一次。
  • 请求体 { id, event, createdAt, cityCode, signal },signal 与 /cities/{city}/signal 响应相同。
  • 请求头 X-HS-Event、X-HS-Delivery、X-HS-Signature: t= ,v1= ,`v1 = HMAC-SHA256(secret, " .<原始请求体>")`。
  • 要求:url 必须 https(拒绝内网/回环地址);5 秒内返回 2xx,不跟随重定向;连续失败 10 次自动停用(POST /webhooks/{id}/test 成功可重新激活);每账号最多 5 个;订阅/试用过期后停推。
  • 验签示例:Node.js / Python。

MCP Prompts 与 Resources

MCP server 1.3.0 在 4 个工具之外提供:

类型名称说明
Promptdaily_brief每日房市简报;参数 cities 可选,逗号分隔
Promptcompare_cities多城市对比;参数 cities
Resourcehousing://llms.txt接入说明(与 llms.txt 相同)
Resourcehousing://thresholds各城市判档阈值(JSON)

npm stdio 包

只支持 stdio 的 MCP 客户端可以用 housing-sentinel-mcp,它把 stdio 消息原样转发到远程 MCP:

{ "mcpServers": { "housing-sentinel": { "command": "npx", "args": ["-y", "housing-sentinel-mcp"], "env": { "HOUSING_SENTINEL_API_KEY": "hs_live_xxx" } } } }

中国大陆网络可在 env 中加 "HOUSING_SENTINEL_URL": "https://housingpi-proxy-anirmyfaea.cn-shanghai.fcapp.run/mcp"。

接入配方 recipes/

recipes/ 里每个文件都可以直接复制:Claude Code 每日 08:00 简报、Claude Desktop/Cursor 配置、n8n since+ETag 轮询、扣子工作流、Dify OpenAPI 导入、OpenAI Agents SDK、Webhook 验签(Node/Python)、curl 轮询脚本。

示例与模板

文件场景
examples/python-example.pyPython 拉取全城市信号 + 阶段跨越检测(可挂 cron)
examples/n8n-daily-alert.jsonn8n 工作流:每天 8 点巡检,阶段跨越推送企业微信(导入即用)
examples/claude-agent.mdClaude Code 房产投资监控 subagent 定义 + 每日自动巡检

使用规则与限制

项目说明
数据授权API 数据仅限订阅者/试用者本人使用,不得对外提供数据服务
认证Authorization: Bearer hs_live_...;密钥可在"接入 AI Agent"页随时重置(旧密钥即刻失效)
免费试用无订阅账号首次调用起 3 天内可查全部 12 城;历史数据限最近 30 天
免费层试用结束后永久:深圳当前信号(/cities /signals /cities/shenzhen/signal、MCP list_cities / get_market_signal),10 次/分、50 次/天;metrics / history 返回 403(FREE_TIER_LIMIT)
点数包¥39 / 1000 次 / 30 天,全部 12 城,历史限最近 90 天;用完或到期回到免费层;不参与推荐返利
公开端点GET /api/v1/cities/{city}/card 无需密钥:当日成交、当月累计、二手去化周期与市场档位(不含库存原值),60 秒缓存
订阅价格单城市 ¥299/年,全国 12 城 ¥1888/年(完整历史、60 次/分、2000 次/天);订阅/点数包入口 housingsentinel.cn/agent(登录后"我的 → 接入 AI Agent"),付款后密钥即刻生效;403/429 响应附 subscribeUrl 与 pricing
机构/企业版更高限额(300 次/分钟、20000 次/天)、全部城市、多席位,线下签约;联系微信 SheldonZhuang
限流订阅 60 次/分钟、2000 次/天;点数包 60 次/分钟;试用 10 次/分钟、100 次/天;免费层 10 次/分钟、50 次/天(按账号计,重置密钥不重置限额)
轮询建议数据每日更新一次,建议轮询间隔 ≥ 1 小时
权限订阅用户返回订阅中城市;试用期全部 12 城;试用结束后免费层仅深圳当前信号;点数包全部 12 城;订阅到期回到免费层,订阅/购买即恢复
免责信号为基于官方成交数据的市场时机参考,不构成投资建议

本仓库的文档与示例代码可自由用于接入房哨兵服务;房哨兵名称、判断框架内容与数据服务的权利由 housingsentinel.cn 保留。

FAQ

Q:不订阅能试用吗? 可以。登录后生成 API Key,首次调用起 3 天内可免费查询全部 12 城(含信号、指标序列与最近 30 天原始数据,限 10 次/分、100 次/天);试用结束后深圳当前信号永久免费。不想登录也可以直接调公开端点 GET /api/v1/cities/{city}/card。需要更多:点数包 ¥39 / 1000 次 / 30 天(全城市,历史 90 天),或订阅(单城市 ¥299/年,全国 12 城 ¥1888/年,完整历史与更高限额)。

Q:密钥泄露了怎么办? 登录后到"我的 → 接入 AI Agent"点"重置密钥",旧密钥立即失效,把新密钥更新到 Agent 配置即可。

Q:为什么成都/重庆的一手去化周期是 null? 这两城的一手官方口径为周度成交 + 当月批准上市套数(并非累计可售库存),计算去化周期会产生误导,故诚实地返回 null;判断请看二手指标与成交量。

Q:数据来源可靠吗? 全部来自各市住建局/房管局官方发布渠道,每日自动抓取,多重兜底校验(详见产品内说明)。

Q:想要的城市不在列表里? 到官网提交城市需求,订阅需求量是我们开新城的首要依据。

English Summary

Housing Sentinel provides official daily housing-transaction data and offense/defense market signals for 12 major Chinese cities (Shenzhen, Shanghai, Beijing, Guangzhou, Hangzhou, Nanjing, Suzhou, Wuxi, Chengdu, Chongqing, Dongguan, Xiamen). Signals are derived from second-hand inventory absorption cycles: ≥18 months = defense, 12–18 = watch, 8–12 = buy, <8 = strong buy.

Getting started: log in at housingsentinel.cn → generate an API key under My → AI Agent → connect via the remote MCP server (https://api.housingsentinel.cn/mcp, Bearer auth; or npx -y housing-sentinel-mcp for stdio clients) or REST (/api/v1/signals, spec in openapi.yaml). New users get a free 3-day trial of all 12 cities starting from the first API call, and Shenzhen’s current signal stays free forever afterwards — no subscription required. A public no-key endpoint GET /api/v1/cities/{city}/card returns any city’s latest transactions and market phase. A ready-made Claude Skill teaches your agent both the API and the decision framework. Change-driven access: /signals?since= + ETag/304, and HMAC-signed webhooks (data.updated / phase.changed). Copy-paste integrations live in recipes/.

Data updates daily; rate limits 60 req/min & 2,000 req/day for subscribers (credit pack ¥39 / 1,000 calls / 30 days; 10 req/min & 100 req/day during trial; 10 req/min & 50 req/day on the free tier); data is licensed for the subscriber's/trial user's own use only — redistribution as a data service is prohibited.


[开始接入 →](https://housingsentinel.cn) | 问题反馈请提 Issue

*让 AI 帮你盯住每一个买入时机。*