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 <url>
• 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 <url>] [--image <path>]
• bnbot quote-tweet --tweetUrl <url> --text "..." [--media ...] [--draftOnly]

Engagement

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

Scraping

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

User Profiles

• bnbot scrape-user-profile --username <handle>
• bnbot scrape-user-tweets --username <handle> [--limit <n>] [--scrollAttempts <n>]

Content Fetching

• bnbot fetch-wechat-article --url <url>
• bnbot fetch-tiktok-video --url <url> [--savePath <path>]
• bnbot fetch-xiaohongshu-note --url <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 <path>
• bnbot publish-article [--publish] [--asDraft]
• bnbot create-article --title "..." --content "..." [--format plain|markdown|html] [--headerImage <path>] [--bodyImages img1 img2] [--publish]

Authentication

• bnbot login [--email <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 <n>] [--keyword "..."] [--endingSoon] [--token ETH|USDC|USDT]