# اسنپ (تاکسی اینترنتی) (Snapp Taxi MCP)

قیمت و زمان رسیدن سرویس‌های اسنپ را بگیرید، سفر را با تأیید قیمت ثبت کنید و راننده را دنبال کنید یا سفر را لغو کنید

- نوع: سرور MCP
- دسته: ابزارهای ایرانی
- منبع: جامعه
- سازنده: Kia-Karami (https://github.com/Kia-Karami)
- مجوز: MIT
- زبان: TypeScript
- آخرین بررسی: 2026-11-14
- صفحه: https://mcpfarsi.ir/servers/snapp-taxi/
- مخزن: https://github.com/Kia-Karami/snapp-mcp
- وب‌سایت سرویس: https://app.snapp.taxi

## هشدارها

- تغییر در حساب شما: بعضی ابزارهایش کاری انجام می‌دهند (مثلاً پیام می‌فرستند)، نه فقط خواندن.
- اتصال با API غیررسمی: از راه رسمی وصل نمی‌شود و ممکن است ناگهان از کار بیفتد.

## نصب

- اجرا (stdio): `npx -y github:Kia-Karami/snapp-mcp`
- بار اول از دستیار بخواهید به اسنپ وارد شود. صفحه ورود خود اسنپ در یک پنجره مرورگر باز می‌شود (Chrome یا Edge اگر نصب باشد، وگرنه WebKit مرورگر Playwright که با npx playwright-core install webkit نصب می‌شود) و شماره، کپچا و کد پیامکی را همان‌جا وارد می‌کنید. نشانه‌های ورود فقط روی کامپیوتر شما می‌ماند.
- متغیر محیطی `SNAPP_BACKEND` (لازم): برای اسنپ واقعی بگذارید snapp. بدون آن، سرور روی یک اسنپ شبیه‌سازی‌شده اجرا می‌شود و هیچ سفر واقعی ثبت نمی‌شود.

## ابزارها

- `get_ride_quotes`: قیمت و زمان رسیدن هر سرویس اسنپ برای یک مسیر، با گزینه ایستگاه دوم. چیزی ثبت نمی‌کند
- `request_ride` (تغییر حساب): ثبت سفر از روی یکی از قیمت‌های گرفته‌شده؛ قیمت تأییدشده باید دقیقاً با قیمت پیشنهاد یکی باشد
- `get_ride_status`: وضعیت سفر: راننده، خودرو، پلاک، موقعیت راننده و زمان رسیدن
- `wait_for_ride_update`: منتظر تغییر وضعیت سفر می‌ماند: پیدا شدن راننده، رسیدن، شروع و پایان سفر
- `cancel_ride` (تغییر حساب): لغو سفر؛ تا دو دقیقه بعد از پذیرفتن راننده رایگان است و بعد از آن کارمزد دارد
- `list_rides`: سفرهای اخیر، تازه‌ترین اول
- `preview_destination_change`: قیمت جدید برای مقصدی دیگر، پیش از تغییر
- `change_destination` (تغییر حساب): تغییر مقصد سفر جاری با قیمت تأییدشده
- `get_schedule_quote`: قیمت سفر برای امروز یا فردا در بازه‌های پنج‌دقیقه‌ای (قیمت به‌صورت بازه است)
- `schedule_ride` (تغییر حساب): ثبت سفر برای بعد
- `list_scheduled_rides`: سفرهای زمان‌بندی‌شده پیش‌رو
- `cancel_scheduled_ride` (تغییر حساب): لغو یک سفر زمان‌بندی‌شده
- `search_address`: پیدا کردن نشانی یا مکان در ایران از روی OpenStreetMap، فارسی یا انگلیسی
- `get_current_location`: جایی که اکنون هستید؛ مبدأ پیش‌فرض
- `set_current_location`: ثبت موقعیت فعلی به‌عنوان مبدأ پیش‌فرض
- `list_places`: مکان‌های ذخیره‌شده مثل خانه و محل کار
- `save_place`: ذخیره یا به‌روزرسانی یک مکان با نام
- `remove_place`: حذف یک مکان ذخیره‌شده
- `suggest_places`: پرتکرارترین مبدأ و مقصدهای شما از تاریخچه سفرها، برای ذخیره به‌عنوان خانه و محل کار
- `snapp_login`: ورود به اسنپ از صفحه ورود خود اسنپ (فقط با اسنپ واقعی)
- `snapp_login_status`: وضعیت ورود به اسنپ
- `snapp_logout`: فراموش کردن نشست اسنپ روی همین کامپیوتر

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

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

## توضیحات

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

#### نکته‌ها

- ثبت سفر دو مرحله دارد: اول قیمت می‌گیرد، بعد فقط با شناسه همان قیمت (پنج دقیقه اعتبار، یک‌بار مصرف) و همان مبلغی که شما تأیید کرده‌اید سفر ثبت می‌شود.
- پیش‌فرض سرور یک اسنپ شبیه‌سازی‌شده است و برای اسنپ واقعی باید `SNAPP_BACKEND=snapp` بگذارید.
- غیررسمی است و از API مستندنشده اسنپ استفاده می‌کند. ممکن است با تغییر اسنپ کار نکند و با شرایط استفاده اسنپ هم ناسازگار باشد. فقط با حساب خودتان به کار ببرید.
- سازنده می‌گوید قیمت، ثبت، وضعیت، لغو و تاریخچه روی اسنپ واقعی امتحان شده است. ثبت سفر زمان‌بندی‌شده را اسنپ در آزمایش او نپذیرفت (خطای ۶۰۰۵) و هنوز امتحان‌نشده است. تغییر مقصد و سفر دوایستگاهی هم زنده امتحان نشده‌اند.
- این سرور سفر واقعی ثبت می‌کند و پول خرج می‌کند. ثبت و لغو را فقط وقتی بخواهید انجام بدهید.
- هنوز یک نسخه ۰٫۱٫۰ تازه است و روی npm منتشر نشده، پس نصبش از GitHub انجام می‌شود.