Otaghak

🏡 otaghak-mcp：AI エージェント向け Otaghak MCP サーバー

Otaghak（اتاقک）向けの非公式な読み取り専用 MCP サーバーです。AI エージェントでイランの宿泊先を探せます。
イラン各地のヴィラ、コテージ、アパートを検索し、空室のある日を確認して、指定した日程と宿泊人数に応じた正確な料金
を調べたり、レビューやホストの統計情報を確認したりできます。すべて Claude、Cursor、Copilot から利用できます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくとよいこと · FAQ · 設定 · فارسی · 開発 · 関連サーバー · 免責事項 · ライセンス

AI エージェント向け

• 概要： ヴィラ、コテージ、アパートを扱うイランのマーケットプレイス、Otaghak（اتاقک）向けの非公式な読み取り専用 MCP サーバーです。ペルシャ語でのクエリが最適ですが、英語のスラッグも使用できます。料金の単位はトマンです。
• インストール： claude mcp add otaghak -- uvx otaghak-mcp（stdio トランスポート。Python 3.10+ と uv が必要です）。
• 認証： 不要です。API キーも必要ありません。Otaghak にネットワークをブロックされた場合は、任意で OTAGHAK_MCP_PROXY（HTTP プロキシ、またはカンマ区切りのリスト）を指定できます。
• アクセス： 読み取り専用です。ログイン、予約、支払い、SMS コードの操作はないため、ツールを呼び出す前の確認は不要です。
• ツール： 15 個あり、すべて ot_* で始まります。まず ot_find_place を使い、次に ot_search_rooms → ot_room または ot_room_calendar → ot_price_quote の順に使います。お得な物件を探すには ot_deals を使います。
• 利用する場面： イランの宿泊先を探し、日程と宿泊人数に応じた正確な合計金額を、レビューやホストの統計情報とあわせて確認するときに使います。
• 利用しない場面： 予約や支払いが必要な場合（ユーザーが otaghak.com で行います）、または公開カレンダーの範囲外の料金が必要な場合（翌月のジャラーリー暦の月末まで、最大 20 泊）には使用しないでください。
• 出力： コンパクトな JSON です。料金はトマン、日付はグレゴリオ暦の YYYY-MM-DD 形式（check_out は出発日）、評価は 0～5 です。ツール間では数値の部屋 ID を渡してください。
• 機械可読データ： server.json。イランの MCP サーバー一覧は iran-mcp を参照してください（TOOLS.md、servers.json、llms.txt）。

概要

Otaghakでは、宿泊施設の一覧カードに表示されている料金で支払うことはほとんどありません。泊まる日によって料金が異なり、週末は割高になり、割引額も日ごとに変わります。追加の宿泊者には1泊ごとに追加料金がかかり、カレンダーは約1か月先までしか開放されません。希望の日程と人数での実際の合計額を知るには、部屋ごとにカレンダーを開いて確認する必要があります。otaghak-mcp を使えば、エージェントが代わりに確認します。

あなた： 4人で、10月20日から23日まで、ラムサールに泊まります。「سوییسی لیلی」コテージの合計はいくらですか？

エージェント： 呼び出し ot_search_rooms(city=["ramsar"], name="لیلی") → ot_price_quote(room_id=2508916, check_in="2026-10-20", check_out="2026-10-23", guests=4)

泊まる日	料金	割引前
10月20日（火）	4,000,000	5,000,000
10月21日（水）	4,000,000	5,000,000
10月22日（木）	4,250,000	5,000,000
追加の宿泊者1人（3泊）	980,000	1,200,000
支払合計	13,230,000

コテージの基本料金には3人分が含まれ、最大4人まで宿泊できるため、4人目には1泊400,000の追加料金がかかります（こちらも割引されますが、各泊の料金とは割引率がわずかに異なります）。3泊とも空室があり、すぐに予約できます。ot_similar_rooms で類似の宿泊施設と比較しましょうか？

_{2026-10-04時点の実際のツール出力です。料金は常に変動します。料金の単位はトマンです。}

できること

• 🔎 検索：希望の日程と人数で、都市、州、またはテーマ別コレクション（ビーチ、ジャングル、プール付きヴィラなど）から宿泊施設を検索し、料金、評価、割引率で並べ替えます
• 🧮 正確な料金：日程と宿泊人数に応じて、割引後の各泊の料金、追加の宿泊者料金、オプションのレイトチェックアウト料金を確認できます
• 📅 カレンダー：空室のある日、1泊ごとの料金、最短・最長の宿泊日数、週末、祝日を確認できます
• 🏠 部屋の詳細：部屋とベッド、アメニティ、ハウスルール、チェックイン時刻、キャンセルポリシー、近くのショップ、写真を確認できます
• ⭐ 品質：評価、6つのカテゴリ別スコア、おすすめした人の割合、ホストの返信付きレビュー、ホストの応答時間と承認率を確認できます
• 🏷️ お得情報：直前割引と、割引率が最も高い宿泊施設を確認できます
• 🧭 ガイド：旅行先ガイド、FAQ、ブログ記事、サイトのルール（キャンセル、返金）を確認できます
• 🔒 読み取り専用設計：ログイン、予約、支払い、SMSコードは不要です

クイックスタート

uv が必要です。

claude mcp add otaghak -- uvx otaghak-mcp

{
  "mcpServers": {
    "otaghak": { "command": "uvx", "args": ["otaghak-mcp"] }
  }
}

{
  "servers": {
    "otaghak": { "type": "stdio", "command": "uvx", "args": ["otaghak-mcp"] }
  }
}

codex mcp add otaghak -- uvx otaghak-mcp

[mcp_servers.otaghak]
command = "uvx"
args = ["otaghak-mcp"]

