BNBot - Control Twitter/X via AI

BNBot operates through a real browser session via Chrome Extension. 40+ CLI tools for posting, engagement, scraping, user profiles, content fetching, articles, and job searching.

• Chrome Extension: Install
• npm: bnbot-cli

First-time setup (run once after install)

After bnbot-cli is installed, start the WebSocket daemon:

nohup bnbot serve > /tmp/bnbot.log 2>&1 &
sleep 1
lsof -i :18900 -P 2>/dev/null | grep LISTEN

Confirm port 18900 is LISTEN before proceeding.

Before using any bnbot tool

Check if the daemon is still running:

lsof -i :18900 -P 2>/dev/null | grep LISTEN

If empty, restart it:

nohup bnbot serve > /tmp/bnbot.log 2>&1 &

How to use tools

All tools are executed via the bnbot CLI:

bnbot get-extension-status
bnbot post-tweet --text "Hello world!"
bnbot scrape-timeline --limit 10

Output is JSON.

Auto-thread for multiple images: When post-tweet receives more than 4 images (Twitter's limit), it automatically splits into a thread — first tweet gets the text + first 4 images, subsequent tweets get remaining images in batches of 4. You don't need to manually use post-thread for this.

Media support: Parameters like --media, --image, --headerImage, --bodyImages accept both local file paths (~/Downloads/image.png) and URLs (https://example.com/image.jpg). Files are auto-converted to base64 before sending.

If extension is not connected

If bnbot get-extension-status shows connected: false, tell the user:

> Chrome Extension is not connected. Please:

> 1. Install extension: https://chromewebstore.google.com/detail/bnbot-your-ai-growth-agen/haammgigdkckogcgnbkigfleejpaiiln

> 2. Open https://x.com in Chrome

> 3. Open BNBot sidebar → Settings → turn on OpenClaw

Available CLI commands

Status

• bnbot get-extension-status — Check if extension is connected
• bnbot get-current-page-info — Get current Twitter/X page info

Navigation

• bnbot navigate-to-tweet --tweetUrl
• bnbot navigate-to-search [--query "..."] [--sort top|latest|people|media]
• bnbot navigate-to-bookmarks
• bnbot navigate-to-notifications
• bnbot navigate-to-following
• bnbot return-to-timeline

Posting

• bnbot post-tweet --text "..." [--media file1.png file2.jpg] [--draftOnly]
• bnbot post-thread --tweets '[{"text":"..."},{"text":"..."}]'
• bnbot submit-reply --text "..." [--tweetUrl ] [--image ]
• bnbot quote-tweet --tweetUrl --text "..." [--media ...] [--draftOnly]

Engagement

• bnbot like-tweet [--tweetUrl ]
• bnbot unlike-tweet [--tweetUrl ]
• bnbot retweet [--tweetUrl ]
• bnbot unretweet [--tweetUrl ]
• bnbot follow-user [--username ]
• bnbot unfollow-user [--username ]
• bnbot bookmark-tweet [--tweetUrl ]
• bnbot unbookmark-tweet [--tweetUrl ]
• bnbot delete-tweet [--tweetUrl ]

Scraping

• bnbot scrape-timeline [--limit ] [--scrollAttempts ]
• bnbot scrape-bookmarks [--limit ]
• bnbot scrape-search-results --query "..." [--tab top|latest|people|media|lists] [--limit ] [--from ] [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--lang en] [--has images|videos|links|media] [--minLikes ] [--minRetweets ] [--minReplies ] [--excludeReplies] [--excludeRetweets]
• bnbot scrape-current-view
• bnbot scrape-thread [--tweetUrl ] [--maxScrolls ]
• bnbot account-analytics [--startDate YYYY-MM-DD] [--endDate YYYY-MM-DD] [--granularity Daily|Weekly|Monthly]

User Profiles

• bnbot scrape-user-profile --username
• bnbot scrape-user-tweets --username [--limit ] [--scrollAttempts ]

Content Fetching

• bnbot fetch-wechat-article --url
• bnbot fetch-tiktok-video --url [--savePath ]
• bnbot fetch-xiaohongshu-note --url

Articles

• bnbot open-article-editor
• bnbot fill-article-title --title "..."
• bnbot fill-article-body --content "..." [--format plain|markdown|html] [--bodyImages img1 img2]
• bnbot upload-article-header-image --headerImage
• bnbot publish-article [--publish] [--asDraft]
• bnbot create-article --title "..." --content "..." [--format plain|markdown|html] [--headerImage ] [--bodyImages img1 img2] [--publish]

Authentication

• bnbot login [--email ] — Login to BNBot via email verification

Jobs

• bnbot search-jobs [--type boost|hire|all] [--status active|completed|expired] [--sort created_at|reward|deadline] [--limit ] [--keyword "..."] [--endingSoon] [--token ETH|USDC|USDT]