612 Ceros

Bạn muốn đăng bài lên Binance Square mà không phải mở app, không phải bấm tay từng bài? Binance đã có Square OpenAPI chính thức, kèm bộ công cụ square-post trên Binance Skills Hub. Bài này hướng dẫn từ con số 0, người chưa biết lập trình vẫn làm theo được. Phần cài đặt, lưu key và đăng bài chữ mình đã chạy thử thực tế trước khi viết.
📌 CÔNG CỤ NÀY LÀM ĐƯỢC GÌ
✅ Đăng bài chữ, emoji, xuống dòng
✅ Gõ $BTC, $ETH là tự thành tag coin có giá
✅ Gõ #hashtag là tự được nhận diện
✅ Đăng kèm tối đa 4 ảnh
✅ Đăng bài dài có tiêu đề và ảnh bìa
✅ Đăng video (cần cài thêm ffmpeg)
✅ Trả về link bài ngay sau khi đăng
❌ Chưa làm được: widget chart, nhãn Bullish/Bearish, quote bài khác, hẹn giờ, lưu nháp, sửa, xoá, like, comment. Mấy việc này vẫn phải làm trên app hoặc web.
🧰 BƯỚC 0 — CHUẨN BỊ
• Máy tính Windows, macOS hoặc Linux
• Node.js bản 22 trở lên, tải tại nodejs.org
• Tài khoản Binance Square
Mở terminal (Windows dùng PowerShell) và gõ lệnh sau để kiểm tra Node.js:
node -v
Ra v22 trở lên là được.
📥 BƯỚC 1 — CÀI CÔNG CỤ SQUARE-POST
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance/square-post
Trình cài sẽ hỏi bạn chọn AI agent và nơi cài đặt. Muốn cài một mạch không bị hỏi thì thêm vào cuối lệnh:
-a claude-code -y --copy
(--copy giúp tránh lỗi symlink hay gặp trên Windows.)
Trước khi cài, trình cài còn tự chấm điểm bảo mật cho công cụ. Cài xong, đường dẫn thư mục công cụ được in ở cuối, thường có dạng .claude\skills\square-post. Di chuyển vào thư mục đó:
cd .claude\skills\square-post
Thử xem hướng dẫn của từng lệnh:
node scripts/post-text.mjs --help
node scripts/post-image.mjs --help
🔑 BƯỚC 2 — TẠO API KEY
Vào Square Creator Center và tạo OpenAPI key:
https://www.binance.com/square/creator-center/home
⚠️ Key này có quyền đăng bài thay bạn. Hãy coi nó như mật khẩu: không gửi cho ai, không chụp màn hình, không dán vào code rồi đưa lên mạng.
💾 BƯỚC 3 — LƯU KEY MỘT LẦN, DÙNG MÃI
Windows (PowerShell), chạy lần lượt 3 dòng:
$env:BINANCE_SQUARE_OPENAPI_KEY = 'dán-key-vào-đây'; node scripts/save-key.mjs Remove-Item Env:BINANCE_SQUARE_OPENAPI_KEY
macOS / Linux:
BINANCE_SQUARE_OPENAPI_KEY='dán-key-vào-đây'; node scripts/save-key.mjs
Thấy dòng “Saved Square OpenAPI key abc12...xyz9” là xong. Key được lưu trong thư mục .config/binance-square nằm trong thư mục người dùng của bạn, những lần sau không cần nhập lại.
Công cụ cố tình không cho truyền key bằng tham số --key, để key không bị lưu trong lịch sử lệnh. Thiết kế rất cẩn thận 👍
⚠️ BƯỚC 4 — LỖI NGƯỜI MỚI HAY MẮC NHẤT
Luôn đặt nội dung bài trong NHÁY ĐƠN '...'.
Nếu dùng nháy kép, terminal sẽ hiểu $BTC là tên một biến và xoá mất nó:
• Nháy kép → bài đăng ra: Hello
• Nháy đơn 'Hello $BTC' → bài đăng ra: Hello $BTC
Mình đã thử thật trên PowerShell. Ví dụ gốc trong tài liệu dùng nháy kép, nên rất nhiều người sẽ vấp chỗ này.
✍️ BƯỚC 5 — ĐĂNG BÀI CHỮ
node scripts/post-text.mjs --text '$BTC đang giữ vùng hỗ trợ khung 1h 📊 #BTC Not financial advice.'
Thành công sẽ hiện:
Success!
ID: 36788...
Link: https://app.binance.com/...
Mở link là thấy bài. $BTC đã thành tag coin, #BTC đã thành hashtag.
🖼 BƯỚC 6 — ĐĂNG BÀI CÓ ẢNH
node scripts/post-image.mjs --text 'Phân tích $ETH khung 4h #ETH' --images './chart1.png,./chart2.png'
• Tối đa 4 ảnh, các ảnh ngăn cách bằng dấu phẩy
• Công cụ tự upload từng ảnh, đợi Binance xử lý xong rồi mới đăng
📰 BƯỚC 7 — BÀI DÀI CÓ TIÊU ĐỀ
Không có ảnh:
node scripts/post-text.mjs --title 'Báo cáo thị trường tuần' --text 'Nội dung bài dài...'
Có ảnh bìa:
node scripts/post-image.mjs --title 'Báo cáo thị trường tuần' --text 'Nội dung...' --cover './cover.png'
Bài dài chỉ nhận đúng MỘT ảnh bìa, truyền qua --cover chứ không dùng --images.
🎬 BƯỚC 8 — ĐĂNG VIDEO (TUỲ CHỌN)
Cần cài ffmpeg trước. Nếu không biết thời lượng video thì cần thêm ffprobe.
node scripts/post-video.mjs --video './video.mp4' --duration 7.5 --text 'Tóm tắt thị trường hôm nay'
Công cụ tự cắt khung hình đầu tiên làm ảnh bìa.
🤖 BƯỚC 9 — ĐỂ AI AGENT ĐĂNG HỘ
Nếu bạn dùng Claude Code hoặc OpenClaw, không cần nhớ lệnh nào, chỉ cần nói kiểu:
Post to Binance Square: 'Nhận định nhanh $SOL khung 1h #SOL' kèm ảnh chart.png
Agent sẽ tự chọn đúng lệnh và trả về link bài. Theo hướng dẫn của công cụ, agent phải giữ nguyên nội dung bạn viết, không tự thêm hashtag hay sửa câu chữ.
🚦 GIỚI HẠN VÀ LỖI THƯỜNG GẶP
Giới hạn: 100 bài mỗi ngày, 400 lượt upload ảnh mỗi ngày.
• 220003 — key không tồn tại, kiểm tra lại key
• 220004 — key hết hạn, tạo key mới
• 220009 — đã quá 100 bài trong ngày
• 220014 — đã quá 400 lượt upload trong ngày
• 220011 — nội dung đang rỗng
• 20002 / 20022 — nội dung dính từ nhạy cảm
• 20013 — nội dung quá dài
• 30008 — tài khoản hoặc thiết bị đang bị hạn chế đăng bài
💡 Thấy “Success!” nhưng “ID: unavailable” nghĩa là bài ĐÃ lên rồi, chỉ là không lấy được mã bài. Đừng chạy lại lệnh, kẻo bị đăng trùng.
🛡 DÙNG CHO ĐÚNG ĐỂ KHÔNG BỊ KHOÁ
• 100 bài/ngày là giới hạn kỹ thuật, không phải con số nên đăng. Đăng dày đặc rất dễ bị coi là spam.
• Nội dung vẫn phải theo quy tắc cộng đồng của Binance Square. Bài về giao dịch nên ghi rõ không phải lời khuyên đầu tư.
• Lỡ lộ key thì tạo key mới ngay và xoá file key cũ.
• Đọc qua file SKILL.md trước khi dùng, vì công cụ chạy với quyền của AI agent.
📚 Nguồn chính thức: github.com/binance/binance-skills-hub (thư mục skills/binance/square-post)
Bạn kẹt ở bước nào cứ để lại bình luận, mình sẽ trả lời 👇
#BinanceSquare #SquareOpenAPI #CryptoTools
Bài viết mang tính hướng dẫn kỹ thuật, không phải lời khuyên đầu tư.