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. 
go install github.com/xdevplatform/xurl@latest

​
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: 
export CLIENT_ID="your-x-app-client-id"
export CLIENT_SECRET="your-x-app-client-secret"

​
3. Autorize

xurl auth oauth2
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: 
# Consultar um usuário
xurl /2/users/by/username/xdevelopers

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

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

​
Comandos de atalho

O xurl inclui atalhos integrados para operações comuns: 
# Consultar um usuário por username
xurl user xdevelopers

# Buscar posts recentes
xurl search "X API"

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

​
Por que usar o xurl?

Recursocurlxurl
AutenticaçãoConfiguração manual do cabeçalho OAuthAutomática — basta executar xurl auth uma vez
Gerenciamento de tokensVocê lida com refresh/rotaçãoArmazenamento e refresh de tokens integrados
Atalhos de APIURL completa obrigatóriaComandos abreviados para tarefas comuns
Assinatura de requisiçõesAssinatura OAuth 1.0a manualAutomática para todas as requisições

​
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. 
npx skills add https://github.com/xdevplatform/xurl

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