Você quer postar no Binance Square sem ter que abrir o app, sem precisar tocar manualmente em cada post? A Binance já tem uma Square OpenAPI oficial, junto com um conjunto de ferramentas square-post no Binance Skills Hub. Este artigo mostra como fazer do zero; mesmo quem não sabe programar ainda consegue seguir. A parte de configuração, salvar a chave e postar o texto do post foi testada na prática antes de eu escrever.
📌 O QUE ESSA FERRAMENTA FAZ
✅ Publicar texto, emoji, quebra de linha
✅ Digitar $BTC, $ETH faz com que eles virem tags de coin com preço
✅ Digitar #hashtag é reconhecido automaticamente
✅ Publicar com no máximo 4 imagens
✅ Publicar texto longo com título e imagem de capa
✅ Publicar vídeo (precisa instalar o ffmpeg adicional)
✅ Retorna o link do post logo após publicar
❌ Não funciona ainda: widget de chart, etiquetas Bullish/Bearish, citar outro post, agendamento, salvar rascunho, editar, excluir, dar like, comentar. Essas coisas ainda precisam ser feitas no app ou no site.
🧰 PASSO 0 — PREPARAÇÃO
• Computador Windows, macOS ou Linux
• Node.js versão 22 ou superior; baixar em nodejs.org
• Conta do Binance Square
Abra o terminal (no Windows, use PowerShell) e digite o comando abaixo para verificar o Node.js:
node -v
Basta ter v22 ou superior.
📥 PASSO 1 — INSTALAR A FERRAMENTA SQUARE-POST
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance/square-post
O instalador vai perguntar qual AI agent usar e onde instalar. Se você quiser instalar direto sem ficar perguntando, adicione ao final do comando:
-a claude-code -y --copy
(--copy ajuda a evitar o erro de symlink que costuma ocorrer no Windows.)
Antes de instalar, o instalador testa a segurança do programa. Depois de instalar, o caminho da pasta da ferramenta é impresso no final; normalmente fica no formato .claude\skills\square-post. Vá para essa pasta:
cd .claude\skills\square-post
Veja a ajuda de cada comando:
node scripts/post-text.mjs --help
node scripts/post-image.mjs --help
🔑 PASSO 2 — CRIAR API KEY
Vá ao Square Creator Center e crie uma OpenAPI key:
https://www.binance.com/square/creator-center/home
⚠️ Esta key tem permissão para publicar por você. Trate como uma senha: não envie para ninguém, não faça screenshot e não cole no código para depois subir na rede.
💾 PASSO 3 — SALVAR A KEY UMA VEZ, E USAR PARA SEMPRE
Windows (PowerShell), execute em sequência 3 linhas:
$env:BINANCE_SQUARE_OPENAPI_KEY = 'cole-a-key-aqui'; node scripts/save-key.mjs Remove-Item Env:BINANCE_SQUARE_OPENAPI_KEY
macOS / Linux:
BINANCE_SQUARE_OPENAPI_KEY='cole-a-key-aqui'; node scripts/save-key.mjs
Se aparecer a linha “Saved Square OpenAPI key abc12...xyz9”, acabou. A key fica salva na pasta .config/binance-square dentro da pasta do seu usuário; nas próximas vezes não precisa digitar novamente.
A ferramenta propositalmente não permite passar a key por parâmetro --key, para que a key não fique salva no histórico de comandos. O design foi bem cuidadoso 👍
⚠️ PASSO 4 — ERRO DO INICIANTE MAIS COMUM
Sempre coloque o conteúdo do post ENTRE ASPAS SIMPLES '...'.
Se usar aspas duplas, o terminal vai entender $BTC como o nome de uma variável e ele some:
• Aspas duplas → o post sai: Hello
• Aspas simples 'Hello $BTC' → o post sai: Hello $BTC
Eu tentei no PowerShell. Por exemplo, o texto original na documentação usa aspas duplas, então muita gente tropeça nisso.
✍️ PASSO 5 — PUBLICAR TEXTO
node scripts/post-text.mjs --text '$BTC está segurando a zona de suporte no timeframe de 1h 📊 #BTC. Não é conselho financeiro.'
Se der certo, vai aparecer:
Sucesso!
ID: 36788...
Link: https://app.binance.com/...
Abrindo o link, dá para ver o post. $BTC vira tag de coin e #BTC vira hashtag.
🖼 PASSO 6 — PUBLICAR COM IMAGEM
node scripts/post-image.mjs --text 'Análise de $ETH no timeframe de 4h #ETH' --images './chart1.png,./chart2.png'
• No máximo 4 imagens; as imagens separadas por vírgula
• A ferramenta faz upload de cada imagem automaticamente; espere o Binance processar tudo antes de publicar
📰 PASSO 7 — TEXTO LONGO COM TÍTULO
Sem imagem:
node scripts/post-text.mjs --title 'Relatório do mercado semanal' --text 'Conteúdo do texto longo...'
Tem imagem de capa:
node scripts/post-image.mjs --title 'Relatório do mercado semanal' --text 'Conteúdo...' --cover './cover.png'
O texto longo aceita APENAS UMA imagem de capa; transmita via --cover, e não use --images.
🎬 PASSO 8 — PUBLICAR VÍDEO (OPCIONAL)
Você precisa instalar o ffmpeg antes. Se você não souber a duração do vídeo, precisa também de ffprobe.
node scripts/post-video.mjs --video './video.mp4' --duration 7.5 --text 'Resumo do mercado de hoje'
A ferramenta corta automaticamente o primeiro frame para virar a imagem de capa.
🤖 PASSO 9 — PARA O AI AGENT PUBLICAR
Se você estiver usando Claude Code ou OpenClaw, não precisa lembrar nenhum comando; basta dizer algo como:
Publique no Binance Square: 'Leitura rápida $SOL no timeframe de 1h #SOL' junto com a imagem chart.png
O agent vai escolher automaticamente o comando certo e devolver o link do post. De acordo com a instrução da ferramenta, o agent deve manter exatamente o conteúdo que você escreveu; não deve adicionar hashtags nem ajustar as frases.
🚦 LIMITAÇÕES E ERROS MAIS COMUNS
Limite: 100 posts por dia, 400 uploads de imagens por dia.
• 220003 — a key não existe; verifique a key novamente
• 220004 — a key expirou; crie uma nova
• 220009 — passou de 100 posts no dia
• 220014 — passou de 400 uploads no dia
• 220011 — conteúdo está vazio
• 20002 / 20022 — conteúdo relacionado a assuntos sensíveis
• 20013 — conteúdo está muito longo
• 30008 — conta ou dispositivo está com restrição de publicar
💡 Veja “Success!” mas “ID: unavailable” significa que o post JÁ foi publicado; só não foi possível obter o código do post. Não execute o comando de novo para evitar postar em duplicidade.
🛡 USE APENAS O CORRETO PARA NÃO SER BLOQUEADO
• 100 posts/dia é um limite técnico, não um número “certo” para seguir; publicar em excesso facilmente é considerado spam.
• O conteúdo ainda precisa seguir as regras da comunidade do Binance Square. Posts sobre trading devem deixar claro que não é conselho de investimento.
• Se a key vazar, crie uma nova imediatamente e apague o arquivo de key antigo.
• Leia primeiro o arquivo SKILL.md antes de usar, porque a ferramenta roda com as permissões do AI agent.
📚 Fonte oficial: github.com/binance/binance-skills-hub (pasta skills/binance/square-post)
Se você estiver travado em algum passo, deixe um comentário que eu respondo 👇
#BinanceSquare #SquareOpenAPI #CryptoTools
O texto é para orientação técnica, não é conselho de investimento.