Twitter Bridge

Автоматизируйте взаимодействие с Twitter/X с помощью Twitter Bridge. Подключайте Claude.ai для публикаций, ответов, извлечения данных и многого другого без дорогих официальных API-ключей. Экономьте деньги, сохраняйте контроль.

Социальные сети Автоматизация браузера Веб-скрапинг и сбор данных ★ 40 GitHub (40 ★)

Этот инструмент позволяет Claude.ai взаимодействовать с Twitter/X с помощью открытой браузерной автоматизации, обходя необходимость в дорогом официальном API Twitter. Он управляет сессией Chrome для выполнения таких действий, как публикация, ответ, лайк и ретвит, а также для извлечения информации из ленты, поиска и профилей пользователей. Разработанный с учётом экономической эффективности, он предоставляет полный набор функций Twitter для ИИ-агентов за малую часть стоимости традиционного API.

Ключевые особенности

01Делать скриншоты страниц Twitter/X прямо из браузера.

02Автоматизировать публикации, ответы, лайки, ретвиты и цитирование в Twitter/X.

03Читать личные сообщения и уведомления Twitter/X (с частичной поддержкой DM).

04Выполнять действия с пользователями, включая подписку и отписку от аккаунтов.

05Извлекать данные с помощью поиска по Twitter, просмотра ленты, закладок и твитов пользователя.

0640 звёзд на GitHub

Варианты использования

01Дать ИИ-агентам возможность автономно управлять аккаунтами Twitter/X и взаимодействовать с ними.

02Отслеживать тренды социальных сетей и активность пользователей через программный доступ.

03Автоматизировать публикацию контента, вовлечение и сбор информации в Twitter/X.

Twitter Bridge MCP

Connect Claude.ai to Twitter/X — without paying $100/month for the official API.

Uses bb-browser (open-source browser automation) to control a logged-in Chrome session, wrapped as an MCP server that Claude.ai can talk to.

Claude.ai ──MCP──▶ your-server:8080 ──bb-browser──▶ Chrome (logged in) ──▶ Twitter/X

Cost: ~$5/year (just a domain for Cloudflare Tunnel).

What it can do

Tool	Method	Status
`twitter_post`	Browser automation	✅
`twitter_reply`	Browser automation	✅
`twitter_like`	GraphQL API	✅
`twitter_retweet`	GraphQL API	✅
`twitter_quote`	Browser automation	✅
`twitter_follow`	Browser automation	✅
`twitter_unfollow`	Browser automation	✅
`twitter_undo`	GraphQL API	✅
`twitter_search`	Browser DOM parsing	✅
`twitter_timeline`	Browser DOM parsing	✅
`twitter_bookmarks`	Browser DOM parsing	✅
`twitter_tweets`	Browser DOM parsing	✅
`twitter_notifications`	bb-sites adapter	✅
`twitter_user`	bb-sites adapter	✅
`twitter_view_tweet`	Browser DOM parsing	✅
`twitter_dm_read`	Browser automation	⚠️ partial
`twitter_screenshot`	bb-browser	✅
`browser_open`	bb-browser	✅
`browser_snapshot`	bb-browser	✅

DM reading works but Twitter's E2E encryption may limit what's visible via browser automation.

Architecture

The server has three layers:

MCP + OAuth — Claude.ai connects via Streamable HTTP transport with auto-approved OAuth 2.0 (PKCE).
Tool implementations — 19 tools split between browser automation (open page → wait → parse DOM) and GraphQL API calls (for lightweight actions like like/retweet/undo).
bb-browser — Controls Chrome via CDP (Chrome DevTools Protocol), inheriting the logged-in session.

Browser automation was chosen over GraphQL API for most read operations because Twitter's API requires a x-client-transaction-id header generated from webpack internals — the module IDs change on every Twitter deploy, causing random 404s. DOM parsing is slower but never breaks.

Prerequisites

