CommunityEscrita e Ediçãogithub.com

steipete/xurl

CLI oficial da API do X: instalação, autenticação, seleção de app, atalhos e endpoints brutos.

O que é xurl?

O xurl é uma ferramenta de linha de comando oficial para a API do X (antigo Twitter), que permite que desenvolvedores e agentes de IA interajam com a plataforma diretamente do terminal. Ele suporta instalação via Homebrew, npm, script shell ou Go, e oferece uma ampla variedade de comandos de atalho para ações comuns como postar, responder, curtir, repostar, seguir, enviar mensagens diretas e gerenciar mídia. Também inclui um modo de endpoint bruto para chamadas GET, POST e streaming, com suporte a múltiplos métodos de autenticação (OAuth 1.0a, OAuth 2.0 e app-only). A segurança é uma prioridade: orienta que tokens e credenciais nunca devem ser expostos em contexto de LLM, e recomenda que comandos de autenticação com segredos explícitos sejam executados fora da sessão do agente. Ideal para automação, integração com ferramentas de terminal e desenvolvimento de aplicações que consomem dados do X.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/xurl

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 ~/.xurl no 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 --verbose em 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 xurl armazena 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas