square-post Skill for Claude: What It Does and How to Install It
Lets Claude publish new posts, articles and videos to Binance Square from your machine.
- Installs
- 35.1K
- on skills.sh
- Stars
- 1.1K
- on GitHub
- Files
- 6
- besides SKILL.md
- Updated
- Oct 2026
- last repo commit
square-post makes Claude publish to Binance Square by running local Node scripts. It handles four kinds of post: short text, up to four images, long articles with an optional cover, and videos with an auto-made cover frame. It only creates new posts.
It needs a Binance Square OpenAPI key, Node 18 or newer, and ffmpeg for video. Claude is told to keep your text exactly as written and never to put the key on the command line.
Good for
- Creators who publish market notes or charts to Binance Square
- Teams that want a draft-to-post flow driven by Claude
- Anyone who already has a Square OpenAPI key
Install square-post
Claude Code
- 1
Copy this prompt.
Install the square-post skill in Claude Code. Run this command: npx skills add https://github.com/binance/binance-skills-hub --skill square-post Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
From its listing on skills.sh. Source.
What's in the skill
When it loads
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.
Sections in SKILL.md
- Purpose
- Runtime Dependencies
- Authentication
- Scripts
- Text Or Article Post
- Image Post
- Video Post
- Agent Workflow
- Constraints
- Common Errors
- Scope
Key facts
- Repository
- binance/binance-skills-hub
- Installs on skills.sh
- 35,097 as of 2026-11-02
- License
- Not stated in SKILL.md or the crawl data
- Last commit to the repo
- 2026-10-26
- What is inside
- 7 files including SKILL.md: README.md and 5 Node scripts (lib, post-text, post-image, post-video, save-key)
- Version
- 2.0.0 (SKILL.md metadata)
- Daily limits
- 100 posts per day and 400 uploads per day
- skills.sh audits
- Gen Agent Trust Hub pass, Socket warn, Snyk pass
What it includes
Short text post, or a long article with a title and no cover
Takes --text and an optional --title. With a title it publishes an article.
Try: “Post "BTC holding above support" to Binance Square.”
Runs code ·
scripts/post-text.mjsImage post with up to 4 images, or an article with a cover
Uploads each image, waits for processing, then publishes. An article takes exactly one cover. Title plus several images makes Claude ask which one is the cover.
Runs code ·
scripts/post-image.mjsVideo post with a cover frame from the first frame
Needs --video and --duration. It runs ffmpeg to extract the first frame, uploads video and cover, then publishes. Claude uses ffprobe for the duration if you do not give one.
Runs code ·
scripts/post-video.mjsSave your OpenAPI key to a private file
Run only if you want to reuse the key. It writes ~/.config/binance-square/openapi-key with 0600 permissions, per the README.
Runs code ·
scripts/save-key.mjsResolve key, pick script, check limits, run, report
Claude stops and asks for a key if none is found, validates the constraints, then returns the post ID and link. A 504 on publish is treated as success without an ID.
Read ·
Agent workflowCodes such as 220003 key not found and 220009 daily limit
The SKILL.md lists API codes for key, limit, sensitive-word, empty-content and account-restriction failures.
Read ·
Common errors
From the official docs
Permissions
High risk
Claude runs local scripts that publish public posts to your Binance Square account with your OpenAPI key, and upload the files you name. The skill cannot edit or delete a post afterward, so check the post text and media before approving each run.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Posts are public and this skill cannot undo them
A run publishes to your Binance Square account and the post goes live. The skill only creates posts; its Scope section lists editing and deleting as unsupported, so removing a post means doing it yourself in Binance. Review the text and the file list in the command before you approve it. github.com
Your local files are uploaded to Binance
Images and videos named in the command are uploaded to presigned URLs. Only name files you mean to publish. github.com
The key is kept in a file if you save it
The scripts reject --key so the key does not land in shell history. Use the env var for one-off runs and delete the saved file when you are done. github.com
Video posts run ffmpeg and use a temp folder
The script makes a temporary folder for the cover frame and removes the cover file after upload. github.com
Technical details
| Turning on read-only | No read-only switch is documented in SKILL.md. |
|---|---|
| Talks to | www.binance.com Square OpenAPI endpoints. Presigned upload URLs returned by the API |
| Sign-in and keys | The key comes from an environment variable or a saved file. The README says the saved file is written with 0600 permissions and can be removed by deleting it. |
| Scopes |
|
Questions
What does square-post do?
It lets Claude publish new content to Binance Square: text, image posts, articles and videos. It runs bundled Node scripts and does not read, edit, delete or schedule existing posts.
How do I install square-post?
Use the install box at the top of this page. Then create a Square OpenAPI key in the Binance creator center and make it available as BINANCE_SQUARE_OPENAPI_KEY.
Where is my API key stored?
Claude reads BINANCE_SQUARE_OPENAPI_KEY from your environment first, then a saved file at ~/.config/binance-square/openapi-key. Saving it is optional and uses a script that writes the file with 0600 permissions.
Is square-post safe to use?
Treat it as a tool that posts publicly for you. It publishes under your Binance Square account and uploads the files you name, and the skill has no edit or delete command, so check the text and media before Claude runs a script. The skill says to keep your wording unchanged, and the hub README advises scoping the key to the permissions needed and limiting it to the agent's IP address.
Can it edit or delete a post?
No. The SKILL.md says it only creates new posts. It does not read, search, comment, like, edit, delete or schedule.
What are the limits?
Up to 4 images per post, one cover for an article, one video per post, and images and video cannot be mixed. Daily limits are 100 posts and 400 uploads.
Does it give trading advice?
No. The Binance Skills Hub README says the hub is an informational tool, not investment advice, and that AI-generated content can contain errors. This skill is told to publish your text unchanged.
Information
updated Nov 2, 2026
- Repository
- binance/binance-skills-hub
- Folder
skills/binance/square-post
Sources
Docs, issue trackers and discussions this page is built from.
Show all 5Hide
- square-post SKILL.md · github.com
- square-post README · github.com
- binance-skills-hub README · github.com
- lib.mjs · github.com
- post-video.mjs · github.com