de en es ja ko ru zh

x-mcp-playwright

Name: x-mcp-playwright
Author: Steph-ux

by Steph-ux

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

x-mcp-playwright

Un servidor MCP de Twitter/X impulsado por patchright (fork sigiloso de Playwright) y un perfil de usuario de Chrome persistente.

9 herramientas agrupadas — 33 acciones conservadas, cero funcionalidad perdida.

1. Instalación

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

Inicio de sesión por única vez

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

Abre una ventana de navegador real. Inicia sesión en X con normalidad y luego cierra la ventana. La sesión se guarda en ~/.x-mcp-playwright/profile/.

Related MCP server: X MCP Server

2. Registro en tu cliente 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" }
    }
  }
}

Si x-mcp-server no está en el PATH, usa:

{
  "mcpServers": {
    "x-twitter": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["-m", "x_mcp_server"]
    }
  }
}

Docker (VPS sin interfaz gráfica)

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

3. Catálogo de herramientas (9 herramientas, 33 acciones)

`x_post` — Publicar tweets (6 acciones)

acción	Argumentos obligatorios	Descripción
`post`	`text`	Publicar un solo tweet
`thread`	`tweets` (separados por saltos de línea)	Publicar un hilo
`post_media`	`text`, `media_paths` (separados por comas)	Hasta 4 imágenes o 1 vídeo
`reply`	`tweet_url`, `reply_text`	Responder a un tweet
`quote`	`tweet_url`, `comment`	Citar un tweet con comentario
`delete`	`tweet_url`	Eliminar tu tweet

`x_engage` — Interactuar con tweets (4 acciones)

acción	Argumentos obligatorios	Parámetro `on`
`like`	`tweet_url`	`on=True` para dar like, `False` para quitarlo
`retweet`	`tweet_url`	`on=True` para RT, `False` para deshacer
`bookmark`	`tweet_url`	`on=True` para guardar, `False` para eliminar
`pin`	`tweet_url`	`on=True` para fijar, `False` para desfijar

`x_user` — Operaciones de usuario (6 acciones)

acción	Argumentos obligatorios	Opcional
`profile`	`handle`	—
`timeline`	`handle`	`tab="tweets"\|"likes"\|"media"`, `limit`
`connections`	`handle`	`kind="followers"\|"following"`, `limit`
`follow`	`handle`	`on=True` para seguir, `False` para dejar de seguir
`block`	`handle`	—
`mute`	`handle`	—

`x_search` — Buscar tweets (simple + avanzado)

argumento	Por defecto	Descripción
`query`	—	Palabras clave de búsqueda
`filter`	`"top"`	`"latest"`, `"people"`, `"media"`
`from_user`	—	Filtrar por autor
`to_user`	—	Filtrar por destinatario
`since` / `until`	—	Rango de fechas (YYYY-MM-DD)
`min_likes`	0	Mínimo de likes
`min_retweets`	0	Mínimo de retweets
`lang`	—	Código de idioma
`limit`	10	Máximo de resultados

`x_feed` — Explorar feeds (4 acciones)

acción	Descripción
`home`	Tu cronología de inicio. Opcional: `tab="for_you"\|"following"`
`bookmarks`	Tus marcadores guardados
`notifications`	Menciones, likes, seguidores
`trending`	Lo que está pasando

`x_tweet` — Detalles del tweet (4 acciones)

acción	Argumentos obligatorios	Descripción
`details`	`tweet_url`	Tweet completo con métricas
`replies`	`tweet_url`	Respuestas en un tweet
`analytics`	`tweet_url`	Impresiones/interacciones (tweets propios)
`engagers`	`tweet_url`	Quiénes dieron like/retweetearon (`kind="likes"\|"retweets"`)

`x_list` — Listas

Escenario	Argumentos
Tus listas	Sin argumentos
Listas de un usuario	`handle`
Tweets de una lista	`list_id`

`x_dm` — Mensajes directos (3 acciones)

acción	Argumentos obligatorios	Descripción
`send`	`handle`, `message`	Enviar un DM
`conversations`	—	Listar hilos de DM recientes
`messages`	`handle`	Leer mensajes con un usuario

`x_session` — Gestión de sesión (2 acciones)

acción	Descripción
`check`	Devuelve `{logged_in, current_url, user_handle}`
`screenshot`	Captura cualquier página de X. Opcional: `url`, `full_page`

4. Variables de entorno

Variable	Por defecto	Descripción
`X_MCP_HEADLESS`	`1`	`0` para ver la ventana del navegador
`X_MCP_TIMEOUT_MS`	`20000`	Tiempo de espera predeterminado de Playwright (ms)
`X_MCP_SCREENSHOT_DIR`	`~/.x-mcp-playwright/screenshots`	Capturas de pantalla de depuración
`X_MCP_USE_SYSTEM_CHROME`	`0`	`1` para usar el Chrome del sistema

5. Seguridad

