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

Spartoo Marketplace MCP с Gemini CLI

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

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

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

Spartoo Marketplace

Spartoo Marketplace

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

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

9

Регион

INTL

Категория

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

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

API credentials

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

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

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

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

Кратко

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

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

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

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

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

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

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

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

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

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

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

Spartoo Marketplace + Gemini

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

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

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

SPARTOO_HOST, SPARTOO_PARTNER_KEY

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

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

  1. Войди в административную панель рынка Spartoo и открой Документацию, затем Веб-сервисы и любую страницу сервиса, например, Экспорт заказов.
  2. Строка Webservice URL указывает адрес веб-сервиса твоего сайта Spartoo, например, https://sws.spartoo.eu или https://sws.spartoo.it. Помести часть перед /mp/ в SPARTOO_HOST.
  3. На той же странице строка partner показывает твой уникальный код, когда ты вошел в систему. Помести его в SPARTOO_PARTNER_KEY. Если на странице нет кода, спроси своего контактного лица на рынке Spartoo о коде веб-сервиса твоей учетной записи.

С чего начать: spartoo_list_orders с датой начала. spartoo_get_order считывает один заказ по его id.

Заказы: заказ приходит в статусе 11 (подтвержден). spartoo_accept_order переводит его в 2 (в подготовке): после этого его имя, адрес и перевозчик больше не могут изменяться. spartoo_ship_order переводит его из 2 в 3 (отправлен) с номером отслеживания перевозчика, и Spartoo отправляет ссылку для отслеживания клиенту по электронной почте. spartoo_cancel_order (статус 41) установлен выключенным: клиенту возвращается деньги, и это нельзя отменить. Статусы 45 (посылка потеряна) и 47 (посылка не доставлена) устанавливаются Spartoo.

Возвраты: spartoo_list_returns и spartoo_get_return. Один возврат содержит один продукт. Статусы возвратов: 2 — ожидает получения, 3 — отказано, 4 — посылка получена и возврат принят, 5 — оплачено, 7 — возврат, 14 — ожидает предоплаченной этикетки для возврата от продавца. Этот коннектор не принимает и не отказывает в возвратах.

Продукты и запасы: spartoo_check_product_status сообщает, есть ли продукт на сайте (OK), отсутствует на складе (OS), создан, но еще не в сети (EC) или неизвестен (KO), с указанием причины. spartoo_update_stock устанавливает запас одного размера. Оба используют твои собственные ссылки: reference_partenaire — это продукт в одном цвете, size_reference — один размер этого продукта. Запас 0 убирает размер с сайта.

Примечания к полям

  • Идентификаторы заказов и возвратов — это короткие коды, такие как 90D813EA1A2365A8.
  • Фильтр даты заказа записывается как YYYY-MM-DD:hh:mm:ss с двоеточием между днем и часом. Фильтр даты возврата — это временная метка Unix в секундах. Spartoo не документирует часовой пояс.
  • Цены — это десятичные числа в валюте сайта заказа; products_final_price — это цена со скидкой за единицу, умноженная на количество.
  • Заказ для пункта выдачи имеет relay_info вместо адреса доставки.
  • Текстовые значения приходят как строки, включая числа. Один заказ или продукт в списке приходит как объект, несколько — как массив.

Ошибки: каждый ответ содержит код. 1 означает отсутствие ошибки. -1 и -2: код партнера отсутствует или неизвестен. -3: дата или id отсутствуют. -4: неверный формат даты. -6 и -28: заказ или возврат не найдены. -8: номер отслеживания отклонен. -9: заказ уже имеет этот статус. -19: неверный порядок статусов (2 только из 11, 3 только из 2). -14: продукт не найден. -16, -18 и -20: запас не изменен (невозможно, уже это значение или размер больше не действителен). -30: заказ слишком стар для отправки, свяжись со Spartoo. -428: учетная запись деактивирована. -429: слишком много запросов за один час. Коннектор сообщает отрицательный код как неудавшийся вызов.

