X.com (Twitter) — Agent-Browser-Playbook

Plattformspezifische Betriebsabläufe für agent-browser auf x.com. Jeder Vorgang dokumentiert: Vorbedingungen, Schritt-für-Schritt-Befehle für agent-browser, Verifikationsmethode und bekannte Fallstricke.

Status: Alle Abschnitte (1-7) getestet und dokumentiert. Getestet mit: agent-browser 0.24.0, Chrome CDP auf Port 9222, Konto @mashijiann. Zuletzt aktualisiert: 2026-05-06

Zielgerät: Die Vorgänge laufen standardmäßig gegen das Desktop-Chrome. Um die mobile Web-Oberfläche zu bedienen, setzen Sie DEVICE_PROFILE=ios|android in .env oder stellen Sie den agent-browser-Befehlen -p ios|android voran. Wenn Sie eine Aktion protokollieren, übergeben Sie --device <ziel> zur Herkunftsangabe (es ändert keine Deduplizierung – ein Like ist kontobezogen).

1. Browsen & Lesen

1.1 Start-Timeline öffnen

Ziel: Zur Start-Timeline navigieren und bestätigen, dass sie geladen wurde.

Vorbedingungen: Angemeldet (Chrome CDP-Sitzung mit Cookies).

Schritte:

agent-browser open https://x.com/home

Verifikation:

# Titel sollte "Home / X" enthalten
agent-browser get title
# URL sollte https://x.com/home sein
agent-browser get url
# Snapshot sollte den Bereich "Your Home Timeline" und die Registerkarte "For you" zeigen
agent-browser snapshot -i -c -s '[role="region"]'

Schlüsselelemente:

Navigationsseitenleiste: navigation "Primary" — enthält Links: Home, Search and explore, Notifications, Direct Messages, Grok, Premium, Bookmarks, Profile
Timeline-Registerkarten: tab "For you" (standardmäßig ausgewählt), tab "Following", ggf. benutzerdefinierte Registerkarten
Verfassen-Bereich: textbox "Post text" — Inline-Verfassen auf der Startseite
Kontoschaltfläche: button "Account menu" — zeigt den angemeldeten Benutzernamen
Timeline-Bereich: region "Your Home Timeline" — enthält Tweet-article-Elemente

Bekannte Probleme:

Keine

1.2 Bestimmten Tweet per URL öffnen

Ziel: Direkt zu einem Tweet navigieren und seinen Inhalt lesen.

