Пятёрочка MCP: каталог, акции и заказ доставки через агента

dreamcatchered/pyaterochka-mcp-tool· Проверено 12.11.2026· 10на GitHub

Даёт агенту каталог «Пятёрочки» на 5ka.ru: найти магазин по адресу, товары с ценой по карте и акциями, а во втором варианте собрать корзину и оформить доставку после вашего подтверждения.

2 реализации:

Только каталог без входа в аккаунт: магазины, товары, акции и состав; в комплекте HTTP-режим и Telegram-бот.

Как подключить

Что сделать до подключения

Python 3.10 или новее

Склонировать репозиторий, создать окружение python -m venv .venv и выполнить pip install -r requirements.txt

Браузерный режим без cookies: pip install "camoufox[geoip]" и один раз python -m camoufox fetch, это около 150 МБ

PYATEROCHKA_COOKIES_FILE

Нужен, если не ставили camoufox: откройте 5ka.ru без входа, выгрузите cookies расширением вроде Get cookies.txt LOCALLY и сохраните файл вне репозитория

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PYATEROCHKA_COOKIES_FILE=<путь к cookies.json>' --transport stdio pyaterochka \
  -- python '<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.pyaterochka]
command = "python"
args = ["<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"]

[mcp_servers.pyaterochka.env]
PYATEROCHKA_COOKIES_FILE = "<путь к cookies.json>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "pyaterochka": {
      "command": "python",
      "args": ["<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"],
      "env": {
        "PYATEROCHKA_COOKIES_FILE": "<путь к cookies.json>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "pyaterochka": {
      "type": "stdio",
      "command": "python",
      "args": ["<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"],
      "env": {
        "PYATEROCHKA_COOKIES_FILE": "<путь к cookies.json>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "pyaterochka": {
      "command": "python",
      "args": ["<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"],
      "env": {
        "PYATEROCHKA_COOKIES_FILE": "<путь к cookies.json>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "pyaterochka": {
      "command": "python",
      "args": ["<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"],
      "env": {
        "PYATEROCHKA_COOKIES_FILE": "<путь к cookies.json>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "pyaterochka": {
        "type": "local",
        "command": ["python", "<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"],
        "environment": {
          "PYATEROCHKA_COOKIES_FILE": "<путь к cookies.json>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "pyaterochka": {
      "command": "python",
      "args": ["<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"],
      "env": {
        "PYATEROCHKA_COOKIES_FILE": "<путь к cookies.json>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "pyaterochka": {
      "command": "python",
      "args": ["<путь к pyaterochka-mcp-tool>/mcp/mcp_server.py"],
      "env": {
        "PYATEROCHKA_COOKIES_FILE": "<путь к cookies.json>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

find_storeнаходит магазин по адресу

find_nearest_storesищет ближайшие магазины по координатам

get_store_infoчитает карточку магазина

get_store_hoursпоказывает часы работы

list_stores_in_areaперечисляет магазины в области карты

list_store_categoriesчитает дерево категорий магазина

search_productsищет товары по цене, бренду и акциям

list_category_productsпоказывает товары категории

find_productsищет товары по адресу или магазину

get_product_promotionчитает условия акции

get_product_infoчитает состав, калории и БЖУ

refresh_sessionобновляет сессию 5ka.ru

Работает с вашим аккаунтом X5ID: адреса доставки, общая корзина, интервалы, оплата и заказ в два шага с подтверждением точной суммы.

Как подключить

Что сделать до подключения

Python 3.12 или новее и Google Chrome

В папке репозитория: python3 -m venv .venv и .venv/bin/pip install -e '.[dev,capture]'

Запустить .venv/bin/pyaterochka-capture, в открывшемся окне Chrome войти через X5ID, выбрать адрес, добавить и удалить один товар и закрыть окно

Для заказов вручную включить checkout.submit_enabled и задать max_total в ~/.config/pyaterochka-mcp/config.json

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio pyaterochka-mcp \
  -- '<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.pyaterochka-mcp]
command = "<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "pyaterochka-mcp": {
      "command": "<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "pyaterochka-mcp": {
      "type": "stdio",
      "command": "<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "pyaterochka-mcp": {
      "command": "<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "pyaterochka-mcp": {
      "command": "<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "pyaterochka-mcp": {
        "type": "local",
        "command": ["<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "pyaterochka-mcp": {
      "command": "<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "pyaterochka-mcp": {
      "command": "<путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp",
      "args": []
    }
  }
}

Инструменты сервера

pyaterochka_statusпроверяет сессию, магазин и готовность заказа

search_delivery_addressesищет адрес по подсказкам 5ka.ru

set_delivery_addressзадаёт адрес и подбирает магазин

use_addressпереключает на сохранённый адрес

find_nearest_storeнаходит магазин по координатам

set_storeвыбирает магазин по коду

list_categoriesпоказывает категории магазина

search_productsищет товары и цены

get_productчитает карточку и наличие товара

view_cartчитает корзину аккаунта

add_to_cartдобавляет товар в корзину

update_cart_itemменяет количество позиции

list_delivery_intervalsчитает интервалы доставки

select_delivery_intervalвыбирает интервал или экспресс

list_payment_methodsпоказывает маскированные способы оплаты

select_payment_methodвыбирает способ оплаты

checkout_previewпоказывает точный итог заказа

confirm_orderотправляет заказ после подтверждения

get_order_statusчитает статус заказа

cancel_orderотменяет указанный заказ

Показано 20 из 32.

Что попросить агента

«Найди в «Пятёрочке» по адресу <адрес> молоко дешевле 200 рублей и отсортируй по цене»Агент вызовет find_store, затем search_products с фильтром цены и сортировкой

«Что из кофе сейчас по акции рядом со мной?»Агент найдёт магазин через find_nearest_stores, вызовет search_products с фильтром акций и get_product_promotion

«Сколько калорий и белка в <товар> из ближайшей «Пятёрочки»?»Агент вызовет search_products и get_product_info

«Добавь в корзину <список продуктов>, выбери ближайший интервал доставки и покажи итог»Агент вызовет search_products, add_to_cart, list_delivery_intervals, select_delivery_interval и checkout_preview, заказ без вашего подтверждения не отправит

«Где мой заказ <номер>?»Агент вызовет get_order_status или active_orders

Для каких задач

Найти ближайшую «Пятёрочку» по адресу и узнать часы работы

Подобрать молоко дешевле 200 ₽ в конкретном магазине с сортировкой по цене

Показать, что из кофе сейчас по акции, с ценой по карте и старой ценой

Прочитать состав, калории и БЖУ товара

Собрать корзину, выбрать интервал доставки и получить точную итоговую сумму до оплаты

Ограничения

Оба проекта сделаны сторонними авторами и с X5 Group не связаны; приватные интерфейсы 5ka.ru могут измениться, попасть под блокировку или противоречить пользовательскому соглашению

У репозиториев 10 и 4 звезды на GitHub; Pyaterochka MCP Tool не обновлялся с 23.08.2026, pyaterochka-mcp с 31.07.2026 и помечен автором как экспериментальная alpha

confirm_order во втором варианте может списать деньги с привязанной карты; 3-D Secure, СБП и SberPay агент не проходит, подтверждение остаётся за вами

HTTP-режим первого варианта через ngrok или cloudflared работает без авторизации: любой, кто узнает адрес, пользуется вашими инструментами

Если не работает

Запросы к 5ka.ru получают 403 или упираются в антибот

В первом варианте поставьте браузерный режим camoufox, он надёжнее cookies. Во втором используйте Chrome transport: запросы идут внутри открытой вкладки 5ka.ru.

confirm_order вернул сетевую ошибку

Не повторяйте вызов. Сначала проверьте view_cart, active_orders и order_history: повторная отправка может создать второй заказ.

checkout_preview сбрасывается и заказ не отправляется

Корзину изменил другой клиент с той же сессией X5ID или сменился адрес. Не собирайте корзину одновременно в приложении и через агента, затем повторите checkout_preview.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Pyaterochka MCP Tool	dreamcatchered	10	локально	не нужен	12	23 августа 2026
pyaterochka-mcp	shi-kirill	4	локально	не нужен	32	31 июля 2026

Частые вопросы

Нужен ли аккаунт «Пятёрочки»?

Для каталога нет: Pyaterochka MCP Tool работает с открытым веб-каталогом без логина. Корзина и заказ в pyaterochka-mcp идут через ваш вход X5ID, номер телефона и SMS-код вы вводите сами в окне Chrome.

Агент может сам оформить заказ и списать деньги?

Только в pyaterochka-mcp и только после checkout_preview с точной суммой, одноразовым токеном и вашим подтверждением. По умолчанию отправка заказа выключена, а сумму ограничивает max_total в конфиге.

Для какого магазина агент показывает цены?

Каталог, цены и наличие привязаны к адресу и выбранному магазину. Смена адреса меняет магазин, а с ним цены, наличие и стоимость доставки.

Зачем первому варианту cookies.json?

Без браузера camoufox запросы к 5ka.ru идут через aiohttp с вашими cookies. Входить на сайт не нужно, файл просто снимается с открытой страницы; публиковать его нельзя, это живая веб-сессия.

Можно ли собирать корзину с телефона и через агента одновременно?

Корзина хранится на стороне «Пятёрочки», и сайт, приложение и MCP видят одну и ту же. Изменение из другого клиента аннулирует preview, и заказ не уйдёт до нового пересчёта.

Как подключить Пятёрочка MCP к Codex?

Для pyaterochka-mcp выполните codex mcp add pyaterochka -- <путь к pyaterochka-mcp>/.venv/bin/pyaterochka-mcp, затем перезапустите клиент и первым вызовите pyaterochka_status.

Как подключить Пятёрочка MCP к Claude Desktop?

Добавьте в claude_desktop_config.json сервер с командой python и путём к mcp/mcp_server.py, в env укажите PYATEROCHKA_COOKIES_FILE. Формат для остальных клиентов есть во вкладках блока «Как подключить».

Работает ли сервер из России?

Серверы запускаются на вашем компьютере и обращаются к 5ka.ru напрямую; зарубежные аккаунты не нужны, для корзины и заказа нужен ваш аккаунт X5ID.

Пятёрочка MCP: каталог, акции и заказ доставки через агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы