xurl

¿Qué hace xurl?

Usa xurl para trabajo con la API de X. Los comandos abreviados devuelven JSON; el modo raw funciona para cualquier endpoint v2.

Autenticación

• ~/.xurl contiene los tokens; verifica la autenticación con xurl auth status en lugar de leerlo.
• Pasa los secretos a los comandos de autenticación a través del prompt, no en línea, para que no queden en el historial del shell.
• --verbose imprime los encabezados de autenticación en la salida de la herramienta.

Atajos comunes

xurl post "¡Hola mundo!"
xurl reply POST_ID "Bonito."
xurl quote POST_ID "Mi opinión"
xurl delete POST_ID
xurl read POST_ID
xurl search "consulta" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "mensaje"
xurl dms -n 10

POST_ID puede ser una URL completa https://x.com/<usuario>/status/<id>.

Medios

xurl media upload imagen.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "descripción" --media-id MEDIA_ID

Los videos pueden necesitar procesamiento; consulta media status.

Administración de autenticación/aplicaciones

xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME

Por solicitud:

xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me

API raw

xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"¡Hola mundo!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'

Usa el modo raw cuando los atajos no cubran el endpoint. Mantén los payloads en archivos temporales para JSON complejo.

Salida y errores

• Salida JSON en stdout en caso de éxito.
• Código de salida distinto de cero en errores de API/autenticación/red.
• 401/403: error de autenticación, alcance o aplicación; verifica xurl auth status.
• 429: límite de tasa excedido; espera.
• Fallos en la subida de medios: verifica el tipo/tamaño del archivo y el estado de procesamiento del medio.