twitter-cli
CLI для Twitter/X со скиллом для агентов: ленты, закладки, поиск и профили в терминале, плюс публикация, ответы и лайки без ключей API
- 3 005 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Утилита читает куки вашего аккаунта из браузера и действует от вашего имени: публикует, удаляет, лайкает и подписывается
- Неофициальный доступ может привести к блокировке аккаунта, особенно при частых запросах
- Через окружение и файлы утилита работает с токенами авторизации аккаунта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/twitter-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Утилита читает куки вашего аккаунта из браузера и действует от вашего имени: публикует, удаляет, лайкает и подписывается
- Неофициальный доступ может привести к блокировке аккаунта, особенно при частых запросах
- Через окружение и файлы утилита работает с токенами авторизации аккаунта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда twitter читает и пишет в Twitter/X из терминала без ключей API: вход идет через куки из вашего браузера. Читать можно ленты For You и Following, закладки, поиск с вкладками Top, Latest, Photos и Videos, страницу твита с ответами, списки, профили, чужие твиты, подписчиков и подписки, а статьи Twitter выгружаются в Markdown. Для записи есть публикация с картинками (до четырех), ответы, цитаты, удаление своих твитов, лайки, ретвиты, закладки и подписки. Вывод поддерживает режимы YAML и JSON. Когда он идет в конвейер или файл, по умолчанию включается YAML. Флаг -c сжимает ответ для экономии токенов. Необязательный фильтр ранжирует твиты по весам лайков, ретвитов, ответов, закладок и просмотров из config.yaml. Вместе с CLI идет SKILL.md, в котором для агента расписаны проверка входа, справочник команд и сценарии: опубликовать и проверить, ответить на последний твит автора, собрать тред, процитировать с комментарием.
Для кого. Для разработчиков и аналитиков, которым нужно читать ленту, искать посты и публиковать из терминала или через агента.
Подходит, если
- Нужно выгрузить закладки или ленту Following в YAML и разобрать их агентом
- Надо найти посты по теме за период, например twitter search с фильтрами --from, --lang и --since
- Агент должен прочитать твит со всеми ответами по ссылке и пересказать обсуждение
- Нужно опубликовать пост или тред с картинками и проверить результат по ссылке на твит
- Статью Twitter нужно сохранить в Markdown-файл для заметок
Не подходит, если
- Вам нужен официальный API с ключами и квотами: утилита ходит через внутренний интерфейс сайта, и ответы могут сломаться при его изменении
- Аккаунт критичен для работы: автоматические действия с куки могут вызвать блокировку
- Нужны чужие лайки: Twitter закрыл их в июне 2024 года, команда показывает только ваши
- Вы в России: сервис X здесь заблокирован, и из страны он недоступен
Пример запроса к агенту
Найди через twitter-cli 30 свежих постов про Claude Code, сохрани в YAML и перескажи основные темы обсужденияОграничения
Утилита использует внутренние запросы сайта, поэтому ответ 404 иногда означает смену идентификаторов запросов. Чаще всего помогает повтор, а клиент пытается найти новые идентификаторы сам. Для записи нужны полные куки браузера: одних `auth_token` и ct0 из переменных окружения бывает мало, и Twitter отвечает ошибкой 226 о похожем на автоматику поведении.
Нужен Python, ставится через uv или pipx. Сервис X в России заблокирован. Для чтения большого числа записей лучше брать малые лимиты и не запускать утилиту слишком часто: каждый запуск обращается к x.com. Windows с ConPTY может терять вывод из конвейера, помогает Git Bash.
Как отключить. Удалите утилиту командой uv tool uninstall `twitter-cli` или pipx uninstall `twitter-cli`, а скилл уберите из каталога скиллов агента, например из .agents/skills/twitter-cli. Выйдите из x.com в браузере, если не хотите, чтобы куки оставались доступными.
Частые вопросы
Как поставить `twitter-cli` в Claude Code?
Сначала утилита: uv tool install `twitter-cli` или pipx install `twitter-cli`. Затем скилл: npx skills add jackwener/twitter-cli, с флагами -g для глобальной установки и -a `claude-code` для выбора агента. Можно и вручную клонировать репозиторий в .agents/skills/twitter-cli.
Как `twitter-cli` входит в аккаунт без API-ключей?
Берет куки из браузера Arc, Chrome, Edge, Firefox или Brave, а при необходимости читает переменные TWITTER_AUTH_TOKEN и TWITTER_CT0. Для записи нужны полные куки браузера, иначе возможна ошибка 226. Проверить вход можно командами twitter status и twitter whoami.
Какой вывод удобен для агента?
YAML: он включается сам, когда вывод идет не в терминал. Если нужен строгий JSON, добавьте --json; для экономии токенов служит флаг -c. Структуру ответов описывает файл SCHEMA.md, коды ошибок вроде `not_authenticated`, `rate_limited` и `not_found` приходят в структурированном виде.
Что делать при ошибке 404 от Twitter?
Повторить команду. 404 может появиться, когда у сайта меняются идентификаторы GraphQL-запросов, и клиент затем пробует найти актуальные идентификаторы сам. Если ошибка держится, обновите утилиту командой uv tool upgrade `twitter-cli`.
Как работает ранжирование твитов флагом --filter?
Считается оценка: лайки ×1, ретвиты ×3, ответы ×2, закладки ×5 и логарифм просмотров с весом 0,5 — это значения по умолчанию из config.yaml. Режимы topN, score и all оставляют лучшие N, твиты выше порога или все с сортировкой.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЧитает твиты, ответы, ленты, списки и статьи X без входа и ключей API через команду xtf, три источника с автоматической подменой при сбое
CLI и скилл, через которые агент читает и ищет в Twitter, Reddit, YouTube, GitHub, Bilibili и Xiaohongshu без платных API
Скилл news-extractor достает из ссылки заголовок, текст, картинки и метаданные статьи с 12 новостных площадок и отдает JSON или Markdown без браузера
Превращает любой сайт в команду и дает агенту работать в уже залогиненном браузере пользователя через Playwright
CLI и MCP-сервер, через которые агент управляет вашим настоящим Chrome с сохраненными входами: 103 команды к 36 сайтам и автоматизация браузера
Скилл читает ссылку и отдает агенту полный текст в Markdown: выбирает отдельный путь для страниц WeChat, документов Feishu, PDF и статей arXiv
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| twitter-cli (эта запись) | нет | 3 005 | |
| Agent Reach | нет | 101 320 | CLI и скилл для чтения Twitter, Reddit, YouTube, GitHub и других площадок сразу |
| bb-browser | нет | 6 249 | дает агенту ваш настоящий Chrome с сохраненными входами для любых сайтов |
| last30days | нет | 65 215 | собирает обсуждения темы за 30 дней из Reddit, X, YouTube и других источников |
Коротко о README
Описание на английском и китайском представляет утилиту как терминальный инструмент для Twitter/X без ключей API. Оно перечисляет функции чтения и записи, способы входа, установку через uv и pipx, примеры команд, настройку через config.yaml с весами оценки и советы, как не получить блокировку. Отдельно есть раздел о подключении как скилла агента, диагностика ошибок и структура проекта.
Бейдж для README
Исходный SKILL.md
---
name: twitter-cli
description: Use twitter-cli for ALL Twitter/X operations — reading tweets, posting, replying, quoting, liking, retweeting, following, searching, user lookups. Invoke whenever user requests any Twitter interaction.
author: jackwener
version: "0.8.0"
tags:
- twitter
- x
- social-media
- terminal
- cli
---
# twitter-cli — Twitter/X CLI Tool
**Binary:** `twitter`
**Credentials:** browser cookies (auto-extracted) or env vars
## Setup
```bash
# Install (requires Python 3.8+)
uv tool install twitter-cli
# Or: pipx install twitter-cli
# Upgrade to latest (recommended to avoid API errors)
uv tool upgrade twitter-cli
# Or: pipx upgrade twitter-cli
```
## Authentication
**IMPORTANT FOR AGENTS**: Before executing ANY twitter-cli command, you MUST first check if credentials exist. If not, you MUST proactively guide the user through the authentication process. Do NOT assume credentials are configured.
**CRITICAL**: Write operations (posting tweets, replying, quoting) REQUIRE full browser cookies. Only providing `auth_token` + `ct0` via env vars may result in **226 error** ("looks like automated behavior"). For best results, use browser cookie extraction.
### Step 0: Check if already authenticated
```bash
twitter status --yaml >/dev/null && echo "AUTH_OK" || echo "AUTH_NEEDED"
```
If `AUTH_OK`, skip to [Command Reference](#command-reference).
If `AUTH_NEEDED`, proceed to guide the user:
### Step 1: Guide user to authenticate
**Method A: Browser cookie extraction (recommended)**
Ensure user is logged into x.com in one of: Arc, Chrome, Edge, Firefox, Brave. twitter-cli auto-extracts cookies.