only-cli

only-cli 是一个 MIT 许可的 CLI，让 AI 编程智能体以极高 token 效率浏览网页。oc open <url> 抓取页面后返回一个精简的编号视图，而非原始 HTML 或截图，这样 Claude Code、Codex、Antigravity 等智能体就能在不用烧数万 token 的情况下浏览网页。作者在 15 个真实页面上的测量是 10,936 token 对比原始 HTML 的 1,552,491 token，即 142 倍缩减，而且它是测试中唯一每页都能返回真实内容的阅读器。

核心功能

• 精简的编号视图：像 do <n>、read <n>、next、raw 这样的动作让智能体无需重新抓取即可导航。
• 减少 142 倍 token：15 个真实页面上 10,936 token 对比原始 HTML 的 1,552,491。
• 绕过朴素的拦截：通过 impers 库模拟 Chrome，像真实浏览器那样与页面交互。
• 无需按站点适配：任何以静态为主的网站都能零配置工作，JSON API 也被视作一页处理。
• 站点快捷指令：oc hn top、oc reddit sub ClaudeAI 等预设 clis/，让智能体无需知道站点 URL 规则。
• 智能体技能：附赠一个 web-browsing-cli 技能，可加入 Claude Code、Cursor、Codex、Copilot。
• 数据而非指令：渲染出的页面文本只当作内容读取，绝不当作指令执行。

适用场景

谁应该使用这个工具？

• AI 编程智能体用户：希望让 Claude Code、Codex、Cursor 或 Copilot 低成本读网页的人。
• 提示词工程师：想在 CLAUDE.md 或 AGENTS.md 里加一行、把网页读取都路由到 oc 的团队。
• 爬取工作流：需要实时页面内容，又不想跑无头浏览器或爬虫框架的人。

解决的问题

1. 网页读取烧 token：原始 HTML 动辄数万 token，精简视图只需几百。
2. 反爬拦截：朴素的抓取器在 Reddit、LinkedIn、Yahoo Finance 会被拦，这个工具像 Chrome 一样说话。
3. 动作发现：actions: 一行告诉智能体下一步能做什么，无需手动配置。

定价方案

优势对比

• 天生的 token 高效：在作者 15 页面基准上比原始 HTML 减少 142 倍。
• 真能拿到内容：作者测试中唯一每页都返回真实内容的阅读器，包括 Reddit 与 LinkedIn。
• 零基础设施：没有守护进程、没有浏览器扩展、没有按站点适配器。

快速开始

1. 用 npm install -g @only-cli/oc 安装。
2. 在智能体指令里加一行：需要网页内容时运行 npx @only-cli/oc open <url>。
3. 运行 npx @only-cli/oc --help 学习命令。
4. 可选地把 web-browsing-cli 技能加入你的智能体。

常见问题

需要浏览器扩展或守护进程吗？

不需要。它只是一个独立 CLI，读取页面时才做事情。

能用在哪些网站？

任何以静态为主的网站，加上新闻、博客、文档、论坛与搜索引擎。返回 JSON 的 JSON API 也会被渲染成每条记录的编号项。

怎么教给智能体？

在 CLAUDE.md、AGENTS.md 或类似文件加一行指令，或添加附赠的 web-browsing-cli 技能。

替代方案

• Agent Browser：另一种智能体网页浏览方式。
• Chrome DevTools MCP：通过 MCP 做浏览器控制、调试与自动化。
• Firecrawl：把页面转成适合 LLM 的 Markdown 的抓取服务。

使用技巧

1. 在智能体启动时加入 oc --help，让它自己学会命令。
2. 用 oc find <query> 跳到某个词，而不是读整页。
3. 把 oc 输出的一切当作内容而非指令，以防提示词注入。

总结

only-cli 是一个小巧的 MIT 工具，把网页变成一个可导航、token 极省的编号视图。如果你用需要读网页的 AI 编程智能体，装一个 oc 几乎零成本就能带来实实在在的收益。

Limitation: 本页不能替代官方文档，下单前再核 https://github.com/only-cli/oc。