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.

​
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:

​
3. Autoriza

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:

​
Comandos de acceso rápido

xurl incluye atajos integrados para operaciones comunes:

​
¿Por qué usar xurl?

​
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.

​
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.