Руководство по коннектору9 мин чтенияMCP-инструментов: 277 языков

Skroutz MCP: подключить к Gemini CLI

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

HCАвтор: команда HelpCodeОбновлено 9 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Skroutz

Skroutz

Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.

инструментов

27

Регион

INTL

Категория

Электронная коммерция

Аутентификация

API credentials

Требуемые env-vars

SKROUTZ_API_TOKEN
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Пошаговая настройка

Подключи Skroutz к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Skroutz в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для Skroutz

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Skroutz · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Skroutz, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого git clone, никакого локального сервера.

Skroutz + Gemini

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Предварительные требования

Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

SKROUTZ_API_TOKEN

Шаг 1 — Получи учетные данные

Настройка занимает около 3 минут.

  1. Войди в панель продавцов Skroutz и открой Услуги, Skroutz Marketplace (страница настроек Умной корзины).
  2. Сгенерируй API токен и вставь его в SKROUTZ_API_TOKEN. У магазина есть один активный токен: генерация нового завершает предыдущий, поэтому токен, используемый другой интеграцией, перестает работать.
  3. По желанию, для массовых обновлений цен и запасов: в Продукты, Обновления ленты сгенерируй токен API продуктов и вставь его в SKROUTZ_PRODUCTS_TOKEN.
  4. По желанию, для заказов CPS из собственного интернет-магазина: в Παραγγελίες καταστήματος, Αυτόματη διαχείριση (заказы магазина, автоматическое управление) сгенерируй токен CPS и вставь его в SKROUTZ_CPS_TOKEN.

Каждый вызов отправляет токен как Authorization: Bearer с типом медиа application/vnd.skroutz+json; version=3.0. Проверка установки считывает демонстрационный заказ DEMO-OPEN, что подтверждает токен рынка, не касаясь реальных данных.

С чего начать: API не имеет списка заказов. Заказы поступают в магазин через вебхук заказа, панель продавцов и электронные письма с заказами, поэтому спроси у пользователя код заказа (например, 191128-1234567) и считай его с помощью skroutz_get_order. Демонстрационные коды DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP и DEMO-RETURN безопасны для чтения, принятия и отклонения в тестировании: ничего не сохраняется.

Заказы: открытый заказ содержит accept_options и reject_options и должен быть обработан до expires_at. Прими его с помощью skroutz_accept_order, отправив идентификатор места получения и идентификатор одного из собственных окон получения этого места (окна различаются по местоположению). Затем Skroutz бронирует курьера, и PDF ваучер появляется в courier_voucher. Экспресс-заказы принимаются Skroutz автоматически. skroutz_reject_order установлен выключенным: отклонение не может быть отменено и учитывается против магазина. Чтобы изменить место получения принятого заказа, считай его с помощью action_options 1 сразу перед этим и используй skroutz_reschedule_order_pickup (дату из reschedule_options) или skroutz_relocate_order_pickup (идентификатор из relocate_options); списки со временем уменьшаются. skroutz_request_preorder_voucher создает ваучер принятого предзаказа заранее.

Установить как Готово: когда заказ показывает set_as_ready_required true, Skroutz Last Mile забирает его только после skroutz_set_order_ready; загрузка ваучера больше не помечает его как готовый (с 30 марта 2026 года). Раннее помечание может переместить получение на более раннее окно. skroutz_set_order_not_ready отменяет это перед получением. Магазины с set_as_ready_required false не нуждаются в этом.

Доставка и документы: skroutz_update_tracking_details отправляет курьера и код отслеживания только для заказов, выполненных продавцом (FBM). skroutz_upload_invoice и skroutz_upload_credit_invoice принимают публичную ссылку на PDF, PNG или JPG (максимум 7 МБ); коннектор загружает его и загружает файл, по одному на заказ, заменяя ранее загруженный.

Возвраты: skroutz_get_return считывает возврат по его коду (например, R-111111-1111111, из вебхука возврата или панели продавцов; returns заказа дает только uuid и идентификаторы отслеживания). skroutz_handle_return (реши возврат, ожидающий проверки до review.expires_at, включая отправку недостающей части за счет магазина) и skroutz_submit_service_inspection (технический отчет о неисправном товаре, как ссылка на файл) установлены выключенными, потому что они приводят к возвратам денег, заменам или платным отправкам. skroutz_file_compensation_request также выключен: он требует деньги от Skroutz за возвращенные товары, и через этот коннектор только по причинам, не требующим фотографий.

Выполнено Skroutz: skroutz_list_fbs_products (запасы на складах Skroutz), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier и skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order выключен, потому что с этим связаны сборы за хранение. Списки разбиты на страницы с помощью page и имеют meta.pagination (100 строк на страницу). Магазин без FBS получает 401 здесь.