Не охвачено: создание и редактирование продуктов, цен и скидок (они проходят через XML-файл каталога), упаковочные листы и решения по возвратам.

Шаг 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 теперь может вызывать инструменты Spartoo Marketplace.

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

ИнструментЧто он делает
spartoo_list_ordersСписок заказов, размещенных с определенной даты, опционально только тех, что в одном статусе. Для каждого заказа под root.orders.order: orders_id, customers…
spartoo_get_orderСчитывает один заказ по его id: детали клиента и доставки (или пункт выдачи в relay_info), способ оплаты, имя и цена доставки, заказ…
spartoo_accept_orderПринимает новый заказ: переводит его из статуса 11 (подтвержден) в 2 (в подготовке). После этого имя заказа, адрес доставки и перевозчик могут…
spartoo_ship_orderОтмечает принятый заказ как отправленный с номером отслеживания перевозчика: переводит его из статуса 2 в 3, и Spartoo отправляет ссылку для отслеживания…
spartoo_cancel_orderОтменяет заказ, который не был отправлен (статус 41). Клиент не получает заказ и ему возвращаются деньги от Spartoo; это нельзя отменить…
spartoo_list_returnsСписок возвратов, зарегистрированных с определенного момента, опционально только тех, что в одном статусе. Для каждого возврата под root.returns.return: return_id…
spartoo_get_returnСчитывает возвраты одного заказа или один возврат по его id: id возврата и дата, статус id и имя, причина, id заказа и возвращенный продукт…
spartoo_check_product_statusПроверяет, есть ли один из твоих продуктов на сайте Spartoo. Возвращает под root.products.product твою ссылку, статус (OK на сайте…
spartoo_update_stockУстанавливает запас одного размера одного продукта в реальном времени. Запас 0 убирает этот размер с сайта; продукт, размеры которого все 0, уходит в оффлайн.…

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

  • "Какие заказы Spartoo пришли с понедельника и еще не были приняты?"
  • "Прими заказ 90D813EA1A2365A8 и отправь его с отслеживанием Royal Mail AB123456789GB."
  • "Какие возвраты ожидают получения?"
  • "Мой продукт REF-BOOT-221 в сети, и если нет, то почему?"
  • "Установи запас размера 38 для REF-BOOT-221 на 6."

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

Откуда берется код партнера? В административной панели рынка Spartoo, Документация, Веб-сервисы, любая страница сервиса: строка partner показывает твой код, а строка Webservice URL указывает адрес твоего сайта. Если код не отображается, спроси своего контактного лица на рынке Spartoo.

Что охватывает, а что нет? Заказы с деталями клиентов и доставки, прием и отправка с номером отслеживания, возвраты, статус продукта и запасы по размеру. Он не принимает и не отказывает в возвратах. Чтобы искать в каталоге Spartoo как покупатель, используй коннектор Spartoo Shop.

Какие инструменты установлены выключенными? spartoo_cancel_order, потому что отмена возвращает деньги клиенту и не может быть отменена. Включи его на странице коннектора только если ИИ должен его использовать.

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

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

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

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

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

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

Коннекторы

Подключить Spartoo Marketplace MCP к ChatGPT

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

Коннекторы

Подключить Spartoo Marketplace MCP к Claude

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

Коннекторы

Spartoo Marketplace MCP с Microsoft Copilot

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

Коннекторы

Подключить Spartoo Marketplace MCP к Cursor

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

Коннекторы

Spartoo Marketplace MCP с Meta Muse

Веб-сервисы рынка Spartoo для продавцов: заказы с деталями клиентов и доставки, прием и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML-ответы читаются как JSON.

Коннекторы

Spartoo Marketplace MCP-сервер: заказы и остатки

Веб-сервисы Spartoo marketplace для продавцов: заказы с деталями клиента и доставки, принятие и отправка заказов с номером отслеживания, возвраты, статус продукта на сайте и обновления запасов по размеру. Код партнера в качестве поля формы, XML ответы читаются как JSON.