¿Qué hace xurl?
CLI oficial para la API de X.
Repositorio principal: https://github.com/xdevplatform/xurl
Instalación
Homebrew:
brew install --cask xdevplatform/tap/xurl
npm:
npm install -g @xdevplatform/xurl
Script shell:
curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
Go:
go install github.com/xdevplatform/xurl@latest
Seguridad
- Nunca lea, imprima, resuma, cargue ni pegue
~/.xurlen el contexto del LLM. - Nunca pida al usuario que pegue secretos de cliente, tokens de portador o tokens OAuth en el chat.
- Nunca use
--verboseen ejecuciones de agentes; puede exponer cabeceras de autenticación. - No ejecute comandos de autenticación con banderas secretas en línea en una sesión de agente.
- El usuario debe registrar las credenciales de la aplicación manualmente en su máquina fuera de la sesión del agente.
Autenticación
Verificar el estado actual:
xurl auth status
Si ya hay una aplicación registrada, completar OAuth 2.0:
xurl auth oauth2
Múltiples aplicaciones:
xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me
Notas:
xurlguarda la configuración de la aplicación y los tokens en~/.xurl.- La URI de redirección de OAuth 2.0 en el portal de desarrolladores de X debe ser
http://localhost:8080/callback. - Los ejemplos de registro de aplicaciones con secretos en línea se omiten intencionalmente aquí. Hágalo fuera de la sesión del agente.
Atajos comunes
xurl post "¡Hola mundo!"
xurl reply 1234567890 "Bonita publicación"
xurl quote 1234567890 "Mi opinión"
xurl delete 1234567890
xurl read 1234567890
xurl search "from:elonmusk" -n 10
xurl whoami
xurl user @XDevelopers
xurl timeline -n 20
xurl mentions -n 10
xurl like 1234567890
xurl unlike 1234567890
xurl repost 1234567890
xurl unrepost 1234567890
xurl bookmark 1234567890
xurl unbookmark 1234567890
xurl bookmarks -n 10
xurl likes -n 10
xurl follow @usuario
xurl unfollow @usuario
xurl following -n 20
xurl followers -n 20
xurl dm @usuario "mensaje"
xurl dms -n 10
xurl media upload ruta/al/archivo.mp4
xurl media status ID_DEL_MEDIA
POST_ID también puede ser una URL completa de una publicación de X.
Modo de endpoint en bruto
GET:
xurl /2/users/me
POST JSON:
xurl -X POST /2/tweets -d '{"text":"¡Hola mundo!"}'
Cabeceras:
xurl -H "Content-Type: application/json" /2/tweets
Seleccionar tipo de autenticación:
xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me
Seleccionar cuenta OAuth2:
xurl --username alice /2/users/me
Streaming:
xurl /2/tweets/search/stream
xurl -s /2/users/me
Comprobaciones rápidas
Instalación:
xurl version
Autenticación:
xurl auth status
Petición en vivo tras autenticación:
xurl whoami