O que xurl faz?
CLI oficial para a API do X.
Repositório primário: https://github.com/xdevplatform/xurl
Instalação
Homebrew:
brew install --cask xdevplatform/tap/xurl
npm:
npm install -g @xdevplatform/xurl
Script shell:
curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
Go:
go install github.com/xdevplatform/xurl@latest
Segurança
- Nunca leia, imprima, resuma, envie ou cole
~/.xurlno contexto do LLM. - Nunca peça ao usuário para colar chaves secretas do cliente, tokens de portador ou tokens OAuth no chat.
- Nunca use
--verboseem execuções de agente; isso pode expor cabeçalhos de autenticação. - Não execute comandos de autenticação com flags secretas inline em uma sessão de agente.
- O usuário deve registrar as credenciais do aplicativo manualmente em sua máquina, fora da sessão do agente.
Autenticação
Verifique o estado atual:
xurl auth status
Se um aplicativo já estiver registrado, complete o OAuth 2.0:
xurl auth oauth2
Multi-app:
xurl auth apps list
xurl auth default meu-app
xurl auth default meu-app alice
xurl --app dev-app /2/users/me
Notas:
- O
xurlarmazena a configuração do aplicativo e tokens em~/.xurl. - A URI de redirecionamento OAuth 2.0 no portal do desenvolvedor do X deve ser
http://localhost:8080/callback. - Exemplos de registro de aplicativo com segredos inline foram intencionalmente omitidos aqui. Faça isso fora da sessão do agente.
Atalhos comuns
xurl post "Olá mundo!"
xurl reply 1234567890 "Belo post"
xurl quote 1234567890 "Minha opinião"
xurl delete 1234567890
xurl read 1234567890
xurl search "from:elonmusk" -n 10
xurl whoami
xurl user @XDevelopers
xurl timeline -n 20
xurl mentions -n 10
xurl like 1234567890
xurl unlike 1234567890
xurl repost 1234567890
xurl unrepost 1234567890
xurl bookmark 1234567890
xurl unbookmark 1234567890
xurl bookmarks -n 10
xurl likes -n 10
xurl follow @handle
xurl unfollow @handle
xurl following -n 20
xurl followers -n 20
xurl dm @handle "mensagem"
xurl dms -n 10
xurl media upload caminho/para/arquivo.mp4
xurl media status MEDIA_ID
POST_ID também pode ser uma URL completa de um status do X.
Modo de endpoint bruto
GET:
xurl /2/users/me
POST JSON:
xurl -X POST /2/tweets -d '{"text":"Olá mundo!"}'
Cabeçalhos:
xurl -H "Content-Type: application/json" /2/tweets
Escolha o tipo de autenticação:
xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me
Escolha a conta OAuth2:
xurl --username alice /2/users/me
Streaming:
xurl /2/tweets/search/stream
xurl -s /2/users/me
Verificações rápidas
Instalação:
xurl version
Autenticação:
xurl auth status
Requisição ao vivo após autenticação:
xurl whoami