Developer API

全国民泊物件 AI 分析を
API / MCP から直接呼び出す

物件 URL を 1 つ渡すだけ。旅館業許可適性・収益シミュレーション・投資スコアを JSON で返す。月 50 件まで無料。

無料で始める クイックスタート
🌐

全国対応

SUUMO・アットホーム・Home's など主要サイトに対応。全国どの物件も 1 リクエストで分析。

⚡

MCP 統合

Claude Code / Claude Desktop に MCP サーバーを追加するだけ。会話の中で物件分析を自動実行。

💸

従量課金

月 50 件まで無料。超過分（¥80/件）の従量課金は現在準備中で、無料枠を超えたリクエストは一時的にブロックされます。大口利用は Enterprise でご相談ください。

料金

月 0 〜 50 件 無料
51 件目以降（従量課金・準備中） ¥80 / 件（現在は停止中）
レート制限 60 req/min per キー
キャッシュ 同一 URL は 2 回目以降 ¥0

クイックスタート

  1. ダッシュボードで API キーを発行ログイン後、「Developer API」ページから発行。eak_ で始まる文字列がキーです。
  2. X-API-Key ヘッダーに設定すべてのリクエストに X-API-Key: <your key> を付与してください。
  3. POST /analyze で物件 URL を送信レスポンスに分析結果が JSON で返ります。

cURL

curl -X POST https://insight.es-sense.jp/api/v1/public/v1/analyze \
  -H "X-API-Key: eak_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://suumo.jp/chukoikkodate/..."}'

Python

import httpx

result = httpx.post(
    "https://insight.es-sense.jp/api/v1/public/v1/analyze",
    headers={"X-API-Key": "eak_your_key_here"},
    json={"url": "https://suumo.jp/..."},
    timeout=120,
).json()

# 法的スコア・収益・投資スコアを取り出す
ar = result["analysis_result"]
print(ar["legal_score"], ar["total_investment_score"])

Claude Code / MCP 統合

MCP サーバーを追加すると、Claude との会話の中で自然言語で物件を分析できます。

1. MCP サーバーを起動

pip install mcp httpx
# Es-sense リポジトリから mcp_server/main.py を取得するか、以下の pip パッケージを使用
export ES_SENSE_API_KEY=eak_your_key_here
python -m mcp_server.main  # デフォルトで localhost:8001/mcp で起動

2. Claude 設定ファイルに追加 (~/.claude.json)

{
  "mcpServers": {
    "insight": {
      "type": "http",
      "url": "http://localhost:8001/mcp",
      "headers": { "X-API-Key": "eak_your_key_here" }
    }
  }
}

3. Claude に話しかけるだけ

「この物件 URL を分析して」と送るだけで analyze_property ツールが自動実行されます。

エンドポイント一覧

メソッド パス 説明 認証
POST /api/v1/public/v1/analyze 物件 URL を分析 X-API-Key
GET /api/v1/public/v1/usage 当月の利用状況 X-API-Key
POST /api/v1/public/v1/keys API キー発行 Bearer JWT
GET /api/v1/public/v1/keys API キー一覧 Bearer JWT
DELETE /api/v1/public/v1/keys/{id} API キー失効 Bearer JWT

OpenAPI スペック: openapi.json

レスポンス例 (analyze)

{
  "status": "success",
  "cached": false,
  "property_data": {
    "address": "沖縄県那覇市○○",
    "price": "2,480万円",
    "building_area": "85.2㎡"
  },
  "analysis_result": {
    "legal_score": 8,
    "surface_yield": "9.2%",
    "total_investment_score": 74,
    "investment_grade": "B",
    "investment_judgment": { ... }
  },
  "api_usage_this_month": 12,
  "billable": false
}

今すぐ試す

無料枠 50 件で始められます。カード登録不要。

API キーを取得する