xiaohongshu-mcp
Self-hosted MCP-сервер для xiaohongshu: публикация заметок и видео, поиск, лента, комментарии, лайки и избранное от лица агента
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Публикует контент и совершает действия от лица реального аккаунта в социальной сети
- Неофициальная автоматизация через браузер с сохраненными cookie, есть риск ограничений или блокировки аккаунта
Установка
Ручная установка
wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml
docker compose up -dЗапуск через Docker Compose, монтирует data и images и открывает порт 18060. Перед публикацией нужно один раз выполнить вход. Также есть готовые бинарники из GitHub Releases и сборка из исходников на Go.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
xiaohongshu-mcp это локальный MCP-сервер, который дает агенту доступ к аккаунту xiaohongshu через управляемый браузер. После разового ручного входа он публикует заметки с изображениями и видео с заголовком, текстом и тегами, ищет контент по ключевым словам, читает ленту рекомендаций, получает детали поста со статистикой и комментариями, открывает профили пользователей, оставляет и отвечает на комментарии, ставит и снимает лайки и добавляет в избранное. Сервер работает локально и поднимает HTTP-эндпоинт MCP, к которому подключаются Claude Code, OpenCode и другие MCP-клиенты. Распространяется готовыми бинарниками, образом Docker или сборкой из исходников на Go. Интерфейс и документация проекта на китайском.
Для кого. Для SMM-специалистов и авторов, которые ведут аккаунт xiaohongshu и хотят автоматизировать публикации и вовлечение через агента.
Подходит, если
- Нужно публиковать заметки и видео в xiaohongshu из агента
- Нужно искать контент, читать ленту и открывать детали постов с комментариями
- Нужно автоматизировать лайки, избранное и ответы на комментарии
Не подходит, если
- Нет аккаунта xiaohongshu или нельзя пройти ручной вход
- Нужен официальный API площадки с гарантиями, а не неофициальная автоматизация через браузер
Пример запроса к агенту
Опубликуй заметку в xiaohongshu с заголовком и тремя фото из папки и добавь тегиОграничения
Это неофициальная автоматизация через управляемый браузер, а не официальный API, применяются правила площадки и защита от спама, риск на стороне аккаунта. Нужен разовый ручной вход, cookie может истечь и потребовать повторного входа. Один и тот же аккаунт нельзя параллельно держать в других веб-сессиях, иначе сессию MCP выбьет. При первом запуске скачивается браузер без интерфейса, около 150 MB. Готовые бинарники есть только для macOS Apple Silicon, Windows x64 и Linux x64, для macOS Intel и Linux ARM64 нужна сборка из исходников или Docker. Многим действиям на чтение требуются id поста и xsec_token, которые берутся из ленты или поиска. Интерфейс и документация на китайском.
Как отключить. Остановите сервер (docker compose stop или завершение процесса) и удалите его из MCP-клиента, например claude mcp remove xiaohongshu-mcp.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| AUTH_TOKEN секрет | Опциональный токен для защиты MCP-эндпоинта, по умолчанию выключен. При включении клиенты передают заголовок Authorization: Bearer. |
| XHS_PROXY | Опциональный прокси для исходящего доступа, поддерживает HTTP, HTTPS и SOCKS5. |
Проверка безопасности
- Публикует контент и совершает действия от лица реального аккаунта в социальной сети
- Неофициальная автоматизация через браузер с сохраненными cookie, есть риск ограничений или блокировки аккаунта
Коротко о README
README на китайском описывает MCP-сервер для xiaohongshu, который дает агенту доступ к данным аккаунта. Перечислены возможности: вход и проверка статуса, публикация заметок и видео, поиск, лента рекомендаций, детали поста с комментариями, профили, комментарии и ответы, лайки и избранное. Установка идет тремя путями: готовые бинарники из GitHub Releases, сборка из исходников на Go и Docker с docker compose, сервис слушает порт 18060 по пути /mcp. Отдельно описаны прокси через XHS_PROXY, опциональная защита через AUTH_TOKEN и подключение клиентов Claude Code и OpenCode. Есть заметки об эксплуатации и рисках аккаунта. Лицензия Apache 2.0.
Частые вопросы
Это официальный API?
Нет, это неофициальная автоматизация через управляемый браузер, соблюдайте правила площадки, риск ограничений на стороне аккаунта.
Нужен ли токен доступа?
По умолчанию рекомендуется вход через ручную авторизацию, а доступ к серверу опционально защищается переменной AUTH_TOKEN, тогда клиенты передают заголовок Authorization: Bearer.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
MCP-сервер SendPulse
SendPulse MCP
Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно