X.com (Twitter) — Manual de Agent Browser

Secuencias de operación específicas de la plataforma para agent-browser en x.com. Cada operación documenta: precondiciones, comandos paso a paso para agent-browser, método de verificación y problemas conocidos.

Estado: Todas las secciones (1-7) probadas y documentadas. Probado con: agent-browser 0.24.0, Chrome CDP en puerto 9222, cuenta @mashijiann. Última actualización: 2026-05-06

Orientación a dispositivos: Las operaciones se ejecutan contra Chrome de escritorio por defecto. Para usar la superficie web móvil, establezca DEVICE_PROFILE=ios|android en .env o prefije los comandos de agent-browser con -p ios|android. Al registrar una acción, pase --device <objetivo> para la procedencia (no cambia la deduplicación — un like es a nivel de cuenta).

1. Navegar y Leer

1.1 Abrir Timeline Principal

Objetivo: Navegar al timeline principal y confirmar que se ha cargado.

Precondiciones: Iniciado sesión (sesión de Chrome CDP con cookies).

Pasos:

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

Verificación:

# El título debe contener "Home / X"
agent-browser get title
# La URL debe ser https://x.com/home
agent-browser get url
# La captura debe mostrar la región "Your Home Timeline" y la pestaña "For you"
agent-browser snapshot -i -c -s '[role="region"]'

Elementos Clave:

Barra lateral de navegación: navigation "Primary" — contiene enlaces: Home, Search and explore, Notifications, Direct Messages, Grok, Premium, Bookmarks, Profile
Pestañas del timeline: tab "For you" (seleccionada por defecto), tab "Following", posiblemente pestañas personalizadas
Área de redacción: textbox "Post text" — redacción en línea en la página principal
Botón de cuenta: button "Account menu" — muestra el nombre de usuario conectado
Región del timeline: region "Your Home Timeline" — contiene elementos article de tweets

Problemas Conocidos:

Ninguno

1.2 Abrir un Tweet Específico por URL

Objetivo: Navegar directamente a un tweet y leer su contenido.

