xurl

Que fait xurl ?

Utilisez xurl pour travailler avec l'API de X. Les commandes raccourcies renvoient du JSON ; le mode brut fonctionne pour n'importe quel endpoint v2.

Authentification

• ~/.xurl contient les jetons ; vérifiez l'authentification avec xurl auth status au lieu de lire ce fichier.
• Passez les secrets aux commandes d'authentification via l'invite, pas en ligne, afin qu'ils restent hors de l'historique du shell.
• --verbose affiche les en-têtes d'authentification dans la sortie de l'outil.

Raccourcis courants

xurl post "Bonjour tout le monde !"
xurl reply POST_ID "Sympa."
xurl quote POST_ID "Mon avis"
xurl delete POST_ID
xurl read POST_ID
xurl search "requête" -n 20
xurl whoami
xurl user @pseudo
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 @pseudo
xurl unfollow @pseudo
xurl block @pseudo
xurl unblock @pseudo
xurl mute @pseudo
xurl unmute @pseudo
xurl dm @pseudo "message"
xurl dms -n 10

POST_ID peut être une URL complète https://x.com/<utilisateur>/status/<id>.

Médias

xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "légende" --media-id MEDIA_ID

Les vidéos peuvent nécessiter un traitement ; interrogez media status.

Gestion de l'authentification / des applications

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

Par requête :

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

API brute

xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Bonjour tout le monde !"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'

Utilisez le mode brut lorsque les raccourcis ne couvrent pas l'endpoint. Conservez les corps de requête dans des fichiers temporaires pour le JSON complexe.

Sortie et erreurs

• Sortie JSON sur succès.
• Code de sortie non nul en cas d'erreur d'API, d'authentification ou de réseau.
• 401/403 : problème d'authentification, de portée ou d'application ; vérifiez xurl auth status.
• 429 : limite de débit atteinte ; patientez.
• Échecs d'upload de média : vérifiez le type/taille du fichier et l'état de traitement du média.