Vorbedingungen: Die Tweet-URL haben (z. B. https://x.com/user/status/123456).

Schritte:

agent-browser open "https://x.com/<benutzername>/status/<tweet_id>"

Verifikation:

# Titel sollte den Namen des Autors und eine Vorschau des Tweet-Inhalts enthalten
agent-browser get title
# URL sollte mit der Tweet-URL übereinstimmen
agent-browser get url
# Snapshot sollte den Tweet-Artikel mit vollständigem Text und Interaktionsschaltflächen zeigen
agent-browser snapshot -i -c -s 'article'

Schlüsselelemente (Tweet-Detailseite):

Tweet-Artikel: article — enthält vollständigen Tweet-Text, Autoreninfo, Interaktionsstatistiken
Autorenlinks: link "<Anzeigename>", link "@<benutzername>"
Zeitstempel: link "<Uhrzeit> · <Datum>" (z. B. "14:30 · 5. Mai 2026")
Aufrufzahl: link "<N> Views"
Interaktionsschaltflächen: button "N Reply. Reply", button "N reposts. Repost", button "N Likes. Like", button "N Bookmarks. Bookmark", button "Share post"
Abonnieren-Schaltfläche: button "Subscribe to @<benutzername>"

Bekannte Probleme:

Keine

1.3 Tweets nach Stichwort suchen

Ziel: Nach Tweets suchen, die einem Stichwort oder einer Suchanfrage entsprechen, Ergebnisse lesen.

Vorbedingungen: Angemeldet.

Schritte:

# Für "Top"-Ergebnisse (Standard):
agent-browser open "https://x.com/search?q=<url_codierte_abfrage>&src=typed_query"

# Für "Neueste"-Ergebnisse:
agent-browser open "https://x.com/search?q=<url_codierte_abfrage>&src=typed_query&f=live"

# Für "Personen"-Ergebnisse:
agent-browser open "https://x.com/search?q=<url_codierte_abfrage>&src=typed_query&f=user"

# Für "Medien"-Ergebnisse:
agent-browser open "https://x.com/search?q=<url_codierte_abfrage>&src=typed_query&f=image"

Verifikation:

# Titel sollte "<Suchanfrage> - Search / X" enthalten
agent-browser get title
# Prüfen, welche Registerkarte aktiv ist
agent-browser snapshot -i -c -s '[role="tablist"]'
# Suchergebnis-Tweets lesen
agent-browser snapshot -i -c -s 'article'

Schlüsselelemente:

Suchregisterkarten: tab "Top", tab "Latest", tab "People", tab "Media", tab "Lists"
Der URL-Parameter f steuert die Registerkarte: weggelassen = Top, live = Neueste, user = Personen, image = Medien
Zurück-Schaltfläche: button "Back" — kehrt zur vorherigen Seite zurück
Jedes Ergebnis ist ein article-Element, strukturell identisch mit Timeline-Tweets

Bekannte Probleme:

URL-codieren Sie die Suchanfrage (Leerzeichen → %20 usw.)
Suchergebnisse können eine „Anmeldewand“ für nicht authentifizierte Sitzungen anzeigen
X erweiterte Suchoperatoren funktionieren: from:user, since:2026-01-01, min_faves:100 usw.

1.4 Benutzerprofil anzeigen

Ziel: Zum Profil eines Benutzers navigieren und seine Bio sowie mehrere aktuelle Tweets lesen.

Vorbedingungen: Benutzername oder Profil-URL haben.

Schritte:

# 1. Zum Profil navigieren
agent-browser open "https://x.com/<benutzername>"

# 2. Erster Snapshot — zeigt normalerweise nur den ANGEHEFTETEN Tweet (falls vorhanden)
agent-browser snapshot -i -c -s 'article'
# WARNUNG: Der erste Artikel ist normalerweise der angeheftete Tweet, NICHT der neueste Beitrag.
# Sie MÜSSEN nach unten scrollen, um die tatsächlichen aktuellen Beiträge zu sehen.

# 3. Nach unten scrollen, um aktuelle Beiträge zu laden (am angehefteten Tweet und Profilkopf vorbei)
agent-browser scroll down 3000
agent-browser wait 2000
agent-browser snapshot -i -c -s 'article'
# Jetzt sollten Sie den ersten aktuellen (nicht angehefteten) Beitrag sehen

# 4. Weiter scrollen, um weitere Beiträge zu laden — nach Bedarf wiederholen
agent-browser scroll down 3000
agent-browser wait 2000
agent-browser snapshot -i -c -s 'article'

Verifikation:

# Titel sollte "<Anzeigename> (@<benutzername>) / X" enthalten
agent-browser get title
# URL sollte https://x.com/<benutzername> sein
agent-browser get url

Schlüsselmuster — Mehrere Beiträge durchsuchen:

# Um N Beiträge aus dem Profil eines Benutzers zu durchsuchen, verwenden Sie diese Scroll-Schleife:
# Jeder Scroll+Warte-Zyklus zeigt aufgrund der virtuellen Liste ~1 neuen Beitrag
for i in $(seq 1 N); do
  agent-browser scroll down 3000
  sleep 2  # oder: agent-browser wait 2000
  agent-browser snapshot -i -c -s 'article'
  # Den sichtbaren Artikel/Die sichtbaren Artikel verarbeiten
done

Bekannte Probleme:

KRITISCH: Die anfängliche Seitenansicht zeigt normalerweise nur den angehefteten Tweet. Sie MÜSSEN nach unten scrollen, um aktuelle Beiträge zu sehen. Agenten gehen oft fälschlicherweise davon aus, dass der angeheftete Tweet der einzige Inhalt ist.
X verwendet eine virtuelle Liste — nur 1-2 Artikel im Ansichtsfenster sind zu einem Zeitpunkt im DOM. Vorbeigescrollte Artikel werden aus dem DOM entfernt.
Scrollbetrag von 3000px + 2 Sekunden warten lädt zuverlässig den nächsten Stapel
Der angeheftete Tweet hat den Text "Pinned" am Anfang seiner Artikelbeschreibung — verwenden Sie dies, um ihn zu identifizieren und zu überspringen
Das Profil hat Registerkarten: Beiträge, Antworten, Highlights, Medien, Gefällt mir — Standard ist „Beiträge“, was Antworten ausschließt. Verwenden Sie https://x.com/<benutzername>/with_replies für Beiträge + Antworten.

1.5 Tweet-Thread / Antworten lesen

Ziel: Einen Tweet öffnen und den vollständigen Thread und die Antworten darunter lesen.

Vorbedingungen: Die Tweet-URL haben.

Schritte:

# 1. Tweet öffnen
agent-browser open "https://x.com/<benutzername>/status/<tweet_id>"

# 2. Nach unten scrollen, um Antworten zu laden
agent-browser scroll down 800

# 3. Antworten lesen (sie erscheinen als zusätzliche Article-Elemente unter dem Haupt-Tweet)
agent-browser snapshot -i -c -s 'article'

Verifikation:

# Es sollten mehrere Article-Elemente vorhanden sein — das erste ist der Haupt-Tweet, der Rest sind Antworten
agent-browser snapshot -i -c -s 'article'

Bekannte Probleme:

Antworten können paginiert sein — suchen Sie nach dem button "Show more replies" und klicken Sie darauf
Der Abschnitt "Show probably spam" kann erscheinen — überspringen Sie ihn
Thread-Kontext (übergeordnete Tweets) erscheint über dem Haupt-Tweet
Zitat-Tweet-Klickfalle: Wenn eine Antwort oder ein Timeline-Eintrag ein Zitat-Tweet ist, navigiert ein Klick auf den Artikelkörper zum zitierten Originalbeitrag anstatt zur Detailseite des Zitat-Tweets. Um zum korrekten Tweet zu navigieren, klicken Sie stattdessen auf den Zeitstempel-Link. Siehe Abschnitt 3.4 Bekannte Probleme für vollständige Details.

1.6 Benachrichtigungen lesen

Ziel: Die Benachrichtigungsregisterkarte öffnen und aktuelle Benachrichtigungen lesen.

Vorbedingungen: Angemeldet.

Schritte:

agent-browser open https://x.com/notifications

Verifikation:

# Titel sollte "Notifications / X" enthalten
agent-browser get title
# URL sollte https://x.com/notifications sein
agent-browser get url

Schlüsselelemente:

Benachrichtigungsregisterkarten: All, Verified, Mentions
Seitenleisten-Link zeigt ungelesene Anzahl: link "Notifications (N unread notifications)"

Bekannte Probleme:

Benachrichtigungen haben Unterregisterkarten: All, Verified, Mentions

1.7 DMs (Direktnachrichten) lesen

Ziel: DMs öffnen und aktuelle Nachrichten lesen.

Vorbedingungen: Angemeldet.

Schritte:

# Hinweis: /messages leitet zu /i/chat weiter
agent-browser open https://x.com/messages

Verifikation:

# URL wird https://x.com/i/chat sein (automatische Weiterleitung)
agent-browser get url

Bekannte Probleme:

URL leitet von /messages zu /i/chat weiter
DM-Benutzeroberfläche ist ein Seitenpanel oder eine Vollbildseite, je nach Ansichtsfenster
Für einige DM-Funktionen ist möglicherweise X Premium erforderlich

2. Interaktion — Auf Inhalte reagieren

2.1 Tweet liken

Ziel: Einen bestimmten Tweet liken.

Vorbedingungen: Auf einer Seite, auf der der Tweet sichtbar ist (Timeline, Tweet-Detail, Suchergebnisse).

Schritte:

# 1. Snapshot, um die Like-Schaltfläche für den Ziel-Tweet zu finden
agent-browser snapshot -i -c -s 'article'
# Suchen Sie nach: button "N Likes. Like" (noch nicht gelikt) innerhalb des Ziel-Artikels

# 2. Die Like-Schaltfläche klicken
agent-browser click <like_button_ref>

Verifikation:

# Erneuter Snapshot — der Schaltflächentext sollte von "Like" zu "Liked" wechseln
agent-browser snapshot -i -c -s 'article'
# Suchen Sie nach: button "N Likes. Liked"

Elementidentifikation:

Nicht gelikt: button "N Likes. Like" — Text endet mit . Like
Bereits gelikt: button "N Likes. Liked" — Text endet mit . Liked
Die Like-Zahl N erhöht sich nach dem Liken um 1

Bekannte Probleme:

Ratenbegrenzung: X kann schnelle Likes einschränken
Die Schaltflächenreferenz kann sich nach Zustandsänderung ändern (erneuten Snapshot durchführen, um neue Referenz zu erhalten)

2.2 Like eines Tweets entfernen

Ziel: Ein Like von einem zuvor gelikten Tweet entfernen.

Vorbedingungen: Der Tweet wurde bereits gelikt.

Schritte:

# 1. Snapshot, um die Gelikt-Schaltfläche zu finden
agent-browser snapshot -i -c -s 'article'
# Suchen Sie nach: button "N Likes. Liked"

# 2. Dieselbe Schaltfläche klicken, um das Like zu entfernen
agent-browser click <liked_button_ref>

Verifikation:

# Schaltflächentext sollte von "Liked" zurück zu "Like" wechseln
agent-browser snapshot -i -c -s 'article'
# Suchen Sie nach: button "N Likes. Like"

Elementidentifikation:

Dieselbe Schaltfläche wechselt zwischen den Like/Liked-Zuständen
Die Referenz kann sich zwischen den Zuständen ändern — immer einen erneuten Snapshot durchführen

Bekannte Probleme:

Keine

2.3 Retweet (Repost)

Ziel: Einen Tweet in der eigenen Timeline teilen.

Vorbedingungen: Auf einer Seite, auf der der Tweet sichtbar ist.

Schritte:

# 1. Snapshot, um die Repost-Schaltfläche zu finden
agent-browser snapshot -i -c -s 'article'
# Suchen Sie nach: button "N reposts. Repost" [expanded=false]

# 2. Repost-Schaltfläche klicken — dies öffnet ein DROPDOWN-MENÜ, nicht die Aktion selbst
agent-browser click <repost_button_ref>

# 3. Snapshot, um die Dropdown-Menüpunkte zu sehen
agent-browser snapshot -i -c -s '[role="menuitem"]'
# Zeigt: menuitem "Repost" und menuitem "Quote"

# 4. Klicken Sie auf den Menüpunkt "Repost", um den Repost auszuführen
agent-browser click <repost_menuitem_ref>

Verifikation:

# Snapshot — der Schaltflächentext sollte von "Repost" zu "Reposted" wechseln
agent-browser snapshot -i -c -s 'article'

Elementidentifikation:

Repost-Schaltfläche: button "N reposts. Repost" [expanded=false]
Dropdown-Punkte: menuitem "Repost" und menuitem "Quote"
Nach dem Repost: Schaltfläche wird zu button "N reposts. Reposted"

Bekannte Probleme:

Zweistufiger Vorgang: Das Klicken der Schaltfläche öffnet ein Dropdown, Sie müssen dann auf den Menüpunkt klicken
Zum Abbrechen/Schließen des Dropdowns ohne Aktion:

LocoreMind/locoagent

Was ist locoagent?

In Ihrer bevorzugten KI fragen

Dokumentation

X.com (Twitter) — Agent-Browser-Playbook

Inhaltsverzeichnis

1. Browsen & Lesen

1.1 Start-Timeline öffnen

1.2 Bestimmten Tweet per URL öffnen

1.3 Tweets nach Stichwort suchen

1.4 Benutzerprofil anzeigen

1.5 Tweet-Thread / Antworten lesen

1.6 Benachrichtigungen lesen

1.7 DMs (Direktnachrichten) lesen

2. Interaktion — Auf Inhalte reagieren

2.1 Tweet liken

2.2 Like eines Tweets entfernen

2.3 Retweet (Repost)

Verwandte Skills

steipete/sag

steipete/oracle

steipete/peekaboo

mattpocock/design-an-interface

mattpocock/prototype

mattpocock/grill-me