Node.js ≥ 18
Chrome (or Chromium) with remote debugging enabled
bb-browser — Install from GitHub
A Twitter/X account — logged in within the Chrome profile
Cloudflare Tunnel (or any reverse proxy) — to expose your local server with HTTPS

Setup

1. Start Chrome with CDP

# Create a dedicated Chrome profile
mkdir -p ~/chrome-mcp-profile

# Launch Chrome with remote debugging
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=$HOME/chrome-mcp-profile

2. Install & configure

git clone https://github.com/replica882/twitter-bridge-mcp.git
cd twitter-bridge-mcp
npm install

cp .env.example .env
# Edit .env with your values

3. Run

node server.mjs
# Twitter MCP Bridge v0.6.0: http://0.0.0.0:8080/mcp

4. Expose via Cloudflare Tunnel

cloudflared tunnel --url http://localhost:8080

Or set up a named tunnel for a permanent URL.

5. Connect from Claude.ai

In Claude.ai → Settings → Connected Tools → Add Custom Connector:

URL: https://your-tunnel-domain.com/mcp

Claude will auto-discover OAuth endpoints and connect.

Configuration

All config is via environment variables (or .env file):

Variable	Default	Description
`PORT`	`8080`	Server port
`CDP_PORT`	`9222`	Chrome DevTools Protocol port
`BASE_URL`	`http://localhost:8080`	Public URL (for OAuth discovery)
`BB_BROWSER_PATH`	`~/local/bin/bb-browser`	Path to bb-browser binary
`DM_PIN`	(empty)	Twitter DM encryption PIN (if set up)
`OAUTH_CLIENT_ID`	`twitter-mcp-client`	OAuth client ID
`OAUTH_CLIENT_SECRET`	(auto-generated)	OAuth client secret

How it works

Why not the official API?

Twitter/X API Basic tier costs $100/month. This project does the same thing for $5/year by automating a real browser session.

Why not just GraphQL?

Twitter's internal GraphQL API requires a x-client-transaction-id header. This ID is generated by a function buried in Twitter's webpack bundles — the module number changes every time Twitter deploys. We use GraphQL only for simple mutations (like, retweet, delete) that don't need this header. Everything else uses DOM parsing.

Tab management

Every browser operation opens a new tab. Without cleanup, Chrome accumulates 40+ tabs and crashes. The server auto-closes excess tabs, keeping a maximum of 10.

DM PIN auto-entry

Twitter requires a PIN every time you open the DM page (E2E encryption). If DM_PIN is set, the server auto-enters it using React-compatible input simulation (native property setter + keyboard events).

Gotchas

Chrome profile encryption — Cookie storage is bound to a profile key. You can't copy a Chrome profile directory to migrate login state. Always use --user-data-dir and log in manually.
React contenteditable — Twitter's compose box is a contenteditable div. Normal DOM manipulation doesn't trigger React state updates. The server uses ClipboardEvent paste for quote tweets and bb-browser's type command for regular posts.
Search occasionally empty — If you search too quickly after page load, DOM might not be populated yet. The server waits 4 seconds, which works reliably.
launchd/systemd and dotenv — If you run the server as a system service, make sure to set WorkingDirectory to the project directory. Without this, dotenv can't find .env, BASE_URL falls back to http://localhost:8080, and OAuth discovery returns localhost URLs — Claude.ai will fail to connect. For macOS launchd, add <key>WorkingDirectory</key><string>/path/to/twitter-bridge-mcp</string> to your plist. For systemd, add WorkingDirectory=/path/to/twitter-bridge-mcp to your unit file.
Server restart loses OAuth tokens — OAuth tokens are stored in memory. Every server restart requires reconnecting from Claude.ai (Settings → Connected Tools → reconnect Twitter Bridge).

Credits

bb-browser — the browser automation engine that makes this possible
MCP SDK — Model Context Protocol server framework
Cloudflare Tunnel — free HTTPS tunneling

