Skip to main content
xurl es una herramienta de línea de comandos estilo curl para la X API. Se encarga automáticamente de la autenticación OAuth para que puedas hacer solicitudes a la API sin gestionar tokens ni firmar solicitudes manualmente.

Repositorio de GitHub

Código fuente, releases y documentación.

​
Instalación

Instala con Go, o descarga un binario precompilado desde releases. 
go install github.com/xdevplatform/xurl@latest

​
Configuración

​
1. Crea una app de X

xurl se autentica usando tu propia app de desarrollador. En el X Developer Portal:
  1. Crea (o abre) una app con OAuth 2.0 habilitado.
  2. Registra la URI de redirección http://localhost:8080/callback en la app.
  3. Copia el Client ID y el Client Secret de la app desde la página “Keys and tokens”.

​
2. Configura tus credenciales

Exporta las credenciales en la misma shell desde la que ejecutarás xurl: 
export CLIENT_ID="your-x-app-client-id"
export CLIENT_SECRET="your-x-app-client-secret"

​
3. Autoriza

xurl auth oauth2
Esto abre un flujo de OAuth en el navegador. Una vez autorizado, xurl almacena tus tokens localmente en ~/.xurl para que no necesites autenticarte de nuevo.
Si el navegador muestra “Something went wrong — You weren’t able to give access to the App”, xurl inició el login sin credenciales válidas. Asegúrate de que CLIENT_ID y CLIENT_SECRET estén exportados en la shell donde ejecutaste xurl auth oauth2, y de que http://localhost:8080/callback esté registrado como URI de redirección en tu app.

​
Uso

​
Solicitudes crudas a la API

Usa xurl como curl — se encarga de los headers de autenticación automáticamente: 
# Consultar un usuario
xurl /2/users/by/username/xdevelopers

# Buscar posts recientes
xurl "/2/tweets/search/recent?query=from:xdevelopers&max_results=10"

# Crear un post
xurl -X POST /2/tweets -d '{"text": "Hello from xurl!"}'

​
Comandos de acceso rápido

xurl incluye atajos integrados para operaciones comunes: 
# Consultar un usuario por nombre de usuario
xurl user xdevelopers

# Buscar posts recientes
xurl search "X API"

# Publicar un tweet
xurl post "Hello from xurl!"

​
¿Por qué usar xurl?

Característicacurlxurl
AutenticaciónConfiguración manual del header OAuthAutomática — solo ejecuta xurl auth una vez
Gestión de tokensTú manejas el refresh/rotaciónAlmacenamiento y refresh de tokens integrados
Atajos de APIURL completa requeridaComandos abreviados para tareas comunes
Firma de solicitudesFirma OAuth 1.0a manualAutomática para todas las solicitudes

​
Uso de xurl con agentes de IA

xurl incluye un archivo SKILL.md que describe sus capacidades en un formato legible por máquina. Los agentes de IA pueden usarlo para entender cómo invocar los comandos de xurl en tu nombre. 
npx skills add https://github.com/xdevplatform/xurl

​
Relacionado

Haz tu primera solicitud

Comienza a usar la X API con cURL o SDKs.

API Playground

Prueba endpoints localmente con datos simulados — sin gastar créditos de la API.