x.md (browse-x) — скилл
Скилл browse-x отдает агенту публичные посты, ветки, профили и поиск X в виде Markdown или JSON без аккаунта и ключа X.
- 197 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запросы с адресами постов и поисковыми фразами уходят на сторонний сервис mdfromx.com.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/x-md-browse-xОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запросы с адресами постов и поисковыми фразами уходят на сторонний сервис mdfromx.com.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ссылки на x.com, twitter.com и t.co превращаются в читаемый текст: пост с цепочкой родителей и ответами, длинная статья X, профиль с последними оригинальными постами, подписчики и подписки. Запрос идет на размещенный сервис mdfromx.com, который тянет данные у публичных провайдеров. Скилл только читает: не публикует, не ставит лайки и не открывает закрытые аккаунты и личные сообщения. Команды вида `bun scripts/browse-x.ts profile handle` принимают `--json`, `--full` и `--compact`, а `--cursor` продолжает выдачу. Тот же сервис дает HTTP API, MCP по адресу `/mcp` и файл `llms.txt`. Проект в бете и не связан с X Corp.
Для кого. Исследователям и разработчикам, чьи агенты встречают ссылки на X в задачах, issue и чатах и не могут открыть браузер.
Подходит, если
- В issue приложена ссылка на твит, и агенту нужен текст ветки целиком.
- Статью из X надо сохранить в заметки с YAML-шапкой: `--format obsidian`.
- Нужны био и последние оригинальные посты публичного профиля.
- Результаты поиска X разбирают как данные, например `from:handle release`.
Не подходит, если
- Нужны приватные, защищенные и удаленные посты или личные сообщения.
- Требуется публикация, лайки и подписки.
- Идет массовый сбор данных для датасета.
Пример запроса к агенту
Прочитай эту ветку из X целиком вместе с ответами автора и перескажи ее: https://x.com/handle/status/1234567890Ограничения
Служба работает в бете: маршруты и поля могут меняться вслед за провайдерами, а данные приходят из публичных источников и могут опаздывать или обрезаться, об этом говорит поле `warnings`. Скилл запускается через Bun. Публичные запросы ограничены квотой, при `429` надо дождаться `Retry-After`. Списки X недоступны. Запросы проходят через сторонний сервис mdfromx.com. Условия использования X для таких запросов определяет сам провайдер данных, поэтому для коммерческих сценариев сверьтесь с ними.
Как отключить. Удалите скилл `browse-x` из каталога скиллов агента. Если задавали `X_MD_API_KEY` или `X_API_BASE`, уберите их из окружения.
Частые вопросы
Нужен ли аккаунт или ключ X?
Нет. Скилл читает публичный контент через mdfromx.com, ключ API X не требуется. Необязательный `X_MD_API_KEY` лишь поднимает квоты.
Что делать при ответе 429?
Остановитесь и дождитесь времени из `Retry-After`. Скилл завершается кодом 3, повторять запрос в цикле не нужно.
Есть ли MCP-сервер?
Да, сервис публикует MCP по адресу mdfromx.com/mcp на Streamable HTTP с теми же чтениями, что и скилл.
Какие форматы вывода есть?
Markdown по умолчанию, `--json` для структуры, `--full` с датами и метриками, `--compact` короче и `--format obsidian` с YAML-шапкой.
Читает ли скилл закрытые аккаунты?
Нет. Закрытые, приостановленные и удаленные посты, списки X и личные сообщения недоступны, и флага для их открытия нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл читает ссылку и отдает агенту полный текст в Markdown: выбирает отдельный путь для страниц WeChat, документов Feishu, PDF и статей arXiv
CLI для Twitter/X со скиллом для агентов: ленты, закладки, поиск и профили в терминале, плюс публикация, ответы и лайки без ключей API
Скилл веб-поиска, поиска по X и чтения страниц для моделей без выхода в сеть: без регистрации и ключа, ответ в JSON со ссылками на источники
Читает твиты, ответы, ленты, списки и статьи X без входа и ключей API через команду xtf, три источника с автоматической подменой при сбое
Скилл превращает ссылку в чистый Markdown через Scrapling с запасным Jina Reader, в том числе статьи WeChat, Juejin и CSDN
Скилл news-extractor достает из ссылки заголовок, текст, картинки и метаданные статьи с 12 новостных площадок и отдает JSON или Markdown без браузера
Коротко о README
Репозиторий держит сам сервис x.md с HTTP API, SDK и MCP, а скилл `browse-x` в каталоге `skills/` подключает его агентам. Свой экземпляр можно развернуть на Bun 1.4.
Бейдж для README
Исходный SKILL.md
--- name: browse-x description: "Reads public X (formerly Twitter) posts, threads, X Articles, profiles, followers, following, and search results as Markdown or JSON, with no X account and no API key. Use when a URL points at x.com, twitter.com, or t.co; when the user mentions a tweet, an X post, a thread, or an X profile; when you need an account's recent posts or connections; or when you need X search results as structured data. Read-only: it never posts, replies, follows, or reads protected accounts, direct messages, or Lists." allowed-tools: - Bash(bun scripts/browse-x.ts *) - Bash(curl *mdfromx.com*) --- # browse x public content through mdfromx.com. no X login needed. run the helper from this skill's directory: ## when to use this reach for it whenever the job is reading one piece of public X content right now: - you need the text of a public X post, thread, or X Article and can't run a browser or log into X. - you hit an `x.com`, `twitter.com`, or `t.co` link in a document, issue, changelog, or chat log and need its content inline. - you want a public profile's bio and latest original posts (replies and reposts filtered out). - you're checking who a public account follows, or who follows it. - you want X search results as data rather than a rendered timeline. - you're saving a post into notes or a vault — `--format obsidian` emits YAML frontmatter. ## when not to use this - anything that writes. it never posts, replies, follows, likes, bookmarks, or sends DMs, and takes no X credentials. - private, protected, suspended, or deleted accounts and posts. never available; no flag unlocks them. - X Lists, DMs, notifications, the personalized home timeline, account analytics. not supported. - bulk collection, backfills, or dataset building. it's rate limited and cached for one question at a time. - anything needing guaranteed completeness or an SLA. results come from public upstream providers and can lag or truncate — read `warnings` instead of assuming. ```bash bun scripts/browse-x.ts "https://x.com/handle/status/123" bun scripts/browse-x.ts profile handle bun scripts/browse-x.ts search "from:handle release" bun scripts/browse-x.ts followers handle bun scripts/browse-x.ts following handle ``` ## options markdown by default. `--json` for structured output, `--full` for metadata, `--compact` for less. use `--cursor` with the returned cursor to continue. run `bun scripts/browse-x.ts --help` for thread, feed, and other options. optional: `X_MD_API_KEY` sends a bearer key; `X_API_BASE` changes the host. never print the key. invalid or disabled keys return 401.