Skip to main content
Glama
deenesjakoruzh
Steph-ux

x-mcp-playwright

by Steph-ux
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

x-mcp-playwright

Twitter/X MCP-сервер на базе patchright (скрытая версия Playwright) и постоянного пользовательского профиля Chrome.

9 сгруппированных инструментов — 33 действия сохранены, ни одна функция не потеряна.

1. Установка

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 chromium

Разовый вход в систему

x-mcp-login
# or: python login.py

Открывает настоящее окно браузера. Войдите в X обычным образом, затем закройте окно. Сессия сохраняется в ~/.x-mcp-playwright/profile/.

2. Регистрация в вашем MCP-клиенте

Claude Code

claude mcp add --scope user x-twitter x-mcp-server

Claude Desktop

{
  "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 (headless VPS)

docker build -t x-mcp-playwright .
docker run -i --rm \
  -v ~/.x-mcp-playwright/profile:/root/.x-mcp-playwright/profile \
  x-mcp-playwright

3. Каталог инструментов (9 инструментов, 33 действия)

x_post — Публикация твитов (6 действий)

действие

Обязательные аргументы

Описание

post

text

Опубликовать один твит

thread

tweets (разделены новой строкой)

Опубликовать ветку

post_media

text, media_paths (через запятую)

до 4 изображений или 1 видео

reply

tweet_url, reply_text

Ответить на твит

quote

tweet_url, comment

Цитировать твит с комментарием

delete

tweet_url

Удалить свой твит

x_engage — Взаимодействие с твитами (4 действия)

действие

Обязательные аргументы

параметр on

like

tweet_url

on=True — лайк, False — снять лайк

retweet

tweet_url

on=True — ретвит, False — отменить

bookmark

tweet_url

on=True — добавить, False — удалить

pin

tweet_url

on=True — закрепить, False — открепить

x_user — Операции с пользователями (6 действий)

действие

Обязательные аргументы

Необязательные

profile

handle

—

timeline

handle

tab="tweets"|"likes"|"media", limit

connections

handle

kind="followers"|"following", limit

follow

handle

on=True — подписаться, False — отписаться

block

handle

—

mute

handle

—

x_search — Поиск твитов (простой + расширенный)

аргумент

По умолчанию

Описание

query

—

Ключевые слова для поиска

filter

"top"

"latest", "people", "media"

from_user

—

Фильтр по автору

to_user

—

Фильтр по адресату

since / until

—

Диапазон дат (ГГГГ-ММ-ДД)

min_likes

0

Минимум лайков

min_retweets

0

Минимум ретвитов

lang

—

Язык

limit

10

Максимум результатов

x_feed — Просмотр лент (4 действия)

действие

Описание

home

Ваша домашняя лента. Необязательно: tab="for_you"|"following"

notifications

Ваши уведомления (лайки, ретвиты, подписки)

bookmarks

Ваши сохранённые закладки

trends

Что происходит сейчас

x_tweet — Твиты (4 действия)

действие

Обязательные аргументы

Описание

details

tweet_url

Полный твит с метриками

replies

tweet_url

Ответы под твитом

analytics

tweet_url

Показы/вовлечённость (для своих твитов)

engagers

tweet_url

Кто лайкнул/ретвитнул (kind="likes"|"retweets")

x_list — Списки

Сценарий

Аргументы

Ваши списки

Без аргументов

Списки пользователя

handle

Твиты из списка

list_id

x_dm — Личные сообщения (3 действия)

действие

Обязательные аргументы

Описание

send

handle, message

Отправить ЛС

conversations

—

Список последних диалогов

messages

handle

Прочитать переписку с пользователем

x_session — Управление сессией (2 действия)

действие

Описание

check

Возвращает {logged_in, current_url, user_handle}

screenshot

Снимок любой страницы X. Необязательно: url, full_page

4. Переменные окружения

Переменная

По умолчанию

Описание

X_MCP_HEADLESS

1

0 — показать окно браузера

X_MCP_TIMEOUT_MS

20000

Таймаут Playwright (мс)

X_MCP_SCREENSHOT_DIR

~/.x-mcp-playwright/screenshots

Папка для скриншотов

X_MCP_USE_SYSTEM_CHROME

0

1 — использовать системный Chrome

5. Безопасность

  • Ограничение частоты запросов: Действия записи (пост, удаление, DM, ответ) ограничены 1 в минуту. Действия взаимодействия (лайк, RT, подписка) — 2 в минуту.

  • Поддержание сессии: Фоновая задача проверяет сессию, предупреждает при истечении.

6. MCP-ресурсы

  • x://profile — текущий профиль

  • x://bookmarks — закладки

  • x://notifications — уведомления

7. Разработка

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 installed

-
license - not tested
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • excalibur-mcp

    FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native

  • GTM API: LinkedIn MCP Server

    Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.

  • mcp-server

    Remote MCP server for The Colony — a social network for AI agents (posts, DMs, search, marketplace).

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Steph-ux/x-mcp-playwright'

If you have feedback or need assistance with the MCP directory API, please join our Discord server