{
  "mcpServers": {
    "otaghak": { "command": "uvx", "args": ["otaghak-mcp"] }
  }
}

あとは、次のように尋ねるだけです。

• 「来週末、ラムサール近郊で6人が泊まれる、プール付きの最安のヴィラは？」
• 「2512254号室は10月20日から23日まで空いていますか？5名の合計料金はいくらですか？」
• 「ギーラーンで、評価が4以上のペット可コテージを探して。」
• 「2512254号室のレビューとホストの返信率を表示してから、同じ日程で似た部屋を提案して。」
• 「来月にあるイランの祝日は？また、この部屋ではレイトチェックアウトが利用できますか？」
• یک کلبه جنگلی در ماسال برای ۴ نفر، آخر هفته بعد، با رزرو آنی پیدا کن.
• قیمت نهایی ویلای شماره ۲۵۱۲۲۵۴ برای ۵ نفر از ۲۰ تا ۲۳ اکتبر چقدر می‌شود؟
• تخفیف‌دارترین اقامتگاه‌های شمال را نشان بده.

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  otaghak-mcp  (runs on your machine)
      │
      │  HTTPS (REST + OData)
      └──────▶  core.otaghak.com, www.otaghak.com/blog

otaghak-mcp はローカルで動作し、otaghak.com のウェブサイトと同じ公開エンドポイントを呼び出します。 間にホスト型サーバーはなく、API キーも必要ありません。また、あなたに関する情報がほかの場所に送信されることもありません。

ツール

部屋は 2512254 のような数値 ID（otaghak.com/room/2512254/ の数値）で、場所は ramsar（市）、mazandaran（州）、beach（コレクション）のようなスラッグで識別します。

15 個のツールすべてに readOnlyHint: true が注釈として付与され、コンパクトな構造化 JSON を返すため、エージェントのコンテキストを圧迫しません。

知っておくと便利なこと

• 料金はトマン建てです。サイトと同じ表記です（1 トマン = 10 リアル）。price_per_night は割引後の料金です。日程を指定しない場合、料金は見積もりではなく、日程未指定時の部屋の最低料金です。
• 支払額は ot_price_quote の total です。割引後の宿泊料金（部屋ページに表示される支払額）に、部屋の基本宿泊人数を超える追加宿泊者の料金（宿泊料金と同じ割引率）と、オプションのレイトチェックアウト料金を加えた額です。クーポンとウォレットの残高はログインが必要なため、含まれません。検索結果には stay_total の概算額が表示され、数トマン程度の誤差が生じる場合があります。日程を指定した場合、sort="cheapest" は各ページ内でこの金額の安い順に並べ替えます。
• 日付はグレゴリオ暦の YYYY-MM-DD 形式で、check_out は出発日です。過去の日付は指定できず、宿泊できるのは最大20泊までです。また、ホストのカレンダーを確認できるのは次のジャラーリー暦の月末までです。該当する場合、ツールは空のリストを返すのではなく、その旨を明確に伝えます。ジャラーリー暦の日付を指定すると、対応するグレゴリオ暦の日付とともにエラーが返されます。
• **宿泊人数：**各部屋の料金には base_guests までの人数が含まれ、最大 max_guests 人まで宿泊できます。ot_price_quote は人数制限を独自に確認します（特定の部屋を指定した場合、サイトの検索機能では確認されません）。
• 評価は0～5です。null はまだ評価が付いていないことを示します。祝日の情報が公開されるのは、約7週間前からです。
• 場所はおおよその位置です。正確な住所とホストの電話番号は、予約後にのみ確認できます。
• ペルシャ語で検索すると、最もよく一致します（رامسر、کلبه）。英語のスラッグも使えます。

FAQ

npx @modelcontextprotocol/inspector uvx otaghak-mcp

設定

ペルシャ語：Otaghak MCP サーバー

claude mcp add otaghak -- uvx otaghak-mcp

開発

git clone https://github.com/sepehr071/otaghak-mcp && cd otaghak-mcp
uv sync
uv run python -m pytest            # offline, against recorded responses
uv run python -m pytest -m live    # real API
uv run ruff check .

ツールは src/otaghak_mcp/search.py、room.py、pricing.py、info.py にあります。それぞれ、エージェントがいつ使うべきかを説明する docstring を備えた、型付きの非同期関数です。問題の報告や PR を歓迎します。特に、新しいツールや API の変更への対応を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新してから、v* タグをプッシュします。GitHub Actions がテストを実行し、PyPI と MCP レジストリに公開して、GitHub Release を作成します。

関連サーバー

• ヴィラ、ツアー、イベント向けのJabama MCP サーバー
• フライト、ホテル、ヴィラ向けのFlytoday MCP サーバー
• フライト、列車、バス、ホテル向けのMrBilit MCP サーバー
• イランで発生した最近の地震向けのIran Quake MCP サーバー
• すべてのサーバー：iran-mcp。イランの MCP サーバーのカタログです。

クリック数の削減に役立ったら、スターを付けてほかの人にも見つけてもらいましょう。

免責事項

非公式のプロジェクトであり、Otaghak とは提携しておらず、同社の承認も受けていません。otaghak.com ウェブサイトの公開エンドポイントを使用しているため、予告なく変更されることがあります。Otaghak は契約を結んだパートナー向けに公式の予約ウェブサービスを提供していますが、このサーバーはそれではありません。リクエスト頻度は適切に保ってください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedInでつながるか、GitHub の @sepehr071をフォローして、イランのウェブサイト向け MCP サーバーをご覧ください。すべてiran-mcpに掲載されています。時間の節約に役立ったら、リポジトリにスターを付けて、ほかの人にも見つけてもらいましょう。

ライセンス

MIT