MCPInstall

square-post

by binanceMedia & Creative

Use when the user wants to publish new content to Binance Square — short text, multi-image posts (up to 4), long-form articles with an optional cover, or videos with an auto-generated cover frame. Trigger on direct phrasings like "post to Square", "publish to Binance Square", "发广场", "发布到广场", and on near-miss intents where the user clearly wants to share or publish content on Square even without naming the skill: "share this analysis on Square", "把这篇文章发出去", "发个动态", "把这个视频上传到广场", "publish my chart to Square as an article". Also use when the user provides media (images, video) plus a caption and asks to push it to Square, or asks to turn a draft into a Square article. Do not use for reading, searching, commenting, liking, editing, deleting, scheduling, or managing existing Square posts — this skill only creates new posts.

Installs
32.1K
Last 24h
+558
Trending rank
#626
Security
Warn

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/binance/binance-skills-hub --skill square-post
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads square-post automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·The skill is safe. It provides local scripts to publish content to Binance Square using official APIs, employing secure secret management practices and proper execution methods.
Socket Warn1 alert: gptAnomaly
Snyk PassLOW ·Risk: LOW · No issues
Runlayer PassLOW ·2/3 files flagged
ZeroLeaks PassNONE ·Score: 93/100 · 2 sections analyzed

SKILL.md

The instructions your agent reads when the skill is triggered.

Square Post Skill

Purpose

Publish new content to Binance Square by running the local scripts in scripts/.

Supported post types:

  • Text-only short posts
  • Image posts with up to 4 images
  • Long articles with a title and optional cover image
  • Video posts with an auto-generated cover image

Do not hand-code API requests for normal posting. The scripts own upload, polling, cover generation, and publish behavior.

Runtime Dependencies

  • Node.js 18 or newer. The scripts use native ES modules and the built-in fetch API.
  • ffmpeg is required for video posts because post-video.mjs extracts the first frame as the cover image.
  • ffprobe is required when a video duration is not provided by the user.
  • Network access is required for Binance Square OpenAPI requests and presigned media uploads.

Authentication

Posting requires a Binance Square OpenAPI key.

Before posting:

  • Prefer BINANCE_SQUARE_OPENAPI_KEY from the user's environment if present.
  • If it is not present, the scripts automatically check ~/.config/binance-square/openapi-key.
  • If no valid key is found, ask the user to provide an API key first.
  • If the user wants to reuse the key in future requests, save it with BINANCE_SQUARE_OPENAPI_KEY=<apiKey> node scripts/save-key.mjs; otherwise use it only for the current command environment.
  • Tell the user they can create an API key at: https://www.binance.com/square/creator-center/home

Pass the key only via BINANCE_SQUARE_OPENAPI_KEY (env or saved file). Never write it into command arguments or print the full key — CLI args appear in ps output and shell history. When mentioning a key, show only the first 5 and last 4 characters, such as abc12...xyz9.

Scripts

All commands should be run from this skill directory.

Text Or Article Post

Use for text-only short posts or long articles without images.

node scripts/post-text.mjs --text "Hello #crypto $BTC"

Long article with title and no cover:

node scripts/post-text.mjs --text "Full article body..." --title "Market Report"

Flags:

  • --text required, post text content
  • --title optional, sets article-style content

Image Post

Use for short image posts or long articles with a cover image.

node scripts/post-image.mjs --text "Chart analysis" --images "./chart1.png,./chart2.png"

Long article with title and cover:

node scripts/post-image.mjs --text "Full analysis..." --title "Market Report" --cover "./chart.png"

Flags:

  • --text required, post or article content
  • --images required for short image posts only. Use comma-separated image paths with max 4.
  • --title optional, sets article-style content. When present, do not pass --images.
  • --cover required when --title is present for an article with media. Article mode supports exactly one cover image.

The script uploads each image, waits for processing, and publishes with the processed image URL returned by the backend. If --title is provided, it publishes contentType=2, requires --cover, and sends that uploaded image URL as cover only. If no --title is provided, it publishes contentType=1 and sends all --images as imageList.

