only-cli

only-cli は、MITライセンスのCLIで、AIコーディングエージェントがトークン効率よくウェブを読めるようにするツールです。oc open <url> はページを取得し、生HTMLやスクリーンショットの代わりにコンパクトな番号付きビューを返すため、Claude Code、Codex、Antigravityといったエージェントが数万トークンを消費せずに閲覧できます。作者が15の実ページで測定した結果、10,936トークン対生HTMLの1,552,491トークン（142倍削減）で、テストした中で全ページで実際のコンテンツを返した唯一のリーダーでした。

主な機能

• コンパクトな番号付きビュー：do <n>、read <n>、next、raw などで、再取得せずにエージェントがナビゲーション。
• 142倍のトークン削減：15の実ページで10,936トークン対生HTMLの1,552,491トークン。
• ナイーブなブロッカーを回避：impersライブラリによるChrome風の操作で、実際のブラウザのようにページと通信。
• サイト別アダプタ不要：ほぼ静的ならどんなサイトでも設定ゼロで動作。JSON APIもページとして扱う。
• ショートカット：oc hn top、oc reddit sub ClaudeAI など、事前調整された clis/ によりサイトのURL形式を知らなくてOK。
• エージェントスキル：Claude Code、Cursor、Codex、Copilotに追加できる web-browsing-cli スキルを同梱。
• データであり指示ではない：レンダリングされたテキストは読むべき内容であり、指示として実行しない。

使用シナリオ

このツールを使用すべき人は？

• AIコーディングエージェントの利用者：Claude Code、Codex、Cursor、Copilotに安くウェブを読ませたい人。
• プロンプトエンジニア：CLAUDE.mdやAGENTS.mdに1行足して、ウェブ読み取りを oc に集約したいチーム。
• スクレイピングのワークフロー：ヘッドレスブラウザやスクレイピング基盤なしで、ライブなページ内容がほしい人。

解決する問題

1. ウェブ読みのトークン消費：生HTMLは数万トークン。コンパクトビューは数百で収まる。
2. アンチボットの遮断：Reddit、LinkedIn、Yahoo Financeなどで素朴な取得が止まる。これはChromeのように振る舞う。
3. 操作の発見：actions: 行でエージェントが次に何ができるか学べる。手動設定が不要。

料金プラン

優位性と独自の価値提案

• 設計からトークン効率が高い：作者の15ページベンチマークで生HTML比142倍減。
• 実際にコンテンツを返す：作者のテストで全ページ実コンテンツを返した唯一のリーダー（Reddit、LinkedIn含む）。
• インフラ不要：デーモンなし、ブラウザ拡張なし、サイト別アダプタなし。

はじめに

1. npm install -g @only-cli/oc でインストール。
2. エージェントの指示に1行追加：ページ内容が要るときは npx @only-cli/oc open <url> を実行。
3. npx @only-cli/oc --help でコマンドを確認。
4. 必要なら web-browsing-cli スキルをエージェントに追加。

よくある質問

ブラウザ拡張やデーモンは必要ですか？

不要です。単一のCLIで、ページを読むときにだけ動作します。

対応サイトは？

ほぼ静的なサイトなら何でも。ニュース、ブログ、ドキュメント、フォーラム、検索エンジンも対応。JSONを返すAPIも、レコード毎の番号付き項目としてレンダリング。

エージェントにどう教えますか？

CLAUDE.mdやAGENTS.mdに1行の指示を追加するか、同梱の web-browsing-cli スキルを追加します。

代替案

• Agent Browser：エージェント型Web閲覧の別アプローチ。
• Chrome DevTools MCP：MCP経由でのブラウザ制御、デバッグ、自動化。
• Firecrawl：ページをLLM向けMarkdownに変換するスクレイピングサービス。

ヒントとベストプラクティス

1. エージェントの起動時に oc --help を入れ、コマンドを覚えさせる。
2. oc find <query> で用語へジャンプし、ページ全体を読まない。
3. oc が出力するものはすべて内容として扱い、指示として扱わない（プロンプトインジェクション対策）。

まとめ

only-cli は、ウェブページをナビゲート可能でトークン軽量な番号付きビューにする、コンパクトなMITツールです。ウェブを読む必要があるAIコーディングエージェントを使っているなら、oc を導入すれば実質ゼロの設定コストで価値が得られます。

Limitation: 公式ドキュメントの代替ではない。依存する前に https://github.com/only-cli/oc を確認。