xiaohongshu-cli
Консольная утилита xhs для Xiaohongshu с готовым скиллом: агент ищет заметки, читает комментарии и публикует от аккаунта.
- 2 722 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Утилита читает cookie из установленных браузеров и держит сессию аккаунта в `~/.xiaohongshu-cli/cookies.json`.
- Команды публикуют, комментируют, подписывают и удаляют от имени аккаунта через неофициальный API, и площадка вправе ограничить такой аккаунт.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/xiaohongshu-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Утилита читает cookie из установленных браузеров и держит сессию аккаунта в `~/.xiaohongshu-cli/cookies.json`.
- Команды публикуют, комментируют, подписывают и удаляют от имени аккаунта через неофициальный API, и площадка вправе ограничить такой аккаунт.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
xiaohongshu-cli — Python-утилита с командой `xhs` для соцсети Xiaohongshu (小红书). Она ищет заметки и пользователей, открывает заметку с комментариями и ответами, показывает ленту рекомендаций и горячие заметки по категориям. Работает через неофициальный API, подписи запросов подобраны по веб-клиенту. Команды разделены на чтение, социальные действия и работу автора: лайк, избранное, комментарий, ответ, подписка, публикация заметки с картинками и удаление. После любой выдачи действует сокращенная нумерация: `xhs read 1` открывает первый результат. Вывод идет в YAML или JSON с единым конвертом, поэтому его удобно разбирать агенту. В репозитории лежит `SKILL.md`, который объясняет агенту порядок входа и команды.
Для кого. Маркетологам и контент-менеджерам, которые изучают Xiaohongshu и ведут там аккаунт, а также разработчикам, собирающим агента для этой площадки.
Подходит, если
- По ключевому слову надо собрать популярные заметки площадки и прочитать комментарии под ними.
- Агент следит за новыми лайками, упоминаниями и подписчиками через команду уведомлений.
- Заметку с картинками публикуют из консоли или по расписанию от своего аккаунта.
- Результаты поиска передаются дальше как YAML или JSON в другие скрипты и агенты.
Не подходит, если
- Нужен официальный и стабильный доступ к данным: утилита опирается на подписи запросов, подобранные по веб-клиенту, и ломается при изменении API.
- Аккаунт Xiaohongshu рабочий и его нельзя подвергать ограничениям площадки за автоматические действия.
- Важна лицензия на код: в репозитории файла лицензии нет.
Пример запроса к агенту
Найди десять популярных заметок по запросу «旅行», открой комментарии у первой и покажи итог в YAML.Ограничения
Утилита ходит в закрытый API Xiaohongshu с подписями, подобранными по веб-клиенту, поэтому его изменение ломает команды; автор советует регулярно обновляться. Для входа нужны cookie из браузера или вход по QR-коду в сопровождении браузера. Сохраненные cookie живут семь дней и лежат в `~/.xiaohongshu-cli/cookies.json`. Площадка может показать капчу или заблокировать IP при частых запросах, пауза между запросами около секунды заложена в код. Нужен Python 3.10 или новее. Последний коммит в репозитории сделан в марте 2026 года.
Как отключить. Удалите утилиту командой `uv tool uninstall xiaohongshu-cli` или `pipx uninstall xiaohongshu-cli` и папку `~/.xiaohongshu-cli` с cookie. Скилл уберите из каталога скиллов агента.
Частые вопросы
Как установить xiaohongshu-cli?
Выполните `uv tool install xiaohongshu-cli` или `pipx install xiaohongshu-cli`. Обновляйте утилиту командой `uv tool upgrade xiaohongshu-cli`, иначе устаревшая обработка API даст ошибки.
Как войти в аккаунт Xiaohongshu?
Войдите на сайте в браузере и запустите `xhs login`: утилита найдет cookie в установленных браузерах. Без браузерных cookie выручит `xhs login --qrcode`, QR-код покажет терминал.
Как подключить скилл к Claude Code?
Выполните `npx skills add jackwener/xiaohongshu-cli`. Флаг `-a claude-code` выбирает агента, `-g` ставит скилл для всех проектов. Ручной вариант: клонировать репозиторий в `.agents/skills/xiaohongshu-cli`.
Что делает команда `xhs read 1`?
Она открывает первую заметку из последней выдачи, будь то поиск, лента или список заметок пользователя. Тот же индекс принимают `xhs comments`, `xhs like` и `xhs favorite`.
В каком формате утилита отдает данные?
Ключи `--yaml` и `--json` включают структурированный вывод с полями `ok`, `schema_version` и `data`. Если вывод идет не в терминал, по умолчанию выбирается YAML.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл для OpenClaw: ведет аккаунт в Xiaohongshu через встроенный браузер, от анализа ленты и идей до заметок, ответов на комментарии и базы знаний
CLI для Xiaohongshu: поиск и разбор заметок, сравнение блогеров, ответы на комментарии и публикация от вашего аккаунта
15 скиллов для Codex: от исследования аккаунта в Xiaohongshu и выбора тем до заголовка, текста и проверки перед публикацией
Self-hosted MCP-сервер для xiaohongshu: публикация заметок и видео, поиск, лента, комментарии, лайки и избранное от лица агента
Скилл-визуальный директор для карточек Xiaohongshu: выбор стиля, структура листов, промпты для генерации и текст поста
Один скилл и CLI для «Планеты знаний»: поиск и публикация постов, ответы, метки и сценарии для владельцев закрытых групп.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| xiaohongshu-cli (эта карточка) | нет | 2 722 | ||
| redbook | нет | 537 | тоже консоль для Xiaohongshu с анализом блогеров; здесь упор на структурированный вывод, быструю нумерацию и вход по QR-коду | |
| xiaohongshu-mcp | нет | не нужна | 16 967 | MCP-сервер на вашем сервере для публикации и ленты; здесь обычные команды в терминале и скилл |
Коротко о README
Функции сгруппированы по задачам; отдельно расписаны способы входа и срок жизни cookie, переменные окружения и работа с лимитами площадки. Отдельный раздел объясняет установку скилла и лежит рядом со схемой вывода `SCHEMA.md`.
Бейдж для README
Исходный SKILL.md
--- name: xiaohongshu-cli description: Use xiaohongshu-cli for ALL Xiaohongshu (Little Red Book, 小红书) operations — searching notes, reading content, browsing users, liking, collecting, commenting, following, and posting. Invoke whenever the user requests any Xiaohongshu interaction. author: jackwener version: "0.6.4" tags: - xiaohongshu - xhs - redbook - 小红书 - social-media - cli --- # xiaohongshu-cli — Xiaohongshu CLI Tool **Binary:** `xhs` **Credentials:** browser cookies (auto-extracted) or browser-assisted QR login (`--qrcode`) ## Setup ```bash # Install (requires Python 3.10+) uv tool install xiaohongshu-cli # Or: pipx install xiaohongshu-cli # Upgrade to latest (recommended to avoid API errors) uv tool upgrade xiaohongshu-cli # Or: pipx upgrade xiaohongshu-cli ``` ## Authentication **IMPORTANT FOR AGENTS**: Before executing ANY xhs command, check if credentials exist first. Do NOT assume cookies are configured. ### Step 0: Check if already authenticated ```bash xhs status --yaml >/dev/null && echo "AUTH_OK" || echo "AUTH_NEEDED" ``` If `AUTH_OK`, skip to [Command Reference](#command-reference). If `AUTH_NEEDED`, proceed to Step 1. Prefer `--qrcode` when browser cookie extraction is unavailable but launching a browser is acceptable. ### Step 1: Guide user to authenticate