Que fait xurl ?
Interface en ligne de commande officielle pour l'API X.
Dépôt principal : https://github.com/xdevplatform/xurl
Installation
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
Sécurité
- Ne jamais lire, imprimer, résumer, télécharger ou coller le contenu de
~/.xurldans le contexte d'un LLM. - Ne jamais demander à l'utilisateur de coller des secrets client, des jetons porteurs ou des jetons OAuth dans le chat.
- Ne jamais utiliser
--verboselors des exécutions agent ; cela pourrait exposer les en-têtes d'authentification. - Ne pas exécuter de commandes d'authentification avec des flags secrets en ligne dans une session agent.
- L'utilisateur doit enregistrer les identifiants de l'application manuellement sur sa machine en dehors de la session agent.
Authentification
Vérifier l'état actuel :
xurl auth status
Si une application est déjà enregistrée, terminer l'authentification OAuth 2.0 :
xurl auth oauth2
Multi-application :
xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me
Remarques :
xurlstocke la configuration de l'application et les jetons dans~/.xurl.- L'URI de redirection OAuth 2.0 dans le portail développeur X doit être
http://localhost:8080/callback. - Les exemples d'enregistrement d'application avec des secrets en ligne sont délibérément omis ici. Faites cela en dehors de la session agent.
Raccourcis courants
xurl post "Bonjour tout le monde !"
xurl reply 1234567890 "Joli message"
xurl quote 1234567890 "Mon opinion"
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 @handle
xurl unfollow @handle
xurl following -n 20
xurl followers -n 20
xurl dm @handle "message"
xurl dms -n 10
xurl media upload path/to/file.mp4
xurl media status MEDIA_ID
POST_ID peut également être une URL complète d'un statut X.
Mode point d'accès brut
GET :
xurl /2/users/me
POST JSON :
xurl -X POST /2/tweets -d '{"text":"Bonjour tout le monde !"}'
En-têtes :
xurl -H "Content-Type: application/json" /2/tweets
Choisir le type d'authentification :
xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me
Choisir un compte OAuth2 :
xurl --username alice /2/users/me
Streaming :
xurl /2/tweets/search/stream
xurl -s /2/users/me
Vérifications rapides
Installation :
xurl version
Authentification :
xurl auth status
Requête en direct après authentification :
xurl whoami