1688 Shopkeeper — скилл
1688-shopkeeper
Официальный скилл 1688 для OpenClaw: поиск поставщиков, детали товара, выгрузка на Douyin, Pinduoduo, Xiaohongshu и Taobao, тренды и дневной отчет
- 1 676 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Команда publish выгружает товары в привязанные магазины и после пробного запуска делает это без повторного вопроса
- Ключ AK открывает аккаунт 1688 и сохраняется в файле openclaw.json в открытом виде
- Скилл ходит на ainext.1688.com и пишет файлы с результатами в рабочий каталог OpenClaw
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/1688-shopkeeperОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команда publish выгружает товары в привязанные магазины и после пробного запуска делает это без повторного вопроса
- Ключ AK открывает аккаунт 1688 и сохраняется в файле openclaw.json в открытом виде
- Скилл ходит на ainext.1688.com и пишет файлы с результатами в рабочий каталог OpenClaw
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
1688 Shopkeeper — скилл китайской оптовой площадки 1688, который превращает агента в помощника продавца: он ищет товары у поставщиков, показывает карточки и выгружает выбранное в магазины на Douyin, Pinduoduo, Xiaohongshu и Taobao. Всю работу выполняет `cli.py`, который вызывает API `ainext.1688.com`, подписывая запросы ключом доступа (AK) из приложения 1688 AI. Команда `search` принимает запрос обычной фразой и возвращает до 20 товаров: цену, продажи за 30 дни, долю хороших отзывов, повторные покупки и число выгрузок. `prod_detail` показывает заголовок, категорию, SKU, атрибуты и продавца по идентификаторам. `shops` перечисляет привязанные магазины, `publish` выгружает выбранные товары в магазин, до 20 за раз. Сначала агент выполняет пробный запуск `--dry-run`, и если магазин и товары определены однозначно, сразу выгружает без второго вопроса пользователю. Команды `opportunities`, `trend` и `shop_daily` читают список горячих ниш, динамику категории с распределением цен и дневной отчет магазина с подсказками по выбору товаров. В папке references лежат справочники по каждой команде и ответы на вопросы продавцов о ценах, доставке, возвратах, новых магазинах и проверке контента.
Для кого. Для продавцов, которые закупают товары у поставщиков 1688 и торгуют на Douyin, Pinduoduo, Xiaohongshu или Taobao, и для тех, кто собирается открыть там магазин.
Подходит, если
- Нужно найти поставщика летних платьев с доставкой от одной штуки и ценой до 100 юаней
- Выбранные товары надо выгрузить сразу в привязанные магазины на Douyin и Pinduoduo
- Требуется узнать, какие ниши сейчас в тренде и как распределены цены в категории
- Каждое утро нужен дневной отчет магазина с продажами по каналам и подсказками по выбору товаров
- Новичку нужны ответы о ценах, доставке и возвратах по справочникам площадки
Не подходит, если
- Нет доступа к приложению 1688 AI, из которого берется ключ AK: без него команды не работают
- Магазин стоит вне Douyin, Pinduoduo, Xiaohongshu и Taobao: других каналов скилл не знает
- Не установлен Python 3: весь код скилла запускается через него
- Нужно загрузить товар с 1688 на Ozon: для этого в каталоге есть скилл переноса на Ozon
Пример запроса к агенту
Найди на 1688 складные стулья для кемпинга дешевле 100 юаней с доставкой от одной штуки, под Douyin, и покажи топ по продажамОграничения
Автор не указал лицензию, права на использование и копирование не определены, уточните у автора.
Интерфейс, справочники и ответы площадки на китайском языке, а сам скилл рассчитан на OpenClaw: в параметрах заголовка указаны эта среда и переменная `ALI_1688_AK`. Работа в других агентах в репозитории не описана.
Ключ выдает приложение 1688 AI: в нем нужно нажать кнопку на главной, открыть страницу и скопировать ключ. Магазины для выгрузки привязывают в том же приложении, а при истекшей авторизации ее нужно обновить там же.
В одну выгрузку попадает не больше 20 товаров, поиск возвращает до 20 результатов. Автор пишет, что выбор товаров и выгрузка сейчас бесплатны на ограниченное время, а стоимость определяют правила 1688.
Скилл сохраняет результаты поиска, деталей и выгрузок в папке `1688-skill-data` рабочего каталога OpenClaw.
Как отключить. Удалите папку 1688-shopkeeper из каталога скиллов OpenClaw. Ключ остается в `openclaw.json` в записи этого скилла: удалите его оттуда, либо отзовите ключ в приложении 1688 AI. Сохраненные данные лежат в папке `1688-skill-data` рабочего каталога.
Частые вопросы
Что такое AK и откуда его взять?
AK (Access Key) — ключ доступа к платформе 1688. Приложение 1688 AI выдает его на странице, которую открывает кнопка на главном экране. После этого пользователь сообщает агенту фразу вроде «мой AK такой-то», либо вы запускаете `python3 cli.py configure YOUR_AK`.
Что изменится в OpenClaw после настройки ключа?
Команда `configure` записывает ключ в файл `openclaw.json`, в запись скилла, а при работе скилл берет его из переменной `ALI_1688_AK` или из этого файла, если шлюз OpenClaw не перезапускали.
Какие каналы выгрузки поддерживает скилл?
Douyin, Pinduoduo, Xiaohongshu и Taobao. Внутри API Taobao называется thyny, а китайские названия каналов в ответах площадки скилл сопоставляет с английскими кодами.
Как проходит выгрузка товаров?
Агент берет номер магазина из `shops`, запускает `publish` сначала с `--dry-run`, затем без него. Передавать можно либо идентификатор выборки `--data-id` и сразу весь поиск, либо `--item-ids` с перечнем нужных товаров, но не оба параметра вместе.
Что делать, если ответ пришел с ограничением частоты запросов?
Скилл подсказывает подождать одну-две минуты и повторить. При пустом результате на длинный или узкий запрос по тренду он предлагает взять более общее слово или разбить запрос.
Какие вопросы продавца есть в справочниках?
Выбор платформы, подводные камни при выборе товара, шаблон выгрузки с ценой и доставкой, сроки отправки, возвраты и страховку на обратную доставку, запуск нового магазина, проверка контента с белым фоном изображений и заголовками.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Скиллыgoofish-cli — CLI и MCP для Xianyu (Goofish)
goofish-cli
CLI и MCP-сервер для китайской площадки Xianyu: публикация товаров, диалоги и поиск через команды и пять навыков
Тринадцать скиллов делают агента OpenClaw исполнителем платных заказов, а Guard ограничивает его расходы и зацикливание
Официальный скилл покупок Filtmall: живые товары, доказательства цены на тот же товар, оформление заказа, доставка и постпродажа
Яндекс Умный дом для OpenClaw
Yandex Smart Home CLI for OpenClaw
Python CLI и скилл для OpenClaw, которые включают лампы и розетки Яндекс Умного дома, меняют яркость, температуру и цвет
Локальный MCP-сервер для поиска товаров, корзины и доставки из «Пятерочки»
Скилл раздела Инструменты Яндекс Директа
ya-direct-tools
Agent Skill для раздела Инструменты Яндекс Директа: прогноз бюджета, Вордстат, история изменений, доступ к API и Директ Коммандер
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| 1688 Shopkeeper (эта запись) | да | 1 676 | |
| Перенос товара с 1688 на Ozon | нет | 3 | переводит карточку товара с 1688 в JSON для Ozon Seller API и проверяет статус загрузки |
| goofish-cli — CLI и MCP для Xianyu (Goofish) | нет | 382 | CLI и MCP-сервер для китайской площадки Xianyu |
Коротко о README
Описание проекта на китайском начинается со списка возможностей: подбор товаров, детали по идентификатору, выгрузка в магазины, статус привязанных магазинов, горячие ниши, тренды и дневной отчет. Дальше идут установка одной фразой в диалоге OpenClaw, четыре шага получения ключа в приложении 1688 AI, примеры обращений и таблица девяти команд командной строки с вызовами. В конце таблица поддерживаемых платформ, вопросы об устройстве ключа, платности и типах магазинов, а также контакт службы поддержки в приложении.
Бейдж для README
Исходный SKILL.md
---
name: 1688-shopkeeper
description: |
1688选品铺货 + 商机趋势专家。用于：(1) 在1688搜索商品/选品找货源 (2) 查询已绑定的下游店铺
(3) 将商品铺货到抖音/拼多多/小红书/淘宝等平台 (4) 配置1688 AK密钥 (5) 查看即时商机热榜
(6) 查看类目/行业趋势与价格分布 (7) 生成店铺经营日报并输出主营商品选品建议。
触发词：帮我找商品、在1688搜、选品、铺货、上架、查店铺、配置AK、商机、热榜、排行榜、趋势、价格分布、经营日报、店铺日报、动销分析、经营分析、选品建议、1688找货。
metadata: {"openclaw": {"emoji": "🛒", "requires": {"bins": ["python3"]}, "primaryEnv": "ALI_1688_AK"}}
---
# 1688-shopkeeper
统一入口：`python3 {baseDir}/cli.py <command> [options]`
## 命令速查
| 命令 | 说明 | 示例 |
|------|------|------|
| `search` | 找商品 | `cli.py search --query "帮我找1688上支持一件代发包邮的露营椅，100元以内" --channel douyin` |
| `prod_detail` | 商品详情 | `cli.py prod_detail --item-ids "991122553819,894138137003"` |
| `shops` | 查绑定店铺 | `cli.py shops` |
| `publish` | 铺货 | `cli.py publish --shop-code CODE --data-id ID` |
| `opportunities` | 商机热榜 | `cli.py opportunities` |
| `trend` | 趋势洞察 | `cli.py trend --query "大码女装"` |
| `shop_daily` | 店铺经营日报 | `cli.py shop_daily` |
| `configure` | 配置 AK | `cli.py configure YOUR_AK` |
| `check` | 检查配置状态 | `cli.py check` |
所有命令输出 JSON：`{"success": bool, "markdown": str, "data": {...}}`
**展示时直接输出 `markdown` 字段，Agent 分析追加在后面，不得混入其中。**
## 使用流程
Agent 根据用户意图**直接执行对应命令**，无需每次先执行 `check`。
各命令在 AK 缺失、店铺异常等情况下会自行返回明确错误，Agent 按下方「异常处理」应对即可。
**选品铺货典型路径**：`search` → 用户筛选 → `shops`（确认目标店铺） → `publish`
**商品详情使用指引**：
- `prod_detail`：用户想看商品标题、价格、类目、SKU、CPV 属性、商家信息时使用。
**商机/趋势使用指引**：
- `opportunities`：用户想看“此刻/近1小时/热榜/趋势商机”。
- `trend`：用户询问某宽泛类目/行业的周期趋势、价格分布、热品概况；关键词过长或过细时先按用户原词尝试，若空结果再提示用户换更宽泛/拆分词后重试。
- `shop_daily`：用户想看“店铺经营日报/今日动销/渠道经营诊断/主营商品选品建议”。