CommunityRedacción y edicióngithub.com

steipete/xurl

CLI oficial de la API de X: instalación, autenticación, selección de aplicación, atajos y endpoints en bruto.

¿Qué es xurl?

xurl es la interfaz de línea de comandos oficial para la API de X (antes Twitter). Permite a desarrolladores y agentes de IA como Claude Code, Cursor o Codex publicar tweets, responder, citar, eliminar, buscar, seguir, enviar mensajes directos, gestionar favoritos y mucho más, todo desde la terminal. Soporta múltiples métodos de autenticación (OAuth 1.0a, OAuth 2.0 y autenticación de aplicación) y permite trabajar con múltiples cuentas y aplicaciones de X. Se puede instalar fácilmente mediante Homebrew, npm, un script shell o Go. Incluye un modo de endpoint en bruto para realizar peticiones GET y POST directamente a cualquier endpoint de la API de X, con soporte para streaming y personalización de cabeceras. Es especialmente útil para agentes que necesitan interactuar con la plataforma social de forma programática, siempre siguiendo estrictas normas de seguridad para no exponer credenciales ni datos sensibles durante las sesiones automatizadas.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace xurl?

CLI oficial para la API de X.

Repositorio principal: https://github.com/xdevplatform/xurl

Instalación

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

Seguridad

  • Nunca lea, imprima, resuma, cargue ni pegue ~/.xurl en el contexto del LLM.
  • Nunca pida al usuario que pegue secretos de cliente, tokens de portador o tokens OAuth en el chat.
  • Nunca use --verbose en ejecuciones de agentes; puede exponer cabeceras de autenticación.
  • No ejecute comandos de autenticación con banderas secretas en línea en una sesión de agente.
  • El usuario debe registrar las credenciales de la aplicación manualmente en su máquina fuera de la sesión del agente.

Autenticación

Verificar el estado actual:

xurl auth status

Si ya hay una aplicación registrada, completar OAuth 2.0:

xurl auth oauth2

Múltiples aplicaciones:

xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me

Notas:

  • xurl guarda la configuración de la aplicación y los tokens en ~/.xurl.
  • La URI de redirección de OAuth 2.0 en el portal de desarrolladores de X debe ser http://localhost:8080/callback.
  • Los ejemplos de registro de aplicaciones con secretos en línea se omiten intencionalmente aquí. Hágalo fuera de la sesión del agente.

Atajos comunes

xurl post "¡Hola mundo!"
xurl reply 1234567890 "Bonita publicación"
xurl quote 1234567890 "Mi opinión"
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 @usuario
xurl unfollow @usuario
xurl following -n 20
xurl followers -n 20

xurl dm @usuario "mensaje"
xurl dms -n 10

xurl media upload ruta/al/archivo.mp4
xurl media status ID_DEL_MEDIA

POST_ID también puede ser una URL completa de una publicación de X.

Modo de endpoint en bruto

GET:

xurl /2/users/me

POST JSON:

xurl -X POST /2/tweets -d '{"text":"¡Hola mundo!"}'

Cabeceras:

xurl -H "Content-Type: application/json" /2/tweets

Seleccionar tipo de autenticación:

xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me

Seleccionar cuenta OAuth2:

xurl --username alice /2/users/me

Streaming:

xurl /2/tweets/search/stream
xurl -s /2/users/me

Comprobaciones rápidas

Instalación:

xurl version

Autenticación:

xurl auth status

Petición en vivo tras autenticación:

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 relacionados