| name | aread |
| description | 当用户或 agent 需要联网获取信息时使用此 skill。触发场景包括：读取网页内容、将 URL 转为 Markdown、 联网搜索、查资料、查看在线文档、搜索技术问题、AI 总结网页内容。关键词：搜索、search、联网、网页、URL、read url、 在线、查一下、搜一下、读一下这个链接、这个网页说了什么、帮我查、网上找找、搜搜看、总结、summarize。 也适用于 agent 自身在解决问题过程中需要查阅在线文档、API 文档、技术博客、GitHub README 等外部资源的场景。 aread 是一个零依赖、无需 API Key 的 CLI 工具，支持网页读取（基于 Jina Reader）、多引擎搜索 （DuckDuckGo/Bing）、AI 内容总结（OpenAI 兼容 API）和知乎文章自动抓取，专为 AI agent 设计， 输出结构化的 Markdown 或 JSON。
|
aread — 联网搜索、网页读取与 AI 总结
aread 是一个全局安装的 CLI 工具（bun i -g aread-cli），无需 API Key（AI 总结除外），无需 Python，
专为 AI agent 设计——一条命令完成网页读取、联网搜索或 AI 总结。
开源地址：https://github.com/Crosery/aread
快速决策
根据用户需求选择命令模式：
用户给了 URL / 链接 → 读取模式
用户要搜索 / 查东西 → 搜索模式
用户要搜索并深入了解 → 搜索+阅读模式
用户要全面搜索 → 多引擎搜索模式
用户要总结某个页面 → 读取 + AI 总结
核心命令
1. 读取网页
将任意 URL 转为干净 Markdown，适合 agent 直接消费。
aread <URL> -r
-r 必须加：去除状态消息，输出纯净 Markdown，agent 解析必备- URL 可省略
https://，工具会自动补全
- Bash tool timeout 建议
60000（部分页面加载较慢）
示例：
aread https://docs.python.org/3/tutorial -r
aread github.com/vercel/next.js -r
2. 读取 + AI 总结
获取网页内容后由 AI 精炼关键信息，保留 90% 信息量，去掉废话和噪音。
aread <URL> -r -S
-S 或 --summarize：触发 AI 总结- 如果
ai.autoSummarize 设为 true，每次 fetch 自动总结，无需 -S
- 用
--no-summarize 临时关闭自动总结
- 需要先配置 AI：
aread config init
3. 搜索
联网搜索，返回结构化结果。
aread -s "搜索关键词" -n 5 --json
--json 输出结构化 JSON：[{ title, url, abstract }, ...]-n 控制结果数量，agent 场景建议 3-5 条以节省 token- 搜索词含空格时用引号：
-s "query with spaces"
- Bash tool timeout 建议
30000
引擎选择指南：
| 场景 | 参数 | 说明 |
|---|
| 通用 / 默认 | 不加 -e | 自动探测 DuckDuckGo，失败回退 Bing |
| 需要全面覆盖 | --multi（或 -m） | 双引擎并发，去重合并 |
4. 搜索 + 读取结果页面
搜索后自动读取所有结果页面的正文内容，一步完成。
aread -s "搜索关键词" --read -c 5 -n 10
--read 搜索后读取每个结果的页面内容-c 并发读取数，默认 5；网络不稳定时降到 2-3- 开启 AI 总结后，只输出总结不输出原文，大幅节省 token
- Bash tool timeout 建议
120000（需读取多个页面）
5. 知乎文章/问答
自动从浏览器提取 cookie，零配置读取知乎内容。
aread https://zhuanlan.zhihu.com/p/696916846 -r
aread https://www.zhihu.com/question/123456 -r
- macOS 自动从 Chrome/Arc/Edge/Brave 提取 cookie
- 支持文章、问答页面、特定回答
- 需要在浏览器中登录知乎
6. AI 配置管理
aread config init
aread config show
aread config providers
高级用法
提取页面特定部分
aread <URL> -r -H "X-Target-Selector:article"
保留链接或图片
aread <URL> -r -H "X-With-Links:true"
aread <URL> -r -H "X-With-Images:true"
保存到文件
aread <URL> -r -o output.md
aread -s "关键词" --read -o research.md
使用原则
- agent 调用时始终加
-r：确保输出干净，没有状态消息干扰解析
- 搜索用
--json：结构化输出更可靠，方便提取 title/url/abstract
- 搜索词含空格用引号：
-s "multi word query"
- 合理设 timeout：读取 60s，搜索 30s，搜索+读取 120s
- 结果数适当：agent 场景
-n 3-5 即可，太多浪费 token
- 开启 AI 总结：配置后搜索+读取场景只输出精炼总结，大幅省 token
- 缓存 24h 过期：结果自动缓存到
~/.cache/aread/，需要最新内容时加 --no-cache
典型场景示例
场景 1：用户给了一个链接，想知道内容
aread https://example.com/article -r
然后基于输出内容回答用户问题。
场景 2：用户想搜索某个技术问题
aread -s "Next.js App Router vs Pages Router" -n 5 --json
解析 JSON 结果，提取相关摘要回答用户。
场景 3：用户需要深入研究某个主题
aread -s "Rust 异步编程" --read -n 3 -c 3
一次搜索并读取所有结果页面，综合分析后给出答案。
场景 4：用户要看知乎上的讨论
aread https://www.zhihu.com/question/123456 -r
自动提取问题和所有高赞回答。
场景 5：agent 自身需要查阅在线文档
aread -s "React useEffect cleanup" -n 3 --json
aread https://react.dev/reference/react/useEffect -r
