Skip to main content
xurl é uma ferramenta de linha de comando parecida com o curl para a X API. Ela cuida da autenticação OAuth automaticamente, para que você possa fazer requisições à API sem gerenciar tokens ou assinar requisições manualmente.

Repositório no GitHub

Código-fonte, releases e documentação.

​
Instalação

Instale com Go ou baixe um binário pré-compilado nas releases.

​
Configuração

​
1. Crie um app X

O xurl se autentica usando o seu próprio app de desenvolvedor. No Portal do Desenvolvedor X:
  1. Crie (ou abra) um app com OAuth 2.0 habilitado.
  2. Registre o redirect URI http://localhost:8080/callback no app.
  3. Copie o Client ID e o Client Secret do app na página “Keys and tokens”.

​
2. Defina suas credenciais

Exporte as credenciais no mesmo shell em que você vai executar o xurl:

​
3. Autorize

Isso abre um fluxo OAuth pelo navegador. Uma vez autorizado, o xurl armazena seus tokens localmente em ~/.xurl, então você não precisa se autenticar novamente.
Se o navegador mostrar “Something went wrong — You weren’t able to give access to the App”, o xurl iniciou o login sem credenciais válidas. Certifique-se de que CLIENT_ID e CLIENT_SECRET estejam exportados no shell onde você executou xurl auth oauth2, e de que http://localhost:8080/callback esteja registrado como redirect URI no seu app.

​
Uso

​
Requisições brutas à API

Use o xurl como o curl — ele cuida dos cabeçalhos de auth automaticamente:

​
Comandos de atalho

O xurl inclui atalhos integrados para operações comuns:

​
Por que usar o xurl?

​
Usando o xurl com agentes de IA

O xurl inclui um arquivo SKILL.md que descreve suas capacidades em formato legível por máquina. Agentes de IA podem usá-lo para entender como invocar comandos do xurl em seu nome.

​
Relacionados

Faça sua primeira requisição

Comece a usar a X API com cURL ou SDKs.

API Playground

Teste endpoints localmente com dados mock — sem gastar créditos da API.