License

MIT

Twitter Bridge MCP

Подключай Claude.ai к Twitter/X без ежемесячной платы за официальный API.

Этот сервер использует bb-browser (открытое ПО для автоматизации браузера) для управления сессией Chrome, в которой уже выполнен вход в Twitter. Всё работает как MCP-сервер, с которым может общаться Claude.ai.

Архитектура:

Claude.ai ──MCP──> ваш сервер:8080 ──bb-browser──> Chrome (авторизован) ──> Twitter/X

Стоимость: ~$5/год (нужен только домен для Cloudflare Tunnel).

Возможности

Сервер предоставляет 19 инструментов, разделённых на три группы:

Инструмент	Метод	Статус
twitter_post	Автоматизация браузера	✅
twitter_reply	Автоматизация браузера	✅
twitter_like	GraphQL API	✅
twitter_retweet	GraphQL API	✅
twitter_quote	Автоматизация браузера	✅
twitter_follow	Автоматизация браузера	✅
twitter_unfollow	Автоматизация браузера	✅
twitter_undo	GraphQL API	✅
twitter_search	Парсинг DOM	✅
twitter_timeline	Парсинг DOM	✅
twitter_bookmarks	Парсинг DOM	✅
twitter_tweets	Парсинг DOM	✅
twitter_notifications	Адаптер bb-sites	✅
twitter_user	Адаптер bb-sites	✅
twitter_view_tweet	Парсинг DOM	✅
twitter_dm_read	Автоматизация браузера	⚠️ частично
twitter_screenshot	bb-browser	✅
browser_open	bb-browser	✅
browser_snapshot	bb-browser	✅

Чтение DM работает, но E2E-шифрование Twitter может ограничивать видимость через автоматизацию.

Почему не официальный API?

Twitter/X API Basic стоит $100/месяц. Этот проект делает то же самое за $5/год, автоматизируя реальный браузер.
Внутренний GraphQL API Twitter требует заголовок x-client-transaction-id, который генерируется функцией из webpack-бандлов. Номер модуля меняется при каждом деплое Twitter, что вызывает случайные 404. Поэтому GraphQL используется только для простых действий (лайк, ретвит, удаление). Всё остальное — через парсинг DOM.

Архитектура

Сервер состоит из трёх слоёв:

MCP + OAuth — Claude.ai подключается через Streamable HTTP с авто-одобрением OAuth 2.0 (PKCE).
Реализация инструментов — 19 инструментов, разделённых на автоматизацию браузера и вызовы GraphQL.
bb-browser — управляет Chrome через CDP (Chrome DevTools Protocol), используя текущую сессию.

Предварительные требования

Node.js ≥ 18
Chrome или Chromium с включённой удалённой отладкой
bb-browser — установить с GitHub
Аккаунт Twitter/X, авторизованный в профиле Chrome
Cloudflare Tunnel (или любой reverse proxy) для HTTPS

Установка и запуск

1. Запустите Chrome с CDP

# Создайте отдельный профиль
mkdir -p ~/chrome-mcp-profile

# Запустите Chrome с удалённой отладкой
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=$HOME/chrome-mcp-profile

Войдите в Twitter/X в этом окне Chrome.

2. Установите сервер

git clone https://github.com/replica882/twitter-bridge-mcp.git
cd twitter-bridge-mcp
npm install
cp .env.example .env
# Отредактируйте .env под свои параметры

3. Запустите сервер

node server.mjs
# Twitter MCP Bridge v0.6.0: http://0.0.0.0:8080/mcp

4. Опубликуйте через Cloudflare Tunnel

cloudflared tunnel --url http://localhost:8080

Или настройте именованный туннель для постоянного URL (см. документацию Cloudflare).

5. Подключите Claude.ai

В Claude.ai → Settings → Connected Tools → Add Custom Connector:

URL: https://ваш-домен-туннеля.com/mcp

Claude автоматически обнаружит OAuth-эндпоинты и подключится.

Конфигурация

Все настройки задаются через переменные окружения (или .env файл):

Переменная	По умолчанию	Описание
`PORT`	8080	Порт сервера
`CDP_PORT`	9222	Порт Chrome DevTools Protocol
`BASE_URL`	http://localhost:8080	Публичный URL (для OAuth)
`BB_BROWSER_PATH`	~/local/bin/bb-browser	Путь к бинарнику bb-browser
`DM_PIN`	(пусто)	PIN для DM (если настроено E2E)
`OAUTH_CLIENT_ID`	twitter-mcp-client	ID клиента OAuth
`OAUTH_CLIENT_SECRET`	(авто-генерация)	Секрет клиента OAuth

Важные предупреждения

Шифрование профиля Chrome: Cookie привязаны к ключу профиля. Нельзя скопировать директорию профиля для переноса. Всегда используйте --user-data-dir и входите вручную.
React contenteditable: Поле ввода Twitter — это contenteditable div. Обычное манипулирование DOM не вызывает обновление состояния React. Сервер использует ClipboardEvent для цитат и команду type от bb-browser для обычных постов.
Поиск иногда пуст: Если выполнять поиск сразу после загрузки страницы, DOM может быть не готов. Сервер ждёт 4 секунды — этого достаточно.
systemd/launchd и dotenv: При запуске как системная служба убедитесь, что WorkingDirectory указывает на каталог проекта. Иначе .env не загрузится, BASE_URL упадёт в localhost, и OAuth не сработает. Для macOS launchd добавьте <key>WorkingDirectory</key><string>/путь/к/twitter-bridge-mcp</string> в plist. Для systemd — WorkingDirectory=/путь/к/twitter-bridge-mcp в unit-файл.
Перезапуск сервера сбрасывает OAuth-токены: Токены хранятся в памяти. При каждом рестарте нужно переподключать инструмент в Claude.ai (Settings → Connected Tools → reconnect).

Управление вкладками

Каждая операция открывает новую вкладку. Без очистки Chrome накапливает 40+ вкладок и падает. Сервер автоматически закрывает лишние, оставляя не более 10.

Автоввод PIN для DM

Twitter требует PIN при каждом открытии страницы DM (E2E-шифрование). Если установлена переменная DM_PIN, сервер автоматически вводит его, используя имитацию ввода, совместимую с React (нативный установщик свойств + события клавиатуры).

Благодарности

bb-browser — движок автоматизации браузера
MCP SDK — фреймворк для MCP
Cloudflare Tunnel — бесплатный HTTPS-туннель

Лицензия

MIT

Источник: https://mcpmarket.com/server/twitter-bridge

Ключевые особенности

Варианты использования

Twitter Bridge MCP

What it can do

Architecture

Prerequisites

Setup

1. Start Chrome with CDP

2. Install & configure

3. Run

4. Expose via Cloudflare Tunnel

5. Connect from Claude.ai

Configuration

How it works

Why not the official API?

Why not just GraphQL?

Tab management

DM PIN auto-entry

Gotchas

Credits

License

Twitter Bridge MCP

Возможности

Почему не официальный API?

Архитектура

Предварительные требования

Установка и запуск

1. Запустите Chrome с CDP

2. Установите сервер

3. Запустите сервер

4. Опубликуйте через Cloudflare Tunnel

5. Подключите Claude.ai

Конфигурация

Важные предупреждения

Управление вкладками

Автоввод PIN для DM

Благодарности

Лицензия

Почему Twitter Bridge избегает использования официального API Twitter/X?

Каковы примерные затраты на запуск Twitter Bridge?

Какие конкретные действия в Twitter/X может автоматизировать Twitter Bridge?

Что такое Twitter Bridge и как он подключается к Claude.ai?

Комментарии