Video Post

Use for video posts.

node scripts/post-video.mjs --video "./video.mp4" --duration 7.5 --text "My analysis"

Flags:

  • --video required, local video path
  • --duration required, video duration in seconds
  • --text optional, post text content

The script uploads the video, waits for processing, extracts the first frame with ffmpeg, uploads that frame as the cover image, and publishes with cover included in the request.

If the user does not provide a duration, use ffprobe to determine it before running the script.

Agent Workflow

  1. Resolve the API key (see Authentication). If unresolved, stop and ask the user before doing anything else.

  2. Pick the script from user intent using the table below. Then validate against Constraints — if a constraint is violated, explain it and do not run.

    User intentScriptRequired flags
    Short text postpost-text.mjs--text
    Long article, no mediapost-text.mjs--text --title
    Image short post (1–4 imgs, no title)post-image.mjs--text --images "<p1,p2,...>"
    Article with coverpost-image.mjs--text --title --cover
    Video postpost-video.mjs--video --duration (+ optional --text)

  3. Disambiguate edge cases before running:

    • Title + exactly one image → that image is the cover (--cover, not --images).
    • Title + multiple images → stop and ask which single image is the cover.
    • Video without duration → run ffprobe first to get it.

  4. Preserve user content exactly. Do not rewrite, translate, add hashtags/cashtags, or change punctuation. $coin and #topic text passes through verbatim — the backend parses them.

  5. Run the script with BINANCE_SQUARE_OPENAPI_KEY injected into the command environment for one-time use (never as a CLI arg).

  6. Report the result:

    • On success, return the ID and Link printed by the script.
    • If the script prints Success! with ID: unavailable and Link: unavailable, treat it as successful — /content/add returned 504 after submission, so no post ID or link is available.
    • On failure, surface the script error and any API code/message.

Constraints

  • Images: max 4 per post; article cover is exactly 1 image.
  • Video: max 1 per post.
  • Images and video are mutually exclusive in a single post.
  • Only attach media the user explicitly provided; do not auto-attach.
  • Do not modify user-provided text. #topic and $coin are parsed server-side.
  • Daily limits: 100 posts/day, 400 uploads/day.

Common Errors

  • 220003: API key not found.
  • 220004: API key expired.
  • 220009: Daily post limit exceeded for OpenAPI.
  • 220014: Daily upload limit exceeded.
  • 20002 or 20022: Sensitive words detected.
  • 20013: Content length is limited.
  • 20020 or 220011: Content body must not be empty.
  • 30008, 2000001, or 2000002: Account or device posting restriction.

Scope

This skill only supports publishing new posts. It does not support:

  • Reading, listing, or searching existing posts
  • Editing or deleting posts
  • Commenting, liking, or other interactions
  • User profile or account management
  • Scheduling or drafts

FAQ

What does the square-post skill do?

Use when the user wants to publish new content to Binance Square — short text, multi-image posts (up to 4), long-form articles with an optional cover, or videos with an auto-generated cover frame. Trigger on direct phrasings like "post to Square", "publish to Binance Square", "发广场", "发布到广场", and on near-miss intents where the user clearly wants to share or publish content on Square even without naming the skill: "share this analysis on Square", "把这篇文章发出去", "发个动态", "把这个视频上传到广场", "publish my chart to Square as an article". Also use when the user provides media (images, video) plus a caption and asks to push it to Square, or asks to turn a draft into a Square article. Do not use for reading, searching, commenting, liking, editing, deleting, scheduling, or managing existing Square posts — this skill only creates new posts.

How do I install square-post?

Run npx skills add https://github.com/binance/binance-skills-hub --skill square-post in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/square-post/ (personal) or .claude/skills/square-post/ (project).

Which AI agents can use square-post?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is square-post safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket flagged items to review; Snyk passed; Runlayer passed; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains square-post?

It is published by binance in binance/binance-skills-hub. It has 32,146 recorded installs.

