# اتاقک (Otaghak MCP)

ویلا، کلبه و آپارتمان را در اتاقک جستجو کنید: شب‌های خالی، مبلغ دقیق اقامت برای تاریخ و نفرات شما، نظرات و وضعیت میزبان

- نوع: سرور MCP
- دسته: سفر و اقامت
- منبع: ساختهٔ بازارچه
- سازنده: sepehr071 (https://github.com/sepehr071)
- مجوز: MIT
- زبان: Python
- آخرین بررسی: 2026-11-14
- صفحه: https://mcpfarsi.ir/servers/otaghak/
- مخزن: https://github.com/sepehr071/otaghak-mcp
- وب‌سایت سرویس: https://www.otaghak.com

## هشدارها

- اتصال با API غیررسمی: از راه رسمی وصل نمی‌شود و ممکن است ناگهان از کار بیفتد.

## نصب

- اجرا (stdio): `uvx otaghak-mcp`
- بدون نصب: از راه روتر MCP (https://mcp.mcpfarsi.ir/mcp، ورود با OAuth)؛ راهنما: https://mcpfarsi.ir/start/
- متغیر محیطی `OTAGHAK_MCP_PROXY` (اختیاری): اختیاری: نشانی یک پراکسی HTTP (سرور واسط)، اگر اتاقک درخواست‌ها را رد کرد

## API اتاقک

- REST API روتر MCP همین ابزار را برای اسکریپت و برنامه هم اجرا می‌کند: `GET https://mcpfarsi.ir/api/v1/tools?q=` قابلیت‌ها و آرگومان‌هایشان را برمی‌گرداند و `POST https://mcpfarsi.ir/api/v1/call` یکی را اجرا می‌کند. شناسهٔ سرور: `otaghak`.
- اول ابزار را در داشبورد به ابزارهای خودتان اضافه کنید، بعد کلید API را در https://mcpfarsi.ir/dashboard/?tab=access بسازید و با `Authorization: Bearer <کلید>` بفرستید. هر اجرای موفق از سقف طرح کم می‌شود (https://mcpfarsi.ir/pricing/).

```sh
curl "https://mcpfarsi.ir/api/v1/tools?q=otaghak&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "otaghak", "tool": "ot_search_rooms", "arguments": {}}'
```

## حالت حساب

- روتر MCP (https://mcp.mcpfarsi.ir/mcp) این ابزار را با حساب خود کاربر هم اجرا می‌کند: ابزار را در داشبورد https://mcpfarsi.ir/dashboard/ اضافه کنید و یک بار در همان سایت وارد حساب سرویس شوید (اتصال حساب).
- پلن «رایگان» و «پایه»: فقط قابلیت‌های خواندنی. پلن «حرفه‌ای» و «کسب‌وکار»: قابلیت‌هایی هم که حساب را تغییر می‌دهند؛ کارهای برگشت‌ناپذیر فقط بعد از تأیید کاربر در سایت. تعرفه‌ها: https://mcpfarsi.ir/pricing/

## ابزارها

- `ot_search_rooms`: جستجوی ویلا، کلبه، آپارتمان و بوم‌گردی در یک شهر، استان یا مجموعه
- `ot_find_place`: تبدیل نام مکان به کد شهر و استان، یا پیدا کردن اقامتگاه با کد آن
- `ot_search_filters`: فیلترهای جستجو و کدهای آن‌ها
- `ot_destinations`: مقصدها و مجموعه‌های پرطرفدار
- `ot_deals`: تخفیف‌های لحظه آخری و پرتخفیف‌ترین اقامتگاه‌ها
- `ot_room`: جزئیات یک اقامتگاه: ظرفیت، امکانات، قوانین، کنسلی و میزبان
- `ot_reviews`: امتیاز کلی، نمره هر بخش و نظرات مهمانان
- `ot_similar_rooms`: اقامتگاه‌های مشابه در همان شهر
- `ot_host`: وضعیت میزبان: زمان و نرخ پاسخ، اقامتگاه‌ها و نظرات
- `ot_room_calendar`: تقویم روزبه‌روز: قیمت هر شب، خالی یا رزروشده، و حداقل تعداد شب
- `ot_price_quote`: مبلغ دقیق اقامت برای تاریخ و تعداد نفرات، با هزینه نفر اضافه
- `ot_late_checkout`: امکان و هزینه دیرتر تخلیه کردن اقامتگاه
- `ot_holidays`: تعطیلات رسمی ایران در یک بازه، با تاریخ شمسی
- `ot_help`: پرسش‌های متداول و قوانین رزرو، کنسلی و استرداد
- `ot_travel_guide`: راهنمای سفر یک مقصد
- `ot_account` (با حساب): وضعیت ورود به حساب و شمارهٔ موبایل (نیمه‌پنهان)
- `ot_favorites` (با حساب): اقامتگاه‌هایی که در اتاقک پسندیده‌اید
- `ot_favorite` (با حساب، تغییر حساب): افزودن اقامتگاه به علاقه‌مندی‌ها یا برداشتن آن
- `ot_wallet` (با حساب): کیف پول، اعتبار، اعتبار هدیه و کدهای تخفیف شما در اتاقک به تومان
- `ot_transactions` (با حساب): تراکنش‌های کیف پول شما، تازه‌ترین اول
- `ot_my_trips` (با حساب): رزروهای شما در اتاقک: وضعیت، اقامتگاه، شهر، تاریخ‌ها و مبلغ کل
- `ot_trip` (با حساب): یک رزرو شما با وضعیتش و کاری که الان می‌شود کرد
- `ot_chat` (با حساب): گفتگوی شما با میزبان یک رزرو، از قدیمی به جدید
- `ot_send_message` (با حساب، تغییر حساب): فرستادن پیام به میزبان یکی از رزروهای شما (با تأیید شما)
- `ot_request_booking` (با حساب، تغییر حساب): فرستادن درخواست رزرو برای تاریخ و تعداد مهمان؛ پولی پرداخت نمی‌شود و میزبان قبول یا رد می‌کند (با تأیید شما)
- `ot_cancel_booking` (با حساب، تغییر حساب): لغو یکی از رزروهای شما، چه در انتظار میزبان، چه پذیرفته یا پرداخت‌شده (با تأیید شما)
- `ot_invoice` (با حساب): فاکتور یکی از رزروهای شما
- `ot_my_review` (با حساب): نظر و امتیازی که برای یک رزرو ثبت کرده‌اید
- `ot_review` (با حساب، تغییر حساب): ثبت امتیاز و نظر شما دربارهٔ یک اقامت تمام‌شده (با تأیید شما)

## نمونه سؤال‌ها

- ارزان‌ترین ویلای استخردار رامسر برای ۶ نفر، آخر هفته بعد، چند تمام می‌شود؟
- یک کلبه جنگلی در ماسال برای ۴ نفر، آخر هفته بعد، با رزرو آنی پیدا کن.
- کلبه‌هایی در گیلان پیدا کن که حیوان خانگی می‌پذیرند و امتیازشان ۴ یا بیشتر است.
- رزروهای من در اتاقک در چه وضعیتی هستند و میزبان چه جوابی داده؟

## توضیحات

با این سرور، دستیار هوش مصنوعی شما در اتاقک ویلا، کلبه و آپارتمان جستجو می‌کند و شب‌های خالی را می‌بیند. مبلغ دقیق اقامت را با قیمت تک‌تک شب‌ها، هزینه نفر اضافه و دیرتر تخلیه کردن حساب می‌کند و نظرات مهمانان و وضعیت میزبان را می‌خواند.

#### نکته‌ها

- بدون اتصال حساب فقط اطلاعات را می‌خواند: وارد حساب شما نمی‌شود و رزرو یا پرداخت نمی‌کند. اگر در روتر MCP حساب اتاقک خود را وصل کنید، دستیار به رزروها، گفتگو با میزبان و کیف پول شما هم دسترسی پیدا می‌کند.
- غیررسمی است (سازنده‌اش خود اتاقک نیست) و ۱۵ قابلیت دارد.
- به IP ایران (اینترنتی که از داخل ایران وصل است) نیاز ندارد: با اینترنت ایران و ترکیه آزمایش شده است. اگر اتاقک درخواست‌ها را رد کرد، `OTAGHAK_MCP_PROXY` را روی یک پراکسی HTTP (سرور واسط) بگذارید.
- همه قیمت‌ها به تومان است و تاریخ‌ها میلادی و به شکل `YYYY-MM-DD` هستند.
- این سرور در روتر MCP هم هست: کافی است در داشبورد اضافه‌اش کنید.
