x.md (browse-x) — скилл

Скилл browse-x отдает агенту публичные посты, ветки, профили и поиск X в виде Markdown или JSON без аккаунта и ключа X.

  • 197 ★ репозитория
  • Последний коммит
Скилл

Расширенный доступ

Почему такой уровень

  • Запросы с адресами постов и поисковыми фразами уходят на сторонний сервис mdfromx.com.
Все причины и проверки

pc-style/x-md

Установка

В терминале, через 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

СкиллРасширенный доступ512Звезды репозитория
Нужен VPN

CLI для Twitter/X со скиллом для агентов: ленты, закладки, поиск и профили в терминале, плюс публикация, ответы и лайки без ключей API

CLIШирокий доступ3 тыс.Звезды репозитория

Скилл веб-поиска, поиска по X и чтения страниц для моделей без выхода в сеть: без регистрации и ключа, ответ в JSON со ссылками на источники

СкиллРасширенный доступ978Звезды репозитория

Читает твиты, ответы, ленты, списки и статьи X без входа и ключей API через команду xtf, три источника с автоматической подменой при сбое

СкиллРасширенный доступ1 тыс.Звезды репозитория

Скилл превращает ссылку в чистый Markdown через Scrapling с запасным Jina Reader, в том числе статьи WeChat, Juejin и CSDN

СкиллРасширенный доступ613Звезды репозитория

Скилл news-extractor достает из ссылки заголовок, текст, картинки и метаданные статьи с 12 новостных площадок и отдает JSON или Markdown без браузера

СкиллРасширенный доступ639Звезды репозитория

Коротко о 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.

Сообщить о проблеме