wbcli: CLI для Wildberries Seller API

wbcli

Консервативный CLI и скилл для официального Wildberries Seller API: токен, ping, seller-info и сырые запросы только на чтение

  • 0 ★ репозитория
  • Последний коммит
  • MIT
CLI

Широкий доступ

Почему такой уровень

  • Команда raw отправляет в API Wildberries запрос с любым HTTP-методом и телом по токену продавца
  • Через нее можно менять цены, карточки и заказы, отдельного флага для записи пока нет
Все причины и проверки
Российский стек

dapi/wbcli

Установка

Работает в
Сервисы

Ручная установка

npm install -g github:dapi/wbcli

Установка CLI прямо из GitHub, пакет пока не публикуется в npm registry.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Команда raw отправляет в API Wildberries запрос с любым HTTP-методом и телом по токену продавца
  • Через нее можно менять цены, карточки и заказы, отдельного флага для записи пока нет

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

wbcli это небольшой CLI на Node.js и TypeScript поверх официального REST API Wildberries без сторонних SDK. Из готовых команд безопасны token:decode (локально разбирает JWT токена), ping (проверяет соединение) и seller-info (данные продавца). Команда raw отправляет в API любой запрос с любым методом и телом, так что через нее можно и писать. Команды умеют показывать заголовки лимита запросов X-Ratelimit и по флагу ждать и повторить запрос при ошибке 429. Токен читается из переменной WB_TOKEN или .env и никогда не логируется. Отдельные команды записи автор планирует позже, под флагом --write; пока флага нет, запись возможна только через raw. В комплекте есть SKILL.md с правилами безопасного использования для агентов.

Для кого. Для разработчиков, которым нужен легкий CLI для диагностики доступа к Wildberries Seller API без стороннего SDK.

Подходит, если

  • Нужно быстро проверить токен и права доступа к WB API
  • Нужен сырой запрос к произвольному эндпоинту WB для отладки
  • Нужно видеть заголовки лимита запросов и не упереться в 429 вслепую

Не подходит, если

  • Нужен широкий охват операций записи: в первой версии их нет
  • Нужен готовый npm-пакет из реестра, а не установка прямо из GitHub

Пример запроса к агенту

Проверь мой токен Wildberries командой wbcli ping и покажи оставшийся лимит запросов

Ограничения

Проект в раннем состоянии, README описывает его как MVP с намеренно ограниченным набором команд. Отдельных команд записи нет, но raw принимает любой HTTP-метод и тело, а флага защиты для записи пока нет. Пакет не опубликован в npm registry, установка идет прямо из GitHub. Нужен токен продавца из личного кабинета WB.

Как отключить. Удалите глобальный пакет командой npm uninstall -g wbcli или сотрите локальную копию.

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

Может ли wbcli изменить данные в кабинете WB?

Нет, в текущей версии только чтение и сырые GET-запросы, команды записи по плану появятся позже за отдельным флагом.

Откуда брать токен?

Только официальный токен Wildberries Seller API из личного кабинета продавца, скилл прямо запрещает парсинг закрытых страниц кабинета и переиспользование сессии браузера.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Agent Skill и CLI без зависимостей поверх API Wildberries: товары, заказы, отзывы, аналитика, несколько магазинов

СкиллШирокий доступ
Российский стек

Скилл для официального Wildberries Seller API с локальными OpenAPI-схемами на 286 операций и защищенным помощником api_call

СкиллШирокий доступ
Российский стек

MCP-сервер Seller API Wildberries: карточки, цены, акции, реклама, заказы, поставки, отзывы и финансы для нескольких кабинетов

MCP-серверШирокий доступ8Звезды репозитория
Российский стек

Agent Skill с полной картой API Wildberries: 12 модулей и 261 метод, справочные файлы и скрипт для вызовов

СкиллРасширенный доступ

Скилл Wildberries Seller API

Wildberries Seller API - Agent Skill

Российский стек

Скилл-справочник по Wildberries Seller API на локальных Swagger-файлах с поиском на русском и английском

СкиллРасширенный доступ7Звезды репозитория

Коротко о README

README объясняет выбор стека Node.js и TypeScript, список команд MVP и план дальнейших read-only эндпоинтов и команд записи за флагом --write, установку через npm install -g github:dapi/wbcli или npx, работу с заголовками лимита запросов и официальную модель доступа только по токену продавца без парсинга закрытых страниц кабинета.

Бейдж для README

Исходный SKILL.md

---
name: wbcli
description: "Use when working with the official Wildberries Seller API through the wbcli command-line tool: checking token scopes, testing connectivity, reading seller info, exploring read-only WB endpoints, planning data exports for Google Sheets, or debugging WB API access. This skill is for authorized seller API access only; do not use it for scraping private cabinet endpoints, bypassing permissions, or handling tokens insecurely."
---

# wbcli

Use wbcli for authorized, token-based access to the official Wildberries Seller API.

## Safety Rules

- Use only official WB Seller API tokens created in the seller cabinet.
- Never print, commit, paste, or send the token to online JWT decoders.
- Prefer read-only tokens for analytics work.
- Do not scrape private cabinet endpoints or reuse browser sessions.
- Store the token in WB_TOKEN or .env; keep .env out of git.

Сообщить о проблеме