xurl

Was macht xurl?

Verwenden Sie xurl für die Arbeit mit der X-API. Kurzbefehle geben JSON zurück; der Rohmodus funktioniert mit jedem v2-Endpunkt.

Authentifizierung

• ~/.xurl enthält Tokens; überprüfen Sie die Authentifizierung mit xurl auth status, anstatt die Datei direkt zu lesen.
• Übergeben Sie Geheimnisse über die Eingabeaufforderung an Auth-Befehle, nicht direkt in der Befehlszeile, damit sie nicht im Shell-Verlauf landen.
• --verbose gibt Auth-Header in die Tool-Ausgabe aus.

Allgemeine Kurzbefehle

xurl post "Hallo Welt!"
xurl reply POST_ID "Schön."
xurl quote POST_ID "Meine Meinung"
xurl delete POST_ID
xurl read POST_ID
xurl search "Suchbegriff" -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 "Nachricht"
xurl dms -n 10

POST_ID kann eine vollständige https://x.com/<user>/status/<id>-URL sein.

Medien

xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "Bildunterschrift" --media-id MEDIA_ID

Videos benötigen möglicherweise eine Verarbeitung; fragen Sie den media status ab.

Authentifizierungs-/App-Verwaltung

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

Pro Anfrage:

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

Roh-API

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

Verwenden Sie den Rohmodus, wenn die Kurzbefehle den Endpunkt nicht abdecken. Halten Sie Payloads für komplexes JSON in temporären Dateien.

Ausgabe und Fehler

• JSON auf stdout bei Erfolg.
• Exit-Code ungleich Null bei API-/Authentifizierungs-/Netzwerkfehlern.
• 401/403: Authentifizierungs-, Bereichs- oder App-Konflikt; überprüfen Sie xurl auth status.
• 429: Rate-Limit erreicht; warten Sie.
• Fehler beim Medien-Upload: Überprüfen Sie Dateityp/-größe und den Verarbeitungsstatus der Medien.