Twitter/X MCP-сервер на базе patchright (скрытая версия Playwright) и постоянного пользовательского профиля Chrome.
9 сгруппированных инструментов — 33 действия сохранены, ни одна функция не потеряна.
git clone <this-repo> x-mcp-playwright
cd x-mcp-playwright
python -m venv .venv
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate
pip install -e .
patchright install chromiumx-mcp-login
# or: python login.pyОткрывает настоящее окно браузера. Войдите в X обычным образом, затем закройте окно. Сессия сохраняется в ~/.x-mcp-playwright/profile/.
Related MCP server: X MCP Server
claude mcp add --scope user x-twitter x-mcp-server{
"mcpServers": {
"x-twitter": {
"command": "x-mcp-server",
"env": { "X_MCP_HEADLESS": "1" }
}
}
}Если x-mcp-server не в PATH, используйте:
{
"mcpServers": {
"x-twitter": {
"command": "/absolute/path/to/.venv/bin/python",
"args": ["-m", "x_mcp_server"]
}
}
}docker build -t x-mcp-playwright .
docker run -i --rm \
-v ~/.x-mcp-playwright/profile:/root/.x-mcp-playwright/profile \
x-mcp-playwrightx_post — Публикация твитов (6 действий)действие | Обязательные аргументы | Описание |
|
| Опубликовать один твит |
|
| Опубликовать ветку |
|
| до 4 изображений или 1 видео |
|
| Ответить на твит |
|
| Цитировать твит с комментарием |
|
| Удалить свой твит |
x_engage — Взаимодействие с твитами (4 действия)действие | Обязательные аргументы | параметр |
|
|
|
|
|
|
|
|
|
|
|
|
x_user — Операции с пользователями (6 действий)действие | Обязательные аргументы | Необязательные |
|
| — |
|
|
|
|
|
|
|
|
|
|
| — |
|
| — |
x_search — Поиск твитов (простой + расширенный)аргумент | По умолчанию | Описание |
| — | Ключевые слова для поиска |
|
|
|
| — | Фильтр по автору |
| — | Фильтр по адресату |
| — | Диапазон дат (ГГГГ-ММ-ДД) |
| 0 | Минимум лайков |
| 0 | Минимум ретвитов |
| — | Язык |
| 10 | Максимум результатов |
x_feed — Просмотр лент (4 действия)действие | Описание |
| Ваша домашняя лента. Необязательно: |
| Ваши уведомления (лайки, ретвиты, подписки) |
| Ваши сохранённые закладки |
| Что происходит сейчас |
x_tweet — Твиты (4 действия)действие | Обязательные аргументы | Описание |
|
| Полный твит с метриками |
|
| Ответы под твитом |
|
| Показы/вовлечённость (для своих твитов) |
|
| Кто лайкнул/ретвитнул ( |
x_list — СпискиСценарий | Аргументы |
Ваши списки | Без аргументов |
Списки пользователя |
|
Твиты из списка |
|
x_dm — Личные сообщения (3 действия)действие | Обязательные аргументы | Описание |
|
| Отправить ЛС |
| — | Список последних диалогов |
|
| Прочитать переписку с пользователем |
x_session — Управление сессией (2 действия)действие | Описание |
| Возвращает |
| Снимок любой страницы X. Необязательно: |
Переменная | По умолчанию | Описание |
|
|
|
|
| Таймаут Playwright (мс) |
|
| Папка для скриншотов |
|
|
|
Ограничение частоты запросов: Действия записи (пост, удаление, DM, ответ) ограничены 1 в минуту. Действия взаимодействия (лайк, RT, подписка) — 2 в минуту.
Поддержание сессии: Фоновая задача проверяет сессию, предупреждает при истечении.
x://profile — текущий профиль
x://bookmarks — закладки
x://notifications — уведомления
make install # deps + chromium
make login # interactive X login
make test # unit tests (no browser)
make smoke # live search test
make server # run MCP server
make lint # compile-check
make clean # remove pycache, screenshotsПереведено с сохранением структуры и всех технических элементов.
This server cannot be deployed
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Twitter/X read-only MCP server — 12 tools: search, users, tweets, followers, timelines, trends.
Official twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.
Official MCP server for twitterapis.com. Read and write Twitter/X: search, users, tweets, DMs.
