aread

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         # 查看所有预设 AI 服务商

高级用法

提取页面特定部分

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

使用原则

1. agent 调用时始终加 -r：确保输出干净，没有状态消息干扰解析
2. 搜索用 --json：结构化输出更可靠，方便提取 title/url/abstract
3. 搜索词含空格用引号：-s "multi word query"
4. 合理设 timeout：读取 60s，搜索 30s，搜索+读取 120s
5. 结果数适当：agent 场景 -n 3-5 即可，太多浪费 token
6. 开启 AI 总结：配置后搜索+读取场景只输出精炼总结，大幅省 token
7. 缓存 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