Bnbot Server

MCP Server for BNBOT Chrome Extension - Control Twitter/X via AI assistants like OpenClaw or Claude Desktop.

Architecture

AI Assistant (OpenClaw / Claude Desktop)
    ↓ stdio (MCP protocol)
bnbot-mcp-server (local Node.js process)
    ↓↑ WebSocket (ws://localhost:18900)
BNBOT Chrome Extension
    ↓ DOM operations
Twitter/X

Setup

1. Install BNBOT Chrome Extension

Install from the Chrome Web Store.

2. Enable OpenClaw Integration

In the BNBOT extension sidebar, open Settings and turn on the OpenClaw toggle.

3. Configure Your AI Assistant

OpenClaw / Claude Desktop

Add to your MCP config:

{
  "mcpServers": {
    "bnbot": {
      "command": "npx",
      "args": ["bnbot-mcp-server"]
    }
  }
}

Custom Port

{
  "mcpServers": {
    "bnbot": {
      "command": "npx",
      "args": ["bnbot-mcp-server", "--port", "9999"]
    }
  }
}

4. Use It

Ask your AI assistant:

• "Scrape my Twitter timeline"
• "Search for tweets about AI"
• "Post a tweet saying hello world"
• "Navigate to my bookmarks and scrape them"

Available Tools

Scrape

Tool	Description
scrape_timeline	Scrape tweets from the timeline
scrape_bookmarks	Scrape bookmarked tweets
scrape_search_results	Search and scrape results
scrape_current_view	Scrape currently visible tweets
scrape_thread	Scrape a tweet thread from URL
account_analytics	Get account analytics data

Tweet

Tool	Description
post_tweet	Post a tweet with optional images
post_thread	Post a thread of tweets
submit_reply	Reply to a tweet
quote_tweet	Quote a tweet with optional comment

Engagement

Tool	Description
like_tweet	Like a target tweet
retweet	Retweet a target tweet
follow_user	Follow a target user

Navigation

Tool	Description
navigate_to_tweet	Go to a specific tweet
navigate_to_search	Go to search page
navigate_to_bookmarks	Go to bookmarks
navigate_to_notifications	Go to notifications
navigate_to_following	Go to following timeline
return_to_timeline	Go back to timeline

Status

Tool	Description
get_extension_status	Check extension connection
get_current_page_info	Get current page info

Content

Tool	Description
fetch_wechat_article	Fetch and extract WeChat article content
fetch_tiktok_video	Fetch TikTok metadata and download video locally
fetch_xiaohongshu_note	Fetch Xiaohongshu note content and metadata

Article

Tool	Description
open_article_editor	Open X article editor via stable flow
fill_article_title	Fill article title field
fill_article_body	Fill article body (plain / markdown / html)
upload_article_header_image	Upload article header image
publish_article	Publish article (or keep draft)
create_article	End-to-end article creation flow

Testing

Use the MCP Inspector to test tools directly:

npx @modelcontextprotocol/inspector npx bnbot-mcp-server

License

MIT