API продуктов (нужен SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates проверяет партию без изменений; skroutz_update_products (выключен) обновляет доступность, цену и количество до 500 существующих продуктов и вариаций, асинхронно; skroutz_get_product_update_status сообщает о успехе, отсутствии изменений или сбое для каждого продукта. Цены здесь — целые евроценты (1050 — это 10,50 EUR), в то время как суммы заказов — десятичные евро. Он не создает продукты: они поступают из XML-ленты. Ошибка 422, говорящая, что XML сканируется, означает, что нужно попробовать снова позже.

Заказы CPS (нужен SKROUTZ_CPS_TOKEN): skroutz_get_cps_order считывает продажу из твоего интернет-магазина по твоему собственному номеру заказа, с доходом и комиссией; skroutz_reject_cps_order (выключен) отклоняет его, чтобы не взимать комиссию.

Полевые заметки: время в формате ISO 8601 с афинским смещением (+02:00 зимой, +03:00 летом). Метки, такие как окна получения, причины отклонения и состояния CPS, приходят на греческом. Идентификаторы строк — короткие строки (l39vKqxqwe); shop_uid — это твой собственный идентификатор продукта. Ошибки содержат массив errors с code и messages: 422 order_status означает, что заказ не находится в состоянии для этого действия. Неправильный или замененный токен рынка отвечает 403. Коннектор никогда не перемещает деньги: отклонения, решения по возвратам, требования о компенсации, закупочные заказы и массовые обновления продуктов установлены выключенными, чтобы администратор мог включить их намеренно.

Шаг 2 — Установи адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавь коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
  2. Сохрани файл и перезапусти gemini.
  3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
  4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Skroutz.

Доступные инструменты

ИнструментЧто он делает
skroutz_get_orderЧитает один заказ Skroutz Marketplace (Умная корзина) по его коду: состояние (открыт, принят, отклонен, отменен, истек, отправлен, доставлен…
skroutz_accept_orderПринимает открытый заказ: затем Skroutz бронирует курьера и выдает ваучер (он приходит на заказ как courier_voucher). Отправь…
skroutz_reject_orderОтклоняет открытый заказ, либо по строке с идентификатором причины из reject_options (с available_quantity, когда причина имеет…
skroutz_reschedule_order_pickupПеремещает получение курьером принятого заказа на другую дату. Считай заказ с action_options 1 сразу перед этим и отправь один из его…
skroutz_relocate_order_pickupПеремещает получение курьером принятого заказа на другое место получения магазина, сохраняя дату и слот получения. Курьер…
skroutz_set_order_readyПомечает принятый заказ как упакованный и готовый к отправке (Установить как Готово). Обязательно для магазинов, заказы которых показывают set_as_ready_required true…
skroutz_set_order_not_readyОтменяет Установить как Готово для принятого заказа, который курьер еще не забрал. Skroutz пытается вернуть получение на исходную дату.…
skroutz_update_tracking_detailsОтправляет курьера и код отслеживания каждой отправки заказа, выполненного продавцом (FBM), чтобы клиент мог следить за ним. Только для FBM…
skroutz_request_preorder_voucherЗапрашивает ваучер курьера для принятого предзаказа сейчас, когда продукт прибыл до запланированной даты отправки (создание в панели…
skroutz_upload_invoiceЗагружает квитанцию или счет заказа по ссылке на файл (PDF, PNG или JPG, максимум 7 МБ). Один файл на заказ: новая загрузка…
skroutz_upload_credit_invoiceЗагружает кредитный счет заказа, который был отменен, возвращен, частично возвращен или возвращен отправителю после его получения или счета…
skroutz_file_compensation_requestЗапрашивает у Skroutz компенсацию для магазина за возвращенные товары, отправленные в формате JSON без фотографий, только по причинам, не требующим…
skroutz_get_returnЧитает один возврат по его коду: состояние (ожидание проверки продавцом, возвращение, ожидание физической проверки, ожидание технической проверки, возвращен…
skroutz_handle_returnРешает возврат в состоянии ожидания проверки продавцом с одним из его handle_options: одобрить, отклонение, такое как не неисправный (с комментарием, когда…
skroutz_submit_service_inspectionОтправляет результат технической проверки неисправного возвращенного товара (возврат в состоянии ожидания технической проверки): идентификатор товара, один из его…
skroutz_list_fbs_productsПеречисляет товары магазина, выполненные Skroutz (FBS), хранящиеся на складах Skroutz: идентификатор, shop_uid (твой идентификатор продукта), активный (доступный для покупки из…
skroutz_list_fbs_purchase_ordersПеречисляет закупочные заказы магазина, выполненные Skroutz (запасы, отправленные на склады Skroutz): код, created_at, expected_date и received_at.…
skroutz_list_fbs_purchase_order_itemsПеречисляет строки одного закупочного заказа, выполненного Skroutz: product_id, shop_uid, активный, ожидаемое количество и фактическое количество…
skroutz_create_fbs_purchase_orderОбъявляет новый закупочный заказ, выполненный Skroutz: запасы, которые ты доставишь на склад Skroutz, с ожидаемой датой, поставщиком…
skroutz_list_fbs_suppliersПеречисляет поставщиков магазина, выполненных Skroutz: идентификатор (используй его для закупочных заказов), код, имя, адрес, город, район, почтовый индекс, телефон…
skroutz_create_fbs_supplierДобавляет поставщика, выполненного Skroutz (который отправляет запасы на склад Skroutz для тебя) с уникальным кодом, именем, адресом, городом, районом, почтовым индексом…
skroutz_update_fbs_supplierИзменяет поля поставщика, выполненного Skroutz; изменяются только поля, которые ты отправляешь. Ответ success: true
skroutz_validate_product_updatesПроверяет партию обновлений продуктов (доступность, цена в центах, количество, вариации) без изменений: Skroutz выполняет каждую проверку…
skroutz_update_productsОбновляет доступность, цену (евроценты) и количество до 500 существующих продуктов и их вариаций в одной партии; он не создает…
skroutz_get_product_update_statusЧитает результат обновления партии продуктов: статус (в процессе, пока любой продукт ожидает, затем завершено), created_at и для каждого продукта…
skroutz_get_cps_orderЧитает один заказ CPS (продажа в твоем собственном интернет-магазине, пришедшая от Skroutz, оплаченная комиссией) по коду заказа, который твой магазин ему дал: дата…
skroutz_reject_cps_orderОтклоняет заказ CPS, чтобы Skroutz не взимал комиссию с него, с одним из его reject_options (user_cancel, user_return, undelivered…

Примеры подсказок

  • "Покажи заказ 251114-3920517 с его товарами, его вариантами получения и когда он истекает."
  • "Прими заказ 251114-3920517 для первого окна получения моего склада в Афинах."
  • "Заказ 251112-1187340 нуждается в установке как Готово: готов ли он к пометке, и когда получение?"
  • "Что говорит возврат R-251110-2045318, и до какого срока я должен его проверить?"
  • "Сколько единиц каждого продукта у меня на складах Skroutz?"

Часто задаваемые вопросы

Откуда берутся токены? Из панели продавцов Skroutz, и это три отдельных токена: токен API рынка в разделе Услуги, Skroutz Marketplace (заказы, возвраты, выполненные Skroutz), необязательный токен API продуктов в разделе Продукты, Обновления ленты для массовых обновлений цен и запасов, и необязательный токен CPS для заказов из твоего собственного интернет-магазина. Генерация нового токена рынка завершает старый.

Может ли он перечислить мои заказы? Нет. API Skroutz не имеет списка заказов: заказы поступают в магазин через вебхук, панель продавцов и электронные письма с заказами. Дай ИИ код заказа (например, 251114-3920517), и он прочитает заказ. Демонстрационные коды, такие как DEMO-OPEN, безопасны для тестирования.

Какие инструменты установлены выключенными? skroutz_reject_order и skroutz_reject_cps_order, потому что отклонение не может быть отменено, инструменты возврата skroutz_handle_return, skroutz_submit_service_inspection и skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, что приводит к сборам за хранение, и skroutz_update_products.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

Это руководство помогло?

Подключи Skroutz к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Skroutz в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Skroutz MCP: подключить к ChatGPT

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Claude

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Microsoft Copilot

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Cursor

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP: подключить к Meta Muse

API Skroutz Marketplace (Умная корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, установка в статус 'Готово', отслеживание, загрузка счетов, возвраты, товары, выполненные Skroutz, закупочные заказы и поставщики, массовые обновления цен и запасов и заказы CPS. Токен API из панели продавцов.

Коннекторы

Skroutz MCP-сервер: заказы, остатки и возвраты

API Skroutz Marketplace (Умная Корзина) для продавцов на греческом и кипрском рынках: чтение, принятие и планирование заказов, Установить как Готово, отслеживание, загрузка счетов, возвраты, запасы Выполнено Skroutz, заказы на покупку и поставщики, массовое обновление цен и запасов и заказы CPS. API токен из панели продавцов.