# socialclaw

Подключает агента к соцсетям через хостинг: расписание, публикация, аналитика. Нужен ключ воркспейса и активный тариф.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 98
- Автор: ndesv21
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ndesv21/socialclaw
- Обновлён: 2026-10-12
- HTML: https://affpapa.org/nevibecode/mcp/socialclaw

## Что делает

socialclaw — это MCP-сервер, который даёт агенту 17 инструментов для работы с подключёнными аккаунтами: список аккаунтов и их возможностей, загрузка медиа, проверка и предпросмотр расписания, публикация черновиков, разбор постов, попыток, запусков, аналитики, расхода и состояния воркспейса. Публикация идёт через хостинг SocialClaw, поэтому все действия выполняются в вашем рабочем пространстве, а не локально.

Сервер запускается командой `npx -y socialclaw mcp`. Ключ передаётся переменной `SOCIALCLAW_API_KEY`. Если вы уже выполнили `socialclaw login --api-key <key>`, сервер возьмёт сохранённые учётные данные, и блок `env` не нужен. Одного ключа мало: у воркспейса должен быть активный триал или платный план, иначе команды вернут `plan_required` или `subscription_*`.

Подключение аккаунтов идёт через браузерный OAuth, а для Discord и Telegram — вручную: вебхук для Discord, токен бота и `chat-id` для Telegram. Расписания принимаются в JSON или YAML. Пакет ставится глобально через `npm install -g socialclaw`, а как скилл для агента — через `npx skills add ndesv21/socialclaw`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://getsocialclaw.com/mcp`
- Переменные окружения: `SOCIALCLAW_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
claude mcp add socialclaw -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclaw
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add socialclaw --url https://getsocialclaw.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add socialclaw --env SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclaw
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "socialclaw": {
            "url": "https://getsocialclaw.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "socialclaw": {
            "command": "npx",
            "args": [
                "-y",
                "socialclaw"
            ],
            "env": {
                "SOCIALCLAW_API_KEY": "<SOCIALCLAW_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "socialclaw": {
            "type": "http",
            "url": "https://getsocialclaw.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "socialclaw": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "socialclaw"
            ],
            "env": {
                "SOCIALCLAW_API_KEY": "<SOCIALCLAW_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http socialclaw https://getsocialclaw.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> socialclaw npx -y socialclaw
```
Вместо <…> подставьте свои значения

## Когда брать
- поставить посты в очередь на несколько площадок из одного расписания
- загрузить картинку и привязать её к публикации
- проверить расписание до отправки и увидеть ошибки
- посмотреть, как прошла публикация и что с доставкой
- снять с публикации пост на стороне провайдера

## Примеры запросов агенту
- Покажи подключённые аккаунты и их возможности
- Проверь расписание из `schedule.json` и покажи предпросмотр кампании
- Загрузи `./image.png` и поставь пост с ним в очередь

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12791

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