More from binance/binance-skills-hub

View all →

binance-agentic-wallet

binance/binance-skills-hub

Use when the user mentions wallet connect/sign in/sign out, check balance, send/transfer tokens, swap/buy/sell tokens, DEX trade, limit/market order, cancel order, get a quote, transaction history, wallet settings, daily limit, slippage, MEV protection, supported chains, send to ENS domain, send to .eth or .bnb name, resolve domain name to address, domain-based transfer, send to .ai Agent ID name, Agent ID claim status, whether I claimed my .ai space id / Agent ID, get my .ai domain, prediction market, place prediction, redeem winnings, prediction PnL, x402 payment, HTTP 402 Payment Required, check/revoke/manage token approvals, DeFi protocols, staking, liquidity pool, LP, yield farming, deposit, redeem, stake, unstake, claim rewards/fees, health factor, APY, TVL, sign external transaction, contract call, sign message, EIP-712, developer mode, speed up/cancel/replace transaction, pending/stuck transactions, gas price, gas fee, network fee, fee levels, gas tiers, or any on-chain wallet

AI & Agents19.6K installs

trading-signal

binance/binance-skills-hub

Per-trade smart-money signals — each result is a discrete buy or sell event from a tracked smart-money wallet, with trigger price, current price, max gain since trigger, and exit rate. BSC and Solana only. Use for: "smart money buy signal on $X", "any whale just bought $Y", "alpha signals in the last hour", "copy-trade-worthy signals", "trigger price and max gain on these trades", "on-chain trading signals from smart money".

Business & Finance10.2K installs

crypto-market-rank

binance/binance-skills-hub

Crypto market leaderboards — ranked aggregate feeds across the whole market: social-hype/sentiment rank, trending / top-search / Binance Alpha / tokenized-stocks rank, smart-money net-inflow rank (which tokens received the most inflow), top meme tokens by breakout score on Pulse launchpad, top trader PnL leaderboard (ALL / KOL). Use whenever the user wants a ranked list of tokens or addresses by some metric — phrases like "trending tokens", "top N by hype", "leaderboard", "rank by X", "biggest inflows", "top traders this week".

Business & Finance9.5K installs

query-token-info

binance/binance-skills-hub

Per-token details for a specific token identified by keyword, symbol, or contract address: (1) search — find tokens by keyword/symbol/contract; (2) meta — static info: name, symbol, logo, social links, creator, official website; (3) dynamic — real-time market data: price, 24h change, volume, holder count, liquidity; (4) kline — OHLCV candlestick data for technical analysis. Use for: "price of $X", "search for token Y", "kline chart for $Z", "who created $W", "social links for $V", "holder count of $U", "candlestick data", "find the contract address of ".

Business & Finance8.3K installs

query-token-audit

binance/binance-skills-hub

Query token security audit to detect scams, honeypots, and malicious contracts before trading. Returns comprehensive security analysis including contract risks, trading risks, and scam detection. Use when users ask "is this token safe?", "check token security", "audit token", or before any swap.

Security8.3K installs

meme-rush

binance/binance-skills-hub

Live launchpad feed + AI hot topics for meme tokens. (1) meme-rush: real-time lifecycle feed on launchpads across Solana, BSC and Base (Pump.fun, Four.meme, Flap, ...) — brand-new launches, currently-finalizing / bonding-curve tokens, and just-migrated-to-DEX tokens; filter by dev behavior, age, market cap, and launchpad sub-type (e.g. Open Four Agent ID exclusive launches — anyone can launch; on the bonding curve only Agent ID holders can buy). (2) topic-rush: AI-detected hot market narratives with the associated tokens ranked by inflow. Use for: "new pump.fun launches", "what just migrated", "currently bonding", "hot narratives", "what topic is pumping right now", "live launchpad feed", "AI hot topics", "Agent ID exclusive launches", "Agent ID exclusive bonding curve", "Open Four".

Marketing & SEO7.9K installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs