xiaohongshu-mcp
Self-hosted MCP-сервер для xiaohongshu: публикация заметок и видео, поиск, лента, комментарии, лайки и избранное от лица агента
- 17 104 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Публикует контент и совершает действия от лица реального аккаунта в социальной сети
- Неофициальная автоматизация через браузер с сохраненными 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.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Публикует контент и совершает действия от лица реального аккаунта в социальной сети
- Неофициальная автоматизация через браузер с сохраненными cookie, есть риск ограничений или блокировки аккаунта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
xiaohongshu-mcp это локальный MCP-сервер, который дает агенту доступ к аккаунту xiaohongshu через управляемый браузер. После разового ручного входа он публикует заметки с изображениями и видео с заголовком, текстом и тегами, ищет контент по ключевым словам, читает ленту рекомендаций, получает детали поста со статистикой и комментариями, открывает профили пользователей, оставляет и отвечает на комментарии, ставит и снимает лайки и добавляет в избранное. Сервер работает локально и поднимает HTTP-эндпоинт MCP, к которому подключаются Claude Code, OpenCode и другие MCP-клиенты. Распространяется готовыми бинарниками, образом Docker или сборкой из исходников на Go. Интерфейс и документация проекта на китайском.
Для кого. Для SMM-специалистов и авторов, которые ведут аккаунт xiaohongshu и хотят автоматизировать публикации и вовлечение через агента.
Подходит, если
- Нужно публиковать заметки и видео в xiaohongshu из агента
- Нужно искать контент, читать ленту и открывать детали постов с комментариями
- Нужно автоматизировать лайки, избранное и ответы на комментарии
Не подходит, если
- Нет аккаунта xiaohongshu или нельзя пройти ручной вход
- Нужен официальный API площадки с гарантиями, а не неофициальная автоматизация через браузер
Пример запроса к агенту
Опубликуй заметку в xiaohongshu с заголовком и тремя фото из папки и добавь тегиMCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
AUTH_TOKENсекрет- Опциональный токен для защиты MCP-эндпоинта, по умолчанию выключен. При включении клиенты передают заголовок Authorization: Bearer.
XHS_PROXY- Опциональный прокси для исходящего доступа, поддерживает HTTP, HTTPS и SOCKS5.
Ограничения
Это неофициальная автоматизация через управляемый браузер, а не официальный 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.
Частые вопросы
Это официальный API?
Нет, это неофициальная автоматизация через управляемый браузер, соблюдайте правила площадки, риск ограничений на стороне аккаунта.
Нужен ли токен доступа?
По умолчанию рекомендуется вход через ручную авторизацию, а доступ к серверу опционально защищается переменной AUTH_TOKEN, тогда клиенты передают заголовок Authorization: Bearer.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для доступа к Xiaohongshu (RedNote): поиск заметок по ключевым словам и чтение по ссылке
Консольная утилита xhs для Xiaohongshu с готовым скиллом: агент ищет заметки, читает комментарии и публикует от аккаунта.
MCP-сервер планировщика соцсетей OpenPost: агент смотрит календарь и аккаунты, готовит черновики, планирует и публикует посты, разбирает комментарии
X API MCP (xmcp)
X API FastMCP Server
Локальный MCP-сервер на FastMCP превращает спецификацию OpenAPI платформы X в инструменты: поиск и публикация постов, сообщения, списки, закладки
Postmypost MCP — официальный сервер сервиса автопостинга: агент планирует и публикует посты в соцсетях, правит публикации и смотрит аналитику
Wenyan MCP
文颜 MCP Server
MCP-сервер, который оформляет Markdown готовыми темами и сохраняет статью в черновики аккаунта WeChat
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| xiaohongshu-mcp (эта карточка) | нет | не нужна | 17 104 | |
| last30days-cn | нет | 2 109 | скилл собирает обсуждения темы за 30 дней на восьми китайских | |
| xiaohongshu-ops | нет | 2 570 | скилл для OpenClaw | |
| Pickoo — скилл сохранения ссылок в базу знаний | нет | 20 | локальная рабочая среда Pickoo со скиллом save-to-favorites |
Коротко о README
README на китайском описывает MCP-сервер для xiaohongshu, который дает агенту доступ к данным аккаунта. Перечислены возможности: вход и проверка статуса, публикация заметок и видео, поиск, лента рекомендаций, детали поста с комментариями, профили, комментарии и ответы, лайки и избранное. Установка идет тремя путями: готовые бинарники из GitHub Releases, сборка из исходников на Go и Docker с docker compose, сервис слушает порт 18060 по пути /mcp. Отдельно описаны прокси через XHS_PROXY, опциональная защита через AUTH_TOKEN и подключение клиентов Claude Code и OpenCode. Есть заметки об эксплуатации и рисках аккаунта. Лицензия Apache 2.0.