B&Q Marketplace MCP с Gemini CLI

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

B&Q Marketplace + Gemini

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

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

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

B_AND_Q_API_KEY

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

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

Кто может продавать: 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).

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

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

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

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

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

Где я могу получить API-ключ B&Q? В кабинете продавца B&Q: твое имя пользователя (в правом верхнем углу), Мои настройки пользователя, API-ключ, затем Создать новый ключ (или скопировать существующий ключ). Создание нового ключа делает старый недействительным. Продавцы на B&Q известны тем, что устанавливают идентификатор магазина, также с одним магазином. Если магазинов больше одного, установи B_AND_Q_SHOP_ID на магазин, с которым должен работать этот коннектор.

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

Может ли он отменять заказы, возвращать деньги или удалять предложения? Никакой инструмент не возвращает деньги или не отменяет заказ; делай это в кабинете B&Q. Отказ от строки при принятии заказа отменяет ее навсегда, поэтому AI показывает тебе каждую запись и ждет подтверждения. b_and_q_import_offers устанавливается выключенным, потому что его режим REPLACE удаляет каждое предложение, отсутствующее в файле; включай его на странице коннектора только если AI должен его использовать.

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

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

• Страница коннектора
• Подключение к Claude