CommunityRédaction et éditiongithub.com

steipete/xurl

xurl CLI pour l'API X : installation, authentification, choix d'application, raccourcis et points d'accès bruts.

Qu'est-ce que xurl ?

xurl est un outil en ligne de commande officiel pour l'API X (anciennement Twitter). Il permet d'effectuer facilement des actions courantes comme poster un tweet, répondre, citer, supprimer, rechercher des messages, gérer les likes et les reposts, suivre des utilisateurs, envoyer des messages privés, et télécharger des médias. Il offre également un mode « point d'accès brut » pour interagir directement avec les endpoints de l'API X via GET, POST, et streaming. L'authentification est gérée via OAuth 1.0a ou OAuth 2.0, avec un support multi-compte. L'outil met l'accent sur la sécurité : il déconseille de partager les tokens ou secrets dans le contexte d'un agent IA, et ne doit jamais être utilisé avec le flag --verbose. Il prend en charge l'installation via Homebrew, npm, un script shell ou Go. xurl est utile pour les développeurs et les utilisateurs en ligne de commande qui souhaitent automatiser leurs interactions avec l'API X de manière rapide et fiable.

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 ~/.xurl dans 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 --verbose lors 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 :

  • xurl stocke 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

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.

Skills associés