CommunitySchreiben & Editierengithub.com

steipete/xurl

Offizielle CLI für die X-API: Installation, Authentifizierung, App-Auswahl, Kurzbefehle und rohe Endpunkte.

Was ist xurl?

xurl ist die offizielle CLI für die X-API, die Entwicklern und KI-Agenten eine einfache Schnittstelle zur Interaktion mit Twitter/X bietet. Es unterstützt mehrere Installationsmethoden wie Homebrew, npm, Shell-Script und Go. Die CLI enthält Sicherheitsregeln für den Einsatz in KI-Agenten, insbesondere keine sensiblen Inhalte (wie `~/.xurl`) an das Modell weiterzugeben und keine Authentifizierungs-Schlüssel im Chat zu teilen. xurl bietet praktische Kurzbefehle für häufige Aktionen (Posten, Antworten, Liken, Folgen, DM, Medien-Upload) sowie einen Raw-Endpoint-Modus für beliebige API-Aufrufe mit GET, POST, Headern, OAuth1/OAuth2-Auswahl und Streaming. Entwickler können mehrere Apps verwalten und über das `--app`-Flag auswählen. Die Authentifizierung erfolgt über OAuth 2.0 (empfohlen) oder OAuth 1.0a, wobei die App-Registrierung außerhalb der Agenten-Sitzung manuell erfolgen muss.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/xurl

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 ~/.xurl lesen, 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 --verbose in 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:

  • xurl speichert App-Konfiguration und Tokens in ~/.xurl.
  • Der OAuth 2.0-Weiterleitungs-URI im X-Entwicklerportal sollte http://localhost:8080/callback sein.
  • 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills