Сайты как мини-CLI: oc экономит токены Claude Code

Утилита oc превращает веб-страницу в нумерованный список ссылок и блоков для агента: по замерам проекта, шесть живых страниц обошлись в 1 936 токенов против 177 685 при сырой загрузке HTML. Код и документация опубликованы в репозитории на Github под лицензией MIT.

Коротко

• Команда oc open отдаёт агенту компактный нумерованный рендер со строкой действий, а переходы делаются по номерам: oc do 3 открывает третью ссылку, и Claude Code или Codex не работают с самим адресом.
• Без настройки инструмент читает преимущественно статические сайты, а в комплекте идут доменные сокращения для десяти площадок, включая Hacker News, GitHub, Stack Overflow через ленты Atom и Yahoo Finance.
• Ставится глобально через npm или запускается разово через npx, для Claude Code есть навык в .claude/skills, а бюджет вывода по умолчанию равен 500 токенам и меняется флагом.

Расход токенов на чтение веба остаётся заметной статьёй затрат у агентов, работающих в терминале, и разрыв между 1 936 и 177 685 токенами на одном и том же наборе страниц объясняет интерес к посредникам такого рода. Судя по описанию, ставка сделана на дешёвую эвристику вместо headless-браузера, что удерживает расход низким, но оставляет за бортом всё, что собирается на клиенте. Вероятно, ценность инструмента будет определяться тем, насколько часто агент упирается в такие страницы.

Jina Reader израсходовал 16 402 токена и не прошёл страницу Reddit

Замеры проведены на живых сайтах: главная новостного издания, обсуждение на Reddit, страница поисковой выдачи и другие, всего шесть страниц. oc оказался единственным методом, вернувшим реальное содержимое на всех шести; Jina Reader израсходовал 16 402 токена и был заблокирован на странице Reddit, а сырая загрузка HTML упёрлась в блокировку на странице поиска.

Типичная страница весит десятки тысяч токенов разметки, вывод oc укладывается в несколько сотен. Бюджет по умолчанию равен 500 токенам и меняется флагом --budget, но работает как ориентир: страницу, немного выходящую за лимит, инструмент печатает целиком, поскольку лишний вызов обходится дороже сэкономленных токенов.

Отрендеренную страницу oc сохраняет в JSON-файле сессии в каталоге ~/.only-cli, путь переопределяется переменной OC_HOME. Поэтому oc do 3 переходит по третьей ссылке, а oc find, oc read и oc next достают остаток страницы без повторного запроса, причём oc read отдаёт до 2000 токенов текста. Среди флагов есть --json, --session и --verbose с метриками в stderr.

Готовые сокращения покрывают десять сайтов, от Hacker News до Yahoo Finance

Без настройки oc работает с преимущественно статическими сайтами: новостными изданиями, блогами, документацией, форумами и поисковиками. Поверх этого в каталоге clis лежат доменные сокращения для десяти площадок: Hacker News (top, new, item, user), Reddit через old.reddit.com, GitHub, X, LinkedIn с публичными гостевыми страницами, DuckDuckGo, Bing, Stack Overflow, Yahoo Finance и YouTube.

Набор команд разный: у GitHub это repo, user, search, trending и issues, у Yahoo Finance quote, news, history, lookup, markets, gainers, losers и trending. Страницы X, Stack Overflow и YouTube, которые снаружи выглядят закрытыми логином или собранными на JavaScript, oc читает через серверный HTML, ленты Atom или встроенные данные, которые сайт отдаёт и без авторизации.

Версия v0.1 не рендерит JavaScript и не заходит на сайты за логином

Проект помечен как ранний. В версию v0.1 вошли статические страницы, рендер с учётом бюджета, офлайн-тесты, сессии и команды do, find, read и next. Рендеринга JavaScript пока нет, сайты за логином не поддерживаются, а страницы за жёсткими антибот-проверками могут отказать инструменту.

Устанавливается пакет командой npm install -g @only-cli/oc и требует Node 20 или новее. Запросы имитируют Chrome через impers, а при его отсутствии используется нативный fetch. Для Claude Code вместо установки предлагается навык: каталог skills/only-cli копируется в .claude/skills или ставится командой npx skills add only-cli/oc, которая работает и в Cursor, Codex и Copilot.

Ещё один вариант интеграции: одна строка в файле инструкций агента, CLAUDE.md, AGENTS.md или аналогичном, с указанием запускать npx @only-cli/oc open вместо загрузки сырого HTML. Глобальная установка при этом не нужна, а список команд агент получает через --help и строку действий в каждом рендере.

Сроки v0.2 и v0.3

Календарных сроков для следующих версий в описании нет: fill, submit и back отнесены к v0.2, а ленивый headless-фолбэк для страниц с тяжёлыми скриптами к v0.3. Планы по сайтам, требующим авторизации, не описаны. Заявку на новую площадку в проекте предлагают оформлять как pull request или как issue с названием сайта, порядок изложен в CONTRIBUTING.md.