Precondiciones: Tener la URL del tweet (ej. https://x.com/user/status/123456).

Pasos:

agent-browser open "https://x.com/<nombre_de_usuario>/status/<id_del_tweet>"

Verificación:

# El título debe contener el nombre del autor y una vista previa del contenido del tweet
agent-browser get title
# La URL debe coincidir con la URL del tweet
agent-browser get url
# La captura debe mostrar el artículo del tweet con el texto completo y los botones de interacción
agent-browser snapshot -i -c -s 'article'

Elementos Clave (página de detalle del tweet):

Artículo del tweet: article — contiene el texto completo del tweet, información del autor, estadísticas de interacción
Enlaces del autor: link "<NombreDePantalla> Verified account", link "@<nombre_de_usuario>"
Marca de tiempo: link "<hora> · <fecha>" (ej. "2:30 PM · May 5, 2026")
Contador de vistas: link "<N> Views"
Botones de interacción: button "N Reply. Reply", button "N reposts. Repost", button "N Likes. Like", button "N Bookmarks. Bookmark", button "Share post"
Botón de suscripción: button "Subscribe to @<nombre_de_usuario>"

Problemas Conocidos:

Ninguno

1.3 Buscar Tweets por Palabra Clave

Objetivo: Buscar tweets que coincidan con una palabra clave o consulta, leer los resultados.

Precondiciones: Iniciado sesión.

Pasos:

# Para resultados "Top" (por defecto):
agent-browser open "https://x.com/search?q=<consulta_codificada_en_url>&src=typed_query"

# Para resultados "Latest":
agent-browser open "https://x.com/search?q=<consulta_codificada_en_url>&src=typed_query&f=live"

# Para resultados "People":
agent-browser open "https://x.com/search?q=<consulta_codificada_en_url>&src=typed_query&f=user"

# Para resultados "Media":
agent-browser open "https://x.com/search?q=<consulta_codificada_en_url>&src=typed_query&f=image"

Verificación:

# El título debe contener "<consulta> - Search / X"
agent-browser get title
# Comprobar qué pestaña está activa
agent-browser snapshot -i -c -s '[role="tablist"]'
# Leer los tweets de los resultados de búsqueda
agent-browser snapshot -i -c -s 'article'

Elementos Clave:

Pestañas de búsqueda: tab "Top", tab "Latest", tab "People", tab "Media", tab "Lists"
El parámetro de URL f controla la pestaña: omitido = Top, live = Latest, user = People, image = Media
Botón de retroceso: button "Back" — vuelve a la página anterior
Cada resultado es un elemento article idéntico en estructura a los tweets del timeline

Problemas Conocidos:

Codifique la cadena de consulta en URL (espacios → %20, etc.)
Los resultados de búsqueda pueden mostrar un "muro de inicio de sesión" para sesiones no autenticadas
Los operadores de búsqueda avanzada de X funcionan: from:user, since:2026-01-01, min_faves:100, etc.

1.4 Ver un Perfil de Usuario

Objetivo: Navegar al perfil de un usuario y leer su biografía y varios tweets recientes.

Precondiciones: Tener el nombre de usuario o la URL del perfil.

Pasos:

# 1. Navegar al perfil
agent-browser open "https://x.com/<nombre_de_usuario>"

# 2. Captura inicial — normalmente solo muestra el tweet FIJADO (si lo hay)
agent-browser snapshot -i -c -s 'article'
# ADVERTENCIA: El primer artículo suele ser el tweet fijado, NO la última publicación.
# DEBE desplazarse hacia abajo para ver las publicaciones recientes reales.

# 3. Desplazarse hacia abajo para cargar publicaciones recientes (más allá del tweet fijado y el encabezado del perfil)
agent-browser scroll down 3000
agent-browser wait 2000
agent-browser snapshot -i -c -s 'article'
# Ahora debería ver la primera publicación reciente (no fijada)

# 4. Continuar desplazándose para cargar más publicaciones — repita según sea necesario
agent-browser scroll down 3000
agent-browser wait 2000
agent-browser snapshot -i -c -s 'article'

Verificación:

# El título debe contener "<NombreDePantalla> (@<nombre_de_usuario>) / X"
agent-browser get title
# La URL debe ser https://x.com/<nombre_de_usuario>
agent-browser get url

Patrón Clave — Navegación de Varias Publicaciones:

# Para navegar por N publicaciones del perfil de un usuario, use este bucle de desplazamiento:
# Cada ciclo de desplazamiento+espera revela ~1 nueva publicación debido a la lista virtualizada
for i in $(seq 1 N); do
  agent-browser scroll down 3000
  sleep 2  # o: agent-browser wait 2000
  agent-browser snapshot -i -c -s 'article'
  # Procese los artículos visibles
hecho

Problemas Conocidos:

CRÍTICO: La vista de página inicial normalmente solo muestra el tweet fijado. DEBE desplazarse hacia abajo para ver las publicaciones recientes. Los agentes a menudo piensan erróneamente que el tweet fijado es el único contenido.
X utiliza una lista virtualizada: solo 1-2 artículos en el viewport están en el DOM en cualquier momento. Los artículos desplazados se eliminan del DOM.
Un desplazamiento de 3000px + 2 segundos de espera carga de manera confiable el siguiente lote.
El tweet fijado tiene el texto "Pinned" al comienzo de la descripción de su artículo — úselo para identificarlo y omitirlo.
El perfil tiene pestañas: Posts, Replies, Highlights, Media, Likes — la predeterminada es "Posts" que excluye las respuestas. Use https://x.com/<nombre_de_usuario>/with_replies para publicaciones + respuestas.

1.5 Leer un Hilo de Tweets / Respuestas

Objetivo: Abrir un tweet y leer el hilo completo y las respuestas debajo de él.

Precondiciones: Tener la URL del tweet.

Pasos:

# 1. Abrir el tweet
agent-browser open "https://x.com/<nombre_de_usuario>/status/<id_del_tweet>"

# 2. Desplazarse hacia abajo para cargar las respuestas
agent-browser scroll down 800

# 3. Leer las respuestas (aparecen como elementos de artículo adicionales debajo del tweet principal)
agent-browser snapshot -i -c -s 'article'

Verificación:

# Debería haber múltiples elementos article — el primero es el tweet principal, el resto son respuestas
agent-browser snapshot -i -c -s 'article'

Problemas Conocidos:

Las respuestas pueden estar paginadas — busque el botón button "Show more replies" y haga clic en él.
Puede aparecer la sección "Show probably spam" — omítala.
El contexto del hilo (tweets principales) aparece encima del tweet principal.
Trampa de clic en citas: Si una respuesta o entrada del timeline es un tweet citado, hacer clic en el cuerpo del artículo navega a la publicación original citada en lugar de a la página de detalle del tweet citado. Para navegar al tweet correcto, haga clic en el enlace de la marca de tiempo. Consulte la sección 3.4 Problemas Conocidos para obtener todos los detalles.

1.6 Leer Notificaciones

Objetivo: Abrir la pestaña de notificaciones y leer las notificaciones recientes.

Precondiciones: Iniciado sesión.

Pasos:

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

Verificación:

# El título debe contener "Notifications / X"
agent-browser get title
# La URL debe ser https://x.com/notifications
agent-browser get url

Elementos Clave:

Pestañas de notificaciones: All, Verified, Mentions
El enlace de la barra lateral muestra el recuento de no leídos: link "Notifications (N unread notifications)"

Problemas Conocidos:

Las notificaciones tienen sub-pestañas: All, Verified, Mentions

1.7 Leer Mensajes Directos (DMs)

Objetivo: Abrir DMs y leer mensajes recientes.

Precondiciones: Iniciado sesión.

Pasos:

# Nota: /messages redirige a /i/chat
agent-browser open https://x.com/messages

Verificación:

# La URL será https://x.com/i/chat (redirección automática)
agent-browser get url

Problemas Conocidos:

La URL redirige de /messages a /i/chat
La interfaz de DM es un panel lateral o una página completa dependiendo del viewport
Puede requerir X Premium para algunas funciones de DM

2. Interacción — Reaccionar a Contenido

2.1 Dar Like a un Tweet

Objetivo: Dar like a un tweet específico.

Precondiciones: En una página donde el tweet sea visible (timeline, detalle del tweet, resultados de búsqueda).

Pasos:

# 1. Capturar para encontrar el botón de Like para el tweet objetivo
agent-browser snapshot -i -c -s 'article'
# Busque: button "N Likes. Like" (aún no likeado) dentro del artículo objetivo

# 2. Hacer clic en el botón de Like
agent-browser click <referencia_del_boton_like>

Verificación:

# Capturar de nuevo — el texto del botón debería cambiar de "Like" a "Liked"
agent-browser snapshot -i -c -s 'article'
# Busque: button "N Likes. Liked"

Identificación de Elementos:

No likeado: button "N Likes. Like" — el texto termina con . Like
Ya likeado: button "N Likes. Liked" — el texto termina con . Liked
El recuento de likes N aumenta en 1 después de dar like

Problemas Conocidos:

Límite de tasa: X puede restringir los likes rápidos.
La referencia del botón puede cambiar después del cambio de estado (vuelva a capturar para obtener la nueva referencia).

2.2 Quitar Like a un Tweet

Objetivo: Eliminar un like de un tweet previamente likeado.

Precondiciones: El tweet ya tiene like.

Pasos:

# 1. Capturar para encontrar el botón de Liked
agent-browser snapshot -i -c -s 'article'
# Busque: button "N Likes. Liked"

# 2. Hacer clic en el mismo botón para quitar el like
agent-browser click <referencia_del_boton_liked>

Verificación:

# El texto del botón debería volver de "Liked" a "Like"
agent-browser snapshot -i -c -s 'article'
# Busque: button "N Likes. Like"

Identificación de Elementos:

El mismo botón alterna entre los estados Like/Liked.
La referencia puede cambiar entre estados — capture siempre de nuevo.

Problemas Conocidos:

Ninguno

2.3 Retuitear (Repost)

Objetivo: Volver a publicar un tweet en el timeline propio.

Precondiciones: En una página donde el tweet sea visible.

Pasos:

# 1. Capturar para encontrar el botón de Repost
agent-browser snapshot -i -c -s 'article'
# Busque: button "N reposts. Repost" [expanded=false]

# 2. Hacer clic en el botón de Repost — esto abre un MENÚ DESPLEGABLE, no la acción en sí
agent-browser click <referencia_del_boton_repost>

# 3. Capturar para ver los elementos del menú desplegable
agent-browser snapshot -i -c -s '[role="menuitem"]'
# Muestra: menuitem "Repost" y menuitem "Quote"

# 4. Hacer clic en el elemento de menú "Repost" para ejecutar el repost
agent-browser click <referencia_del_elemento_menu_repost>

Verificación:

# Capturar — el texto del botón debería cambiar de "Repost" a "Reposted"
agent-browser snapshot -i -c -s 'article'

Identificación de Elementos:

Botón de Repost: button "N reposts. Repost" [expanded=false]
Elementos del menú desplegable: menuitem "Repost" y menuitem "Quote"
Después del repost: el botón se convierte en button "N reposts. Reposted"

Problemas Conocidos:

Operación de dos pasos: hacer clic en el botón abre un menú desplegable, luego debe hacer clic en el elemento de menú.
Para cancelar/cerrar el menú desplegable sin actuar: ...

LocoreMind/locoagent

¿Qué es locoagent?

Preguntar en tu IA favorita

Documentación

X.com (Twitter) — Manual de Agent Browser

Índice

1. Navegar y Leer

1.1 Abrir Timeline Principal

1.2 Abrir un Tweet Específico por URL

1.3 Buscar Tweets por Palabra Clave

1.4 Ver un Perfil de Usuario

1.5 Leer un Hilo de Tweets / Respuestas

1.6 Leer Notificaciones

1.7 Leer Mensajes Directos (DMs)

2. Interacción — Reaccionar a Contenido

2.1 Dar Like a un Tweet

2.2 Quitar Like a un Tweet

2.3 Retuitear (Repost)

Skills relacionados

steipete/sag

steipete/oracle

steipete/peekaboo

mattpocock/design-an-interface

mattpocock/prototype

mattpocock/grill-me