x-mcp-playwright
x-mcp-playwright
Ein Twitter/X MCP-Server, unterstützt von patchright (einem stealth Playwright-Fork) und einem persistenten Chrome-Benutzerprofil.
9 gruppierte Tools – 33 Aktionen erhalten, keine Funktionalität verloren.
1. Installation
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 chromiumEinmaliger Login
x-mcp-login
# or: python login.pyÖffnet ein echtes Browserfenster. Melden Sie sich normal bei X an und schließen Sie dann das Fenster. Die Sitzung wird in ~/.x-mcp-playwright/profile/ gespeichert.
Related MCP server: X MCP Server
2. In Ihrem MCP-Client registrieren
Claude Code
claude mcp add --scope user x-twitter x-mcp-serverClaude Desktop
{
"mcpServers": {
"x-twitter": {
"command": "x-mcp-server",
"env": { "X_MCP_HEADLESS": "1" }
}
}
}Wenn x-mcp-server nicht im PATH ist, verwenden Sie:
{
"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-playwright3. Tool-Katalog (9 Tools, 33 Aktionen)
x_post – Tweets veröffentlichen (6 Aktionen)
action | Required args | Description |
|
| Einen einzelnen Tweet posten |
|
| Einen verbundenen Thread posten |
|
| Bis zu 4 Bilder oder 1 Video |
|
| Auf einen Tweet antworten |
|
| Quote-Tweet mit Kommentar |
|
| Ihren Tweet löschen |
x_engage – Mit Tweets interagieren (4 Aktionen)
action | Required args |
|
|
|
|
|
|
|
|
|
|
|
|
|
x_user – Benutzeroperationen (6 Aktionen)
action | Required args | Optional |
|
| — |
|
|
|
|
|
|
|
|
|
|
| — |
|
| — |
x_search – Tweets suchen (einfach + erweitert)
arg | Default | Description |
| — | Suchbegriffe |
|
|
|
| — | Nach Autor filtern |
| — | Nach Antwort an filtern |
| — | Datumsbereich (YYYY-MM-DD) |
| 0 | Mindestanzahl an Likes |
| 0 | Mindestanzahl an Retweets |
| — | Sprachcode |
| 10 | Maximale Ergebnisse |
x_feed – Feeds durchsuchen (4 Aktionen)
action | Description |
| Ihre Start-Timeline. Optional: |
| Ihre gespeicherten Lesezeichen |
| Erwähnungen, Likes, Follower |
| Was gerade passiert |
x_tweet – Tweet-Details (4 Aktionen)
action | Required args | Description |
|
| Vollständiger Tweet mit Metriken |
|
| Antworten unter einem Tweet |
|
| Impressionen/Engagements (eigene Tweets) |
|
| Wer hat geliked/retweetet ( |
x_list – Listen
Scenario | Args |
Ihre Listen | Keine Argumente |
Listen des Benutzers |
|
List-Tweets |
|
x_dm – Direktnachrichten (3 Aktionen)
action | Required args | Description |
|
| Eine DM senden |
| — | Letzte DM-Unterhaltungen auflisten |
|
| Nachrichten mit einem Benutzer lesen |
x_session – Sitzungsverwaltung (2 Aktionen)
action | Description |
| Gibt |
| Beliebige X-Seite erfassen. Optional: |
4. Umgebungsvariablen
Variable | Default | Description |
|
|
|
|
| Standard-Playwright-Timeout (ms) |
|
| Debug-Screenshots |
|
|
|
5. Sicherheit
Ratenbegrenzer: Schreibaktionen (post, delete, DM, reply) auf 1/min begrenzt. Interaktionsaktionen (like, RT, follow) auf 2/min begrenzt. Leseaktionen unbegrenzt.
Sitzungs-Keepalive: Hintergrundaufgabe pingt X alle 30 Minuten. Protokolliert eine Warnung, wenn die Sitzung abläuft.
An Ihr echtes Konto gebunden. Alles, was das LLM tut, haben Sie getan.
6. MCP-Ressourcen
x://session/status— Anmeldestatusx://version— Serverversionx://tools/list— Alle Toolsx://tools/categories— Gruppierte Taxonomie
7. MCP-Prompts
analyze_tweet(tweet_url)— Tweet abrufen und analysieren (Stimmung, Engagement, Antwortton)draft_reply(tweet_url, intent)— 3 Antwortvarianten unter 280 Zeichen entwerfen
7. Entwicklung
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, screenshots8. Sicherheit
An Ihr echtes Konto gebunden. Alles, was das LLM tut, haben Sie getan.
Begrenzung: <= 1-2 Veröffentlichungs-/Antwortaktionen pro Minute.
Sperren Sie destruktive Tools (
delete,block,send_dm) hinter menschlicher Genehmigung auf VPS.
Lizenz
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
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.
- UniPostOAuthai.unipost
Hosted MCP server for AI agents to post to LinkedIn profiles and X and upload to YouTube.
Related MCP Servers
FlicenseNot gradedqualityFmaintenanceA 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.865-- AlicenseBqualityDmaintenanceMCP server for interacting with the X platform (Twitter) via MCP clients like Claude, Cursor AI, and Windsurf AI.205 npm6MIT
- AlicenseNot gradedqualityDmaintenanceProvides programmatic X (Twitter) engagement via MCP, offering 24 tools for search, timelines, notifications, bookmarks, profiles, and tweet actions through a headless browser.MIT
- AlicenseAqualityAmaintenanceMCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.94286 npm4MIT