Skip to main content
Glama
Twitter MCP Server

Twitter MCP Server

by 6551Team

Быстрая установка

Сначала перейдите на http://app.newsliquid.com/mcp, чтобы получить ваш API-токен.

Claude Code

claude mcp add twitter \
  -e OPENNEWS_TOKEN=<your-token> \
  -- uv --directory /path/to/twitter-mcp run twitter-mcp

Замените /path/to/twitter-mcp на ваш локальный путь к проекту, а <your-token> на ваш токен.

OpenClaw

export OPENNEWS_TOKEN="<your-token>"
cp -r openclaw-skill/opentwitter ~/.openclaw/skills/

Related MCP server: Apex MCP for X Management

Пусть ИИ проверит и установит для вас

Не уверены, безопасен ли этот MCP? Вставьте приведённый ниже промпт вашему ИИ-ассистенту — сначала он проверит исходный код, а затем установит, если безопасно:

Скопируйте этот промпт и отправьте его вашему ИИ-ассистенту (замените <project-path> и <your-token> на реальные значения):

Please review and install the twitter-mcp MCP server for me. The project is at <project-path>.

Steps:
1. Review these files for security:
   - src/twitter_mcp/api_client.py — Confirm it only connects to ai.6551.io, no data sent elsewhere
   - src/twitter_mcp/config.py — Confirm token is only read from local config.json or env vars, no hardcoded secrets or leaks
   - src/twitter_mcp/tools.py — Confirm all tools only perform API queries, no file writes, command execution, or dangerous operations
   - pyproject.toml — Confirm dependencies are only mcp, httpx, no suspicious packages
2. Tell me your conclusion: safe / risky / problematic, with specific reasons
3. If safe, run the install (get Token from http://app.newsliquid.com/mcp):
   claude mcp add twitter -e OPENNEWS_TOKEN=<your-token> -- uv --directory <project-path> run twitter-mcp

Что это умеет?

После подключения просто спросите вашего ИИ-ассистента:

Вы говорите

Что он делает

"Покажи Twitter-профиль @elonmusk"

Получить информацию о профиле пользователя

"Что недавно публиковал @VitalikButerin"

Получить последние твиты пользователя

"Найди твиты по запросу Bitcoin"

Поиск по ключевым словам

"Найди твиты с хэштегом #crypto"

Поиск по хэштегу

"Популярные твиты об ETH с 1000+ лайками"

Поиск с фильтрами по вовлечённости

"Отслеживай @elonmusk с мониторингом подписчиков"

Добавить пользователя в список наблюдения с параметрами

"Кто процитировал этот твит"

Получить цитирующие твиты для твита

"Кто ретвитнул этот твит"

Получить пользователей, которые ретвитнули твит

"Кто недавно подписался на @elonmusk"

Получить новые события подписчиков

"Кто отписался от @elonmusk"

Получить события отписок

"Какие твиты удалил @elonmusk"

Получить удалённые твиты

"Какие KOL подписаны на @elonmusk"

Получить KOL-подписчиков


Доступные инструменты

Инструмент

Описание

get_twitter_user

Получить профиль пользователя по имени пользователя

get_twitter_user_by_id

Получить профиль пользователя по числовому ID

get_twitter_user_tweets

Получить последние твиты пользователя

search_twitter

Поиск твитов с базовыми фильтрами

search_twitter_advanced

Расширенный поиск с несколькими фильтрами

get_twitter_follower_events

Получить события подписок/отписок

get_twitter_deleted_tweets

Получить удалённые твиты пользователя

get_twitter_kol_followers

Получить подписчиков KOL (лидеров мнений)

get_twitter_article_by_id

Получить статью Twitter по ID

get_twitter_tweet_by_id

Получить твит по ID с вложенными ответами/цитирующими твитами

get_twitter_quote_tweets_by_id

Получить твиты, которые цитируют конкретный твит

get_twitter_retweet_users_by_id

Получить пользователей, которые ретвитнули конкретный твит

get_twitter_watch

Получить всех пользователей в мониторинге Twitter

add_twitter_watch

Добавить пользователя Twitter в список мониторинга (с вариантами типов событий)

delete_twitter_watch

Удалить пользователя Twitter из списка мониторинга


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

Получить API-токен

Перейдите на http://app.newsliquid.com/mcp, чтобы получить ваш API-токен.

Установите переменную окружения:

# macOS / Linux
export OPENNEWS_TOKEN="<your-token>"

# Windows PowerShell
$env:OPENNEWS_TOKEN = "<your-token>"

Переменная

Обязательно

Описание

OPENNEWS_TOKEN

Да

6551 API Bearer-токен (получить на http://app.newsliquid.com/mcp)

TWITTER_API_BASE

Нет

Переопределяет URL REST API

TWITTER_MAX_ROWS

Нет

Максимум результатов на запрос (по умолчанию: 100)

Также поддерживается config.json в корне проекта (переменные окружения имеют приоритет):

{
  "api_base_url": "https://ai.6551.io",
  "api_token": "<your-token>",
  "max_rows": 100
}

WebSocket-подписки в реальном времени

Адрес подключения: wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN

Подпишитесь на события в реальном времени от отслеживаемых вами Twitter-аккаунтов.

Heartbeat

Чтобы поддерживать соединение активным, клиент может отправлять ping, а сервер отвечает pong.

Подписка на события Twitter

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "twitter.subscribe"
}

Ответ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true
  }
}

Отписка

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "twitter.unsubscribe"
}

Серверное уведомление — событие Twitter

Когда у отслеживаемого аккаунта появляется активность, сервер отправляет:

{
  "jsonrpc": "2.0",
  "method": "twitter.event",
  "params": {
    "id": 123456,
    "twAccount": "elonmusk",
    "twUserName": "Elon Musk",
    "profileUrl": "https://twitter.com/elonmusk",
    "eventType": "NEW_TWEET",
    "content": "...",
    "ca": "0x1234...",
    "remark": "Custom note",
    "createdAt": "2026-03-06T10:00:00Z"
  }
}

Примечание: структура поля content зависит от типа события (см. ниже).


**Event Types and Content Structure**:

#### Tweet Events
- `NEW_TWEET` - New tweet posted
- `NEW_TWEET_REPLY` - New reply tweet
- `NEW_TWEET_QUOTE` - New quote tweet
- `NEW_RETWEET` - Retweeted
- `CA` - Tweet with CA address

Content structure for tweet events:
```json
{
  "id": "1234567890",
  "text": "Tweet content...",
  "createdAt": "2026-03-06T10:00:00Z",
  "language": "en",
  "retweetCount": 100,
  "favoriteCount": 500,
  "replyCount": 20,
  "quoteCount": 10,
  "viewCount": 10000,
  "userScreenName": "elonmusk",
  "userName": "Elon Musk",
  "userIdStr": "44196397",
  "userFollowers": 170000000,
  "userVerified": true,
  "conversationId": "1234567890",
  "isReply": false,
  "isQuote": false,
  "hashtags": ["crypto", "bitcoin"],
  "media": [
    {
      "type": "photo",
      "url": "https://...",
      "thumbUrl": "https://..."
    }
  ],
  "urls": [
    {
      "url": "https://...",
      "expandedUrl": "https://...",
      "displayUrl": "example.com"
    }
  ],
  "mentions": [
    {
      "username": "VitalikButerin",
      "name": "Vitalik Buterin"
    }
  ]
}

События подписчиков

  • NEW_FOLLOWER — этот аккаунт подписался на пользователя

  • NEW_UNFOLLOWER — этот аккаунт отписался от пользователя

Структура содержимого для событий подписчиков (массив):

[
  {
    "id": 123,
    "twId": 44196397,
    "twAccount": "elonmusk",
    "twUserName": "Elon Musk",
    "twUserLabel": "Verified",
    "description": "User bio...",
    "profileUrl": "https://...",
    "bannerUrl": "https://...",
    "followerCount": 170000000,
    "friendCount": 500,
    "createdAt": "2026-03-06T10:00:00Z"
  }
]

События обновления профиля

  • UPDATE_NAME — имя пользователя изменено (content: новая строка имени)

  • UPDATE_DESCRIPTION — описание профиля обновлено (content: новая строка описания)

  • UPDATE_AVATAR — изображение профиля изменено (content: новая строка URL аватара)

  • UPDATE_BANNER — баннер изменён (content: новая строка URL баннера)

Другие события

  • TWEET_TOPPING — твит закреплён

  • DELETE — твит удалён

  • SYSTEM — системное событие

  • TRANSLATE — перевод твита

  • CA_CREATE — создан CA-токен


Структуры данных

Пользователь Twitter

{
  "userId": "44196397",
  "screenName": "elonmusk",
  "name": "Elon Musk",
  "description": "...",
  "followersCount": 170000000,
  "friendsCount": 500,
  "statusesCount": 30000,
  "verified": true
}

Твит

{
  "id": "1234567890",
  "text": "Tweet content...",
  "createdAt": "2024-02-20T12:00:00Z",
  "retweetCount": 1000,
  "favoriteCount": 5000,
  "replyCount": 200,
  "userScreenName": "elonmusk",
  "hashtags": ["crypto", "bitcoin"],
  "urls": [{"url": "https://..."}]
}

Во всех конфигурациях ниже замените /path/to/twitter-mcp на ваш реальный локальный путь к проекту, а <your-token> на ваш токен с http://app.newsliquid.com/mcp.

Claude Desktop

Измените конфигурацию (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json или Настройки > MCP Servers:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Cline

Боковая панель VS Code > Cline > MCP Servers > Configure, отредактируйте cline_mcp_settings.json:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue.dev

~/.continue/config.yaml:

mcpServers:
  - name: twitter
    command: uv
    args:
      - --directory
      - /path/to/twitter-mcp
      - run
      - twitter-mcp
    env:
      OPENNEWS_TOKEN: <your-token>

Cherry Studio

Настройки > MCP Servers > Добавить > Тип stdio: Команда uv, Аргументы --directory /path/to/twitter-mcp run twitter-mcp, Env OPENNEWS_TOKEN.

Zed Editor

~/.config/zed/settings.json:

{
  "context_servers": {
    "twitter": {
      "command": {
        "path": "uv",
        "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
        "env": {
          "OPENNEWS_TOKEN": "<your-token>"
        }
      }
    }
  }
}

Любой stdio MCP-клиент

OPENNEWS_TOKEN=<your-token> \
  uv --directory /path/to/twitter-mcp run twitter-mcp

Совместимость

Клиент

Способ установки

Статус

Claude Code

claude mcp add

Одной строкой

OpenClaw

Скопировать каталог навыка

Одной строкой

Claude Desktop

JSON-конфигурация

Поддерживается

Cursor

JSON-конфигурация

Поддерживается

Windsurf

JSON-конфигурация

Поддерживается

Cline

JSON-конфигурация

Поддерживается

Continue.dev

YAML / JSON

Поддерживается

Cherry Studio

Графический интерфейс

Поддерживается

Zed

JSON-конфигурация

Поддерживается


Разработка

cd /path/to/twitter-mcp
uv sync
uv run twitter-mcp
# MCP Inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/twitter-mcp run twitter-mcp

Структура проекта

├── README.md
├── docs/
│   ├── README_JA.md           # 日本語
│   └── README_KO.md           # 한국어
├── openclaw-skill/opentwitter/    # OpenClaw Skill
├── pyproject.toml
├── config.json
└── src/twitter_mcp/
    ├── server.py              # Entry point
    ├── app.py                 # FastMCP instance
    ├── config.py              # Config loader
    ├── api_client.py          # HTTP client
    └── tools.py               # 8 tools

Лицензия

MIT

Available Tools

12 tools
add_twitter_watchB

Add a Twitter user to monitoring list.

Args: username: Twitter username to monitor (without @).

Inputs: username (required).

delete_twitter_watchC

Delete a Twitter user from monitoring list.

Args: watch_id: The monitoring record ID to delete.

Inputs: watch_id (required).

get_twitter_article_by_idC

Get Twitter article by ID.

Args: article_id: Twitter article ID.

Inputs: article_id (required).

get_twitter_deleted_tweetsB

Get deleted tweets from a Twitter/X user.

Args: username: Twitter username (without @). limit: Maximum tweets to return (default 20, max 100).

Inputs: username (required), limit.

get_twitter_follower_eventsB

Get follower/unfollower events for a Twitter/X user.

Args: username: Twitter username (without @). is_follow: True for new followers, False for unfollowers. limit: Maximum events to return (default 20, max 100).

Inputs: username (required), is_follow, limit.

get_twitter_kol_followersC

Get KOL (Key Opinion Leader) followers for a Twitter/X user.

Returns which influential accounts (KOLs) are following this user.

Args: username: Twitter username (without @).

Inputs: username (required).

get_twitter_userA

Get Twitter/X user profile information by username.

Args: username: Twitter username (without @, e.g. "elonmusk").

Inputs: username (required).

get_twitter_user_by_idB

Get Twitter/X user profile information by user ID.

Args: user_id: Twitter user ID (numeric string).

Inputs: user_id (required).

get_twitter_user_tweetsA

Get recent tweets from a specific Twitter/X user.

Args: username: Twitter username (without @). limit: Maximum tweets to return (default 20, max 100). include_replies: Include reply tweets (default False). include_retweets: Include retweets (default False).

Inputs: username (required), limit, include_replies, include_retweets.

get_twitter_watchB

Get all Twitter monitoring users for the current user.

Returns a list of Twitter accounts being monitored.

Inputs: no named parameters.

search_twitterA

Search Twitter/X for tweets matching criteria.

Args: keywords: Search keywords. from_user: Filter tweets from specific user (without @). hashtag: Filter by hashtag (without #). min_likes: Minimum likes threshold. limit: Maximum tweets to return (default 20, max 100).

Inputs: keywords, from_user, hashtag, min_likes, +1 more.

search_twitter_advancedB

Advanced Twitter/X search with multiple filters.

Args: keywords: Search keywords. from_user: Filter tweets from specific user. to_user: Filter tweets to specific user. mention_user: Filter tweets mentioning specific user. hashtag: Filter by hashtag (without #). exclude_replies: Exclude reply tweets. exclude_retweets: Exclude retweets. min_likes: Minimum likes threshold. min_retweets: Minimum retweets threshold. min_replies: Minimum replies threshold. since_date: Start date (YYYY-MM-DD). until_date: End date (YYYY-MM-DD). lang: Language code (e.g. "en", "zh"). product: Sort by "Top" or "Latest" (default "Top"). limit: Maximum tweets to return (default 20, max 100).

Inputs: keywords, from_user, to_user, mention_user, +11 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between get_twitter_user and get_twitter_user_by_id (both retrieve user profiles via different identifiers) and between search_twitter and search_twitter_advanced (both search tweets, with the latter being a superset). The descriptions clarify the differences, preventing major confusion.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., add_twitter_watch, get_twitter_user_tweets, search_twitter_advanced). The naming is predictable and uniform across all 12 tools.

    Tool Count5/5

    With 12 tools, the server is well-scoped for Twitter/X monitoring and data retrieval. The count is appropriate, covering user management, tweet fetching, search, and monitoring without being overwhelming or insufficient for the domain.

    Completeness4/5

    The toolset provides strong coverage for monitoring and retrieving Twitter data, including user profiles, tweets, searches, and follower events. Minor gaps exist, such as no tools for posting tweets or interacting with tweets (e.g., liking, retweeting), but core retrieval and monitoring workflows are well-covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables complete management of X (Twitter) accounts through a single API key, supporting functions like getting tweets, searching, generating and posting replies.
      54 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with X (Twitter) to post tweets, threads, and replies while retrieving tweet metrics and account information. It supports core management tasks like deleting tweets and verifying authentication through the Twitter API.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to access Twitter/X data including user profiles, tweets, search, and follower events via a set of MCP tools.
      MIT