Shisha Market MCP

Подключите ИИ-помощника к своему аккаунту Shisha Market: создавайте объявления с фотографиями, следите за модерацией, исправляйте и снимайте свои публикации.

Node.js 22+ · stdio · 11 инструментов · MIT · без runtime-зависимостей

Обзор · Подключение · Правила площадки

Установка

Скачайте user.mjs из последнего релиза в постоянную папку или клонируйте репозиторий:

git clone https://github.com/vixkosla/shisha-market-mcp.git
cd shisha-market-mcp
node --version

Для запуска не нужны npm install или ключ администратора. Добавьте локальный сервер в настройки MCP вашего помощника:

{
  "mcpServers": {
    "shisha-market": {
      "command": "node",
      "args": ["/absolute/path/to/shisha-market-mcp/user.mjs"]
    }
  }
}

Замените путь своим; пример для Windows — C:/Users/name/shisha-market-mcp/user.mjs. Формат настроек зависит от приложения, команда и аргумент остаются теми же. Нужен клиент с поддержкой локальных MCP-серверов через stdio. Прямое скачивание также доступно на сайте.

Related MCP server: Haraj MCP Server

Подключение аккаунта

1. Попросите помощника: «Подключи мой аккаунт Shisha Market».

2. connect_account вернёт ссылку и код из восьми символов. Откройте ссылку самостоятельно, войдите по почте, введите код и подтвердите доступ.

3. Вернитесь к помощнику и попросите завершить подключение (finish_connection).

4. Проверьте подключённую почту через get_account.

Ссылка действует 10 минут. Если подтверждение ещё не завершено, сервер отвечает pending; повторять запрос следует не чаще раза в 5 секунд. Почтовый код входа не нужно передавать агенту.

Объявления

Передайте описание вещи и выбранные фотографии. Агент читает текущие правила через get_publication_rules, показывает итоговый текст, цену, город, контакт и фото. После ваших отдельных согласий для этого объявления отправляет его на модерацию. Подключение аккаунта само по себе не разрешает публикацию.

Новые и исправленные объявления проходят обычную модерацию. Доступны 1–6 локальных фотографий JPG, PNG или WebP, суммарно до 8 МБ. При правке нужен текущий revision; после неопределённого ответа на создание сначала проверьте список своих объявлений, чтобы не создать дубликат.

Инструменты

Доступ и настройки

Личный ключ хранится в ~/.config/shisha-market/user-auth.json, привязан к адресу сервиса и действует до 90 дней. На POSIX-системах файл создаётся с правами 0600. Ключ не возвращается в ответах инструментов. Отозвать подключение можно в личном кабинете или через disconnect_account.

Не добавляйте файл подключения в Git. Агент получает права обычного пользователя: работает со своими объявлениями, не может модерировать или читать чужие закрытые данные. Авторизация и модерация выполняются сервером Shisha Market.

Разработка и проверка

npm ci
npm run check

Dev-зависимость — официальный MCP SDK. Проверки запускают клиент настоящим subprocess, используют временный локальный HTTP-сервер и синтетические данные. Они не обращаются к рабочим аккаунтам и не публикуют объявления. CI выполняет их на Node.js 22 и 24.

user.mjs версии 1.0.0 совпадает с клиентом, опубликованным на Shisha Market 8 ноября 2026 года. Проверить файл релиза можно по SHA256SUMS. Реализация серверного API и служебный операторский клиент в этот репозиторий не входят. Удалённый HTTP/OAuth MCP по одному URL в этой версии не реализован.

Исправления можно предложить через Issues и Pull Requests. Не включайте в обращения личные ключи, фотографии или данные аккаунта. Лицензия кода и документации — MIT.

English

A local stdio MCP server for your own Shisha Market account. Requires Node.js 22+; no runtime packages or operator key. Download user.mjs from Releases, configure node with its absolute path, then use connect_account and approve access in your browser. Call finish_connection after approval. All 11 tools are listed above. Listings require explicit publication consent and moderation. English service documentation: https://shisha-market.com/en/mcp.