Was macht xurl?
Offizielle CLI für die X-API.
Primäre Quelle: https://github.com/xdevplatform/xurl
Installation
Homebrew:
brew install --cask xdevplatform/tap/xurl
npm:
npm install -g @xdevplatform/xurl
Shell-Script:
curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
Go:
go install github.com/xdevplatform/xurl@latest
Sicherheit
- Niemals
~/.xurllesen, ausdrucken, zusammenfassen, hochladen oder in den LLM-Kontext einfügen. - Niemals den Benutzer bitten, Client-Secrets, Bearer-Tokens oder OAuth-Tokens in den Chat einzufügen.
- Niemals
--verbosein Agentenläufen verwenden; es kann Auth-Header offenlegen. - Keine Authentifizierungsbefehle mit Inline-Secret-Flags in einer Agentensitzung ausführen.
- Der Benutzer muss die App-Anmeldedaten manuell auf seinem Rechner außerhalb der Agentensitzung registrieren.
Authentifizierung
Aktuellen Status prüfen:
xurl auth status
Wenn bereits eine App registriert ist, OAuth 2.0 abschließen:
xurl auth oauth2
Mehrere Apps:
xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me
Hinweise:
xurlspeichert App-Konfiguration und Tokens in~/.xurl.- Der OAuth 2.0-Weiterleitungs-URI im X-Entwicklerportal sollte
http://localhost:8080/callbacksein. - Beispiele für die App-Registrierung mit Inline-Secrets werden hier absichtlich weggelassen. Führen Sie dies außerhalb der Agentensitzung durch.
Häufige Kurzbefehle
xurl post "Hello world!"
xurl reply 1234567890 "Nice post"
xurl quote 1234567890 "My take"
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 kann auch eine vollständige X-Status-URL sein.
Raw-Endpunkt-Modus
GET:
xurl /2/users/me
POST JSON:
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
Header:
xurl -H "Content-Type: application/json" /2/tweets
Authentifizierungstyp wählen:
xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me
OAuth2-Konto wählen:
xurl --username alice /2/users/me
Streaming:
xurl /2/tweets/search/stream
xurl -s /2/users/me
Schnellchecks
Installation:
xurl version
Authentifizierung:
xurl auth status
Live-Anfrage nach Authentifizierung:
xurl whoami