Skip to content

Home

Jump to bottom
XyrenExo edited this page Apr 9, 2026 · 1 revision

Binance Square Automator Wiki

Welcome to the Binance Square Automator wiki. This project is a full-stack solution designed to streamline the process of researching, generating, and scheduling high-quality financial content for Binance Square using Google's Gemini AI.

📖 Table of Contents

  1. Introduction
  2. Core Features
  3. Technical Architecture
  4. Getting Started
  5. Usage Guide
  6. Security & Privacy
  7. Deployment

🚀 Introduction

The Binance Square Automator bridges the gap between complex market data and engaging social content. By leveraging the Gemini 3 Flash model with integrated Google Search, the app can pull real-time market insights and transform them into professional posts tailored for the Binance Square audience.

✨ Core Features

  • AI-Powered Research: Automatically gather the latest news, price action, and sentiment for any crypto asset using Gemini's search capabilities.
  • Smart Content Generation: Generate posts that follow financial social media best practices, including relevant hashtags and professional formatting.
  • Automated Scheduling: Plan your content strategy in advance. The built-in cron engine handles publishing at your specified time.
  • Local Persistence: Uses a lightweight JSON-based database to store your schedules securely on your own server.
  • Binance Integration: Direct (proxied) connection to Binance Square for seamless posting.

🏗 Technical Architecture

The app is built as a Full-Stack TypeScript application:

  • Frontend: React 18 + Vite + Tailwind CSS + shadcn/ui.
  • Backend: Express.js server handling API requests and cron jobs.
  • AI Engine: @google/genai SDK for content research and generation.
  • Automation: node-cron for managing scheduled tasks.
  • Database: Local schedules.json for persistent storage without external dependencies.

🛠 Getting Started

Prerequisites

  • Node.js 22+
  • A Gemini API Key (from Google AI Studio)
  • Binance API Key & Secret (with Content Creator permissions)

Installation

  1. Clone the repository.
  2. Install dependencies: npm install.
  3. Create a .env file and add GEMINI_API_KEY=your_key.
  4. Start the development server: npm run dev.

📝 Usage Guide

1. Configuration

Navigate to the Settings tab. Enter your Binance API credentials and your Gemini API key. These are stored in your browser's localStorage for security.

2. Generating Content

  • Go to the Post Generator.
  • Enter a topic (e.g., "Solana Ecosystem Growth").
  • Click Gather to let Gemini research the latest data.
  • Click Generate Post to create the final draft.

3. Scheduling

  • Review your post in the preview pane.
  • Click Schedule, select a date/time, and confirm.
  • Monitor your pending posts in the Schedule tab.

🔒 Security & Privacy

  • Client-Side Secrets: Your Binance API keys and Gemini keys are stored in your browser's local storage. They are only sent to the server during active requests and are never stored permanently on the server's disk.
  • No Third-Party Tracking: The app is self-contained. Your data stays on your server and in your browser.

🚢 Deployment

The project includes a Dockerfile and docker-compose.yml for easy deployment to providers like Linode, DigitalOcean, or AWS.

Refer to the Deployment Guide for step-by-step instructions on setting up a production environment with Nginx and SSL.

Clone this wiki locally