Limitador de frecuencia: Las acciones de escritura (post, delete, DM, reply) están limitadas a 1/min. Las acciones de interacción (like, RT, follow) están limitadas a 2/min. Las acciones de lectura son ilimitadas.
Keepalive de sesión: Una tarea en segundo plano hace ping a X cada 30 min. Registra una advertencia si la sesión expira.
Vinculado a tu cuenta real. Cualquier cosa que haga el LLM, la hiciste tú.

6. Recursos MCP

x://session/status — Estado de inicio de sesión
x://version — Versión del servidor
x://tools/list — Todas las herramientas
x://tools/categories — Taxonomía agrupada

7. Prompts de MCP

analyze_tweet(tweet_url) — Obtener y analizar un tweet (sentimiento, interacción, tono de respuesta)
draft_reply(tweet_url, intent) — Redactar 3 variantes de respuesta de menos de 280 caracteres

7. Desarrollo

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

8. Seguridad

Vinculado a tu cuenta real. Cualquier cosa que haga el LLM, la hiciste tú.
Límite: <= 1-2 acciones de publicación/respuesta por minuto.
Restringe las herramientas destructivas (delete, block, send_dm) a la aprobación humana en el VPS.

Licencia

MIT

This server cannot be deployed

Let your AI agent see the webWeb-to-screenshot MCP for Claude, Cursor and Codex. No cookie banners. Free to start.snap-render.comAd

Maintenance

ActivityStale

ResponsivenessNo issues

Resources

Related MCP Connectors

X (Twitter) MCP by InsightfulPipe AOAuth
com.insightfulpipe
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Social Media Communication
41
https://x-organic.insightfulmcp.com/
twitterapi-mcp-server A
io.github.kaitoInfra
Twitter/X read-only MCP server — 12 tools: search, users, tweets, followers, timelines, trends.
Social Media Search
121
https://mcp.twitterapi.io/mcp
mcp-server A
io.twitterapi
Official twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.
Social Media Search
1211
https://mcp.twitterapi.io/v1/mcp
UniPostOAuth
ai.unipost
Hosted MCP server for AI agents to post to LinkedIn profiles and X and upload to YouTube.
Social Media Marketing App Automation
1
https://mcp.unipost.ai/mcp

Related MCP Servers

X API FastMCP Serverofficial
Social Media Search
xdevplatform
F
license
Not graded
quality
F
maintenance
A local MCP server that exposes the X API (formerly Twitter API) as tools, enabling operations like posting, searching, user management, and more via natural language commands.
Updated 7 months ago (2026-04-09 19:59 UTC)
865
-
X MCP Server
Social Media Communication
siddheshutd
A
license
B
quality
D
maintenance
MCP server for interacting with the X platform (Twitter) via MCP clients like Claude, Cursor AI, and Windsurf AI.
Updated 2 years ago (2025-03-10 15:57 UTC)
20
5 npm
6
MIT
xengager-mcp
Social Media Browser Automation
ogunbaysal
A
license
Not graded
quality
D
maintenance
Provides programmatic X (Twitter) engagement via MCP, offering 24 tools for search, timelines, notifications, bookmarks, profiles, and tweet actions through a headless browser.
Updated 4 months ago (2026-06-19 19:39 UTC)
MIT
twitterapis
Search Social Media
TwitterAPIs
A
license
A
quality
A
maintenance
MCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.
Updated 8 days ago (2026-10-20 22:25 UTC)
94
375 npm
MIT

x-mcp-playwright

1. Instalación

Inicio de sesión por única vez

2. Registro en tu cliente MCP

Claude Code

Claude Desktop

Docker (VPS sin interfaz gráfica)

3. Catálogo de herramientas (9 herramientas, 33 acciones)

x_post — Publicar tweets (6 acciones)

x_engage — Interactuar con tweets (4 acciones)

x_user — Operaciones de usuario (6 acciones)

x_search — Buscar tweets (simple + avanzado)

x_feed — Explorar feeds (4 acciones)

x_tweet — Detalles del tweet (4 acciones)

x_list — Listas

x_dm — Mensajes directos (3 acciones)

x_session — Gestión de sesión (2 acciones)

4. Variables de entorno

5. Seguridad

6. Recursos MCP

7. Prompts de MCP

7. Desarrollo

8. Seguridad

Licencia

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

X API FastMCP Serverofficial

X MCP Server

xengager-mcp

twitterapis

`x_post` — Publicar tweets (6 acciones)

`x_engage` — Interactuar con tweets (4 acciones)

`x_user` — Operaciones de usuario (6 acciones)

`x_search` — Buscar tweets (simple + avanzado)

`x_feed` — Explorar feeds (4 acciones)

`x_tweet` — Detalles del tweet (4 acciones)

`x_list` — Listas

`x_dm` — Mensajes directos (3 acciones)

`x_session` — Gestión de sesión (2 acciones)