B&Q Marketplace MCP-сервер: заказы и доставка

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

B&Q Marketplace

Управляй своим магазином на маркетплейсе B&Q с помощью AI агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает в Великобритании; войди с помощью API ключа магазина из своего административного кабинета продавца B&Q.

Настройка

Страны: Великобритания.

Кто может продавать: B&Q принимает заявки через Kingfisher Merchant Hub; бизнес должен быть зарегистрирован для уплаты НДС. Коннектор требует учетную запись продавца, которую B&Q уже открыл.

B&Q принадлежит Kingfisher, поэтому платформа продавца находится по адресу Kingfisher.

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

1. Войди в административный кабинет продавца B&Q: https://marketplace.kingfisher.com/login.
2. В административном кабинете открой свое имя пользователя (в правом верхнем углу) > Мои настройки пользователя > API ключ и нажми Сгенерировать новый ключ (или скопируй существующий ключ). Вставь его в B_AND_Q_API_KEY. Ключ отправляется как есть в заголовке Authorization, без Bearer. Генерация нового ключа делает старый недействительным, поэтому любое другое средство, использующее его, перестает работать.
3. Продавцы на B&Q известны тем, что устанавливают идентификатор магазина, также с одним магазином. Если у твоего пользователя более одного магазина, установи B_AND_Q_SHOP_ID на числовой идентификатор магазина, с которым должен работать этот коннектор (показан на панели управления административного кабинета рядом с Идентификатором или ID магазина, и возвращается как shop_id с помощью b_and_q_get_account); чтобы работать с несколькими магазинами, установи коннектор один раз для каждого магазина. Без него используется твой магазин по умолчанию.
4. Установи и запусти b_and_q_get_account: он возвращает магазин, к которому принадлежит ключ.

С чего начать: b_and_q_get_account показывает магазин, стоящий за ключом (идентификатор, имя, состояние, валюта и каналы). Для повседневной работы используй b_and_q_list_orders с order_state_codes=WAITING_ACCEPTANCE, b_and_q_list_offers для цен и наличия и b_and_q_list_threads для сообщений, ожидающих ответа.

Продукты и конкурирующие предложения: b_and_q_get_products ищет продукты в каталоге B&Q по EAN или другой ссылке и возвращает SKU продукта на маркетплейсе; b_and_q_list_product_offers перечисляет предложения каждого магазина для заданных продуктов, сначала лучшее предложение, примерно 5 вызовов в минуту.

Рабочий процесс заказов: новый заказ ожидает в WAITING_ACCEPTANCE. b_and_q_accept_order принимает (или отказывает) каждую строку; после списания средств с клиента заказ переходит в SHIPPING. Затем b_and_q_update_tracking сохраняет перевозчика и номер отслеживания (коды перевозчиков берутся из b_and_q_list_carriers), а b_and_q_ship_order подтверждает отправку (SHIPPED). Поздние состояния: TO_COLLECT, RECEIVED, CLOSED, REFUSED и CANCELED. Используй b_and_q_list_orders с order_state_codes=WAITING_ACCEPTANCE для повседневного списка задач и has_incident=true для открытых инцидентов; b_and_q_resolve_incident закрывает инцидент по одной строке заказа, как только он решен. Документы, прикрепленные к заказам (накладные, ярлыки, счета клиентов), перечисляются с помощью b_and_q_list_order_documents.

Записи: сначала подтверждай. b_and_q_accept_order, b_and_q_update_tracking, b_and_q_ship_order, b_and_q_resolve_incident, b_and_q_accept_return, b_and_q_receive_return, b_and_q_update_offers, b_and_q_reply_thread, b_and_q_create_order_thread и b_and_q_import_products действуют на живом маркетплейсе. Перед каждым вызовом покажи пользователю, что изменится (идентификатор заказа и строки, номер отслеживания, SKU предложения с старой и новой ценой или наличием, текст сообщения и получатели) и жди подтверждения. Отказ от строки заказа отменяет ее навсегда. Никакой инструмент здесь не возвращает деньги, не отменяет заказы и не перемещает деньги; делай это в административном кабинете. b_and_q_import_offers может удалять предложения (режим REPLACE удаляет каждое предложение, отсутствующее в файле), поэтому он установлен в выключенном состоянии.

Обновление предложений (цен и наличия): b_and_q_update_offers (OF24) заменяет все предложение. Каждое поле, которое ты оставляешь пустым, сбрасывается: отсутствующее quantity становится 0, отсутствующая discount или description удаляется. Всегда сначала читай предложение (b_and_q_get_offer или b_and_q_list_offers с sku) и отправляй его обратно полностью с только предполагаемым изменением: shop_sku, product_id и product_id_type (из product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (его код), min_quantity_alert, description, discount, all_prices, available_started / available_ended (читай как available_start_date / available_end_date) и любые offer_additional_fields. Оставь update_delete пустым или update. Вызов возвращает import_id; изменение применяется асинхронно, поэтому проверь его с помощью b_and_q_get_offer_import перед повторным чтением предложения. Код состояния для state_code берется из b_and_q_list_offer_conditions, коды логистического класса из b_and_q_list_logistic_classes.

Импорт файлов: b_and_q_import_products (P41) и b_and_q_import_offers (OF01) принимают URL CSV, XLSX или XML файла в формате, запрашиваемом B&Q; коннектор загружает его и загружает в B&Q. Отслеживай их с помощью b_and_q_list_product_imports / b_and_q_get_product_import и b_and_q_list_offer_imports / b_and_q_get_offer_import.

Возвраты: b_and_q_list_returns (RT11) перечисляет запросы на возврат. Где B&Q позволяет магазину решать, b_and_q_accept_return принимает или отказывает один в WAITING_ACCEPTANCE, а b_and_q_receive_return подтверждает, что товары прибыли. Возвраты остаются в административном кабинете.

Сообщения: b_and_q_list_threads перечисляет разговоры (фильтруй с entity_type=MMP_ORDER и entity_id=<order id> для одного заказа; entity_id без entity_type отклоняется), b_and_q_get_thread читает один с его сообщениями, b_and_q_reply_thread отвечает (получатель CUSTOMER или OPERATOR, который является B&Q) и b_and_q_create_order_thread открывает новый разговор по заказу. Код причин для тем берется из b_and_q_list_reasons; оставь его locale пустым, если не знаешь, что на маркетплейсе есть этот язык (неактивная локаль отвечает 400).

Деньги: b_and_q_list_invoices (IV01) перечисляет бухгалтерские документы, которые B&Q выдает магазину, а b_and_q_list_transactions (TL02) — строки транзакций (продажи, комиссии, возвраты, выплаты). Если B&Q использует Упрощенное Выставление Счетов Продавцам, IV01 не возвращает новые документы; используй b_and_q_list_document_requests (DR11) и транзакции тогда.

Справочные списки: b_and_q_list_channels (страницы стран), b_and_q_list_carriers, b_and_q_list_shipping_zones, b_and_q_list_shipping_methods и b_and_q_list_logistic_classes меняются редко; читай их один раз за разговор.

Пагинация: заказы, предложения, счета и импорты продуктов разбиваются на страницы с помощью max (максимум 100) и offset. Темы, возвраты, транзакции, запросы документов и импорты предложений возвращают next_page_token; передай его как page_token, чтобы получить следующую страницу (все другие фильтры тогда игнорируются), пока он не исчезнет.

Даты — это ISO 8601, например, 2026-10-01T00:00:00Z; ответы в UTC.

Ограничения по скорости: У каждого API есть свои ограничения, и B&Q может их ужесточить. Перечисление предложений и заказов предназначено для интерактивного использования, импорты продуктов и предложений — не чаще чем раз в 15 минут, b_and_q_get_account и справочные списки примерно раз в день. Код 429 содержит заголовок Retry-After с количеством секунд для ожидания; не пытайся повторить в цикле.

Ошибки: 401 означает, что ключ неверный или был заменен на более новый, 403 — что у твоего пользователя нет прав на это действие, 404 — что заказ, предложение или тема не существуют для этого магазина, 400 — неверный параметр или заказ в неверном состоянии (сообщение указывает на это, например, ORDER_INVALID_STATE).

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

Установи коннектор локально

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

Открой http://localhost:3000/connectors/store, выбери B&Q Marketplace и вставь переменные окружения, указанные в предварительных требованиях.

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

Примеры запросов

• "Какие заказы B&Q ожидают принятия, и какова их общая стоимость в GBP?"
• "Установи наличие моего SKU катушки для шланга HR-30M на 40 на B&Q."
• "Отметь инцидент по строке 2 заказа 7012345-A как решенный; клиент получил недостающие винты."
• "Какие из моих предложений B&Q не активны, и какую причину указывает B&Q?"
• "Покажи счета, которые B&Q выставил мне в этом квартале, с их итогами по комиссиям."

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

• Подключиться к Claude
• Подключиться к ChatGPT