> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# xurl — cliente de línea de comandos estilo curl para la X API

> Instala y usa xurl, una CLI estilo curl para la X API con OAuth integrado que te permite probar endpoints, firmar solicitudes y hacer prototipos desde la terminal.

[xurl](https://github.com/xdevplatform/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.

<Card title="Repositorio de GitHub" icon="github" href="https://github.com/xdevplatform/xurl">
  Código fuente, releases y documentación.
</Card>

***

## Instalación

Instala con Go, o descarga un binario precompilado desde [releases](https://github.com/xdevplatform/xurl/releases).

```bash theme={null}
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](https://developer.x.com):

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:

```bash theme={null}
export CLIENT_ID="your-x-app-client-id"
export CLIENT_SECRET="your-x-app-client-secret"
```

### 3. Autoriza

```bash theme={null}
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.

<Warning>
  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.
</Warning>

***

## Uso

### Solicitudes crudas a la API

Usa xurl como curl — se encarga de los headers de autenticación automáticamente:

```bash theme={null}
# 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:

```bash theme={null}
# 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ística           | curl                                  | xurl                                          |
| :----------------------- | :------------------------------------ | :-------------------------------------------- |
| **Autenticación**        | Configuración manual del header OAuth | Automática — solo ejecuta `xurl auth` una vez |
| **Gestión de tokens**    | Tú manejas el refresh/rotación        | Almacenamiento y refresh de tokens integrados |
| **Atajos de API**        | URL completa requerida                | Comandos abreviados para tareas comunes       |
| **Firma de solicitudes** | Firma OAuth 1.0a manual               | Automática para todas las solicitudes         |

***

## Uso de xurl con agentes de IA

xurl incluye un archivo [`SKILL.md`](https://github.com/xdevplatform/xurl/blob/main/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.

```bash theme={null}
npx skills add https://github.com/xdevplatform/xurl
```

***

## Relacionado

<CardGroup cols={2}>
  <Card title="Haz tu primera solicitud" icon="rocket" href="/make-your-first-request">
    Comienza a usar la X API con cURL o SDKs.
  </Card>

  <Card title="API Playground" icon="flask" href="https://github.com/xdevplatform/playground">
    Prueba endpoints localmente con datos simulados — sin gastar créditos de la API.
  </Card>
</CardGroup>