| name | opencli |
| description | 复用用户chrome profile（有登录cookie）访问一些需要登录的网站链接，或具备防爬的网站时使用。当用户提供了 twitter，小红书，微信公众号等需要登录或反爬策略严格的网站链接时使用。 |
| version | 0.1.0 |
| author | yolanda |
Opencli
基于chrome-devtools封装的cli命令工具，复用用户电脑的chrome profile，访问一些具备防爬手段的一些网站，例如 twitter，小红书，微信公众号等，基本涵盖大部分主流网站与electron app。需要借助附带的一个浏览器插件做跳板。
该工具仅在 web_search ，web_fetch 无法访问时使用。
首次使用若 opencli / chrome profile / cdp alias 未就绪，按 references/first-time-setup.md 引导用户配置。
User Input Tools
当本 skill 需要提示用户时，按此工具选择规则（优先级顺序）：
- 优先使用当前 agent runtime 内置的用户输入工具 — 如
AskUserQuestion、request_user_input、clarify、ask_user、questionnaire 或等效工具。
- 回退到纯文本：若无此类工具，输出编号的纯文本消息，让用户回复选择的编号/答案。
- 批量规则：若工具支持单次调用多个问题，将所有适用问题合并为一次调用；若仅支持单问题，按优先级逐个提问。
下文对 AskUserQuestion 的具体提及均为示例 — 其他 runtime 按规则替换为本地等效工具。
使用指导
- 状态检查
- opencli doctor 检查与 chrome 是否正常
- opencli依赖一个chrome插件作为跳板，若opencli提示插件未连接（Extension: not connected），可使用 alias 命令
cdp 快速启动一个带用户登录cookie的chrome实例。
- 若碰到下面某个页面 无法访问，或cookie失效时，告知用户，让用户登录对应网站后再操作
- 安全执行
- 因使用该命令需要访问的网站大多有反爬措施，避免短期/大规模/批量的采集，每次查询操作间隔保持5秒以上
- 避免重复开启 页面 / chrome 进程，访问基于浏览器 的 opencli 命令时优先考虑复用同一个进程与标签页，参数后面必须带上：--site-session persistent --keep-tab true --window foreground
同站点复用通标签：
--site-session， persistent 复用 ； ephemeral 不复用（default）
命令结束后保持标签页：--keep-tab，true 保持页面； false 关闭页面（default）
前台/后台操作： --window，foreground 前台； background 后台（default）
- 当任务完成，且确定当前会话不再需要使用opencli时，关闭通过 cdp 启动的进程。
- 优先使用 -f json 格式输出结果，并用jq查询内容，避免必不要的上下文消耗
- 避免临时文件
- opencli使用过程中下载的临时文件，在任务完成后及时清理，避免遗留中间产物
- 网页如果遇到未登录或 cookie 过期
- 告知用户需要登录或者授权过期，请求用户协助登录，并在用户登录后继续任务
基本命令
- 命令格式：opencli [options] [command]
- 检查连接状态：opencli doctor
- 查看可用命令：opencli list，注意：由于支持的command比较多，list 命令尽量避免频繁使用
- 支持命令带 -h 查看帮助说明
小红书
注意：小红书分为 rednote 海外版本 与 xiaohongshu 国内版本，根据用户实际登录账号选择，下面以 rednote 为例，可以直接替换为 xiaohongshu
平台登录
- 输入：无
- 输出：登录状态，status, logged_in, site, user_id, nickname
- 命令：opencli rednote login [options]
- 说明：若当前返回未登录，提醒用户协助登录，第一次打开该平台时使用
笔记搜索
- 输入：关键词
- 输出： 笔记列表，包含：rank, title, author, likes, published_at, url, author_url
- 命令：opencli rednote search [keyword] [options]
查看笔记
- 输入：笔记 url 地址（with xsec_token）
- 输出：笔记详情 field, value，包括：title, author, content, like, collects, comments, tags
- 命令：opencli rednote note [url] [options]
查看评论
- 输入：笔记 url 地址
- 输出：评论内容，包括：rank, author, text, likes, time, is_reply, reply_to
- 命令：opencli rednote comments [url] [options]
下载图片/视频
- 输入：笔记 url 地址
- 输出：视频/图片文件，保存位置为 {output}/{note_id}/*.mp4 或 *.jpg
- 命令：opencli rednote download [url] [options]
- 说明：如果需要增加超时时长 --timeout, 正常可能会下载两个一样的 不同分辨率的文件，只需要取小的那个(*_2.mp4) 分析 |
微信公众号
该命令仅支持下载（不支持直接查看），如果不需要的话注意清理
公众号搜索
- 输入：关键词
- 输出：文章搜索摘要内容
- 命令：opencli weixin search [options]
- 常用options：
- --page [value] 结果页码，从 1 开始 default: 1
- --limit [value] 返回条数，最大 10 default: 10
公众号文章下载
- 输入：文章 url 地址
- 输出：文章内容，图片（可选）
- 命令：opencli weixin download --url [url] --output [value] --download-images [value]
Twitter
平台登录
- 输入：无
- 输出：登录状态，status, logged_in, site, user_id, nickname
- 命令：opencli twitter login [options]
- 说明：若当前返回未登录，提醒用户协助登录，第一次打开该平台时使用
搜索内容
- 输入：搜索条件，支持 Raw X operators (e.g. "exact phrase", #tag, OR, lang:en, since:YYYY-MM-DD, from:, since:)
- 输出：id, author, bio, text, created_at, likes, views, url, has_media, media_urls, card, quoted_tweet
- 命令：opencli twitter search [options]
- 常用options：
- --limit [value] 搜索数量限制，默认 15
- --product [value] 搜索类型(top (default), live (Latest), photos, video)
- --top-by-engagement [value] 按照热度过滤(likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) ，默认 0 不过滤
阅读完整内容（带评论）
- 输入：twitter id 或原文链接
- 输出：正文+评论
- 命令：opencli twitter thread [options]
- 常用options：
- --limit [value] 限制返回评论数量，默认 50
- --top-by-engagement 同搜索
下载长文内容
- 输入：twitter id 或原文链接
- 输出：原文
- 命令：opencli twitter article [options]
reddit
搜索
- 输入：关键词
- 输出：帖子概览内容
- 命令：opencli reddit-api search [options]
阅读帖子
- 输入：post id 或 url
- 输出：type, author, score, text
- 命令：opencli reddit-api read [options]
subreddit 帖子查看
- 输入：subreddit 名称
- 输出：帖子概览内容
- 命令：opencli reddit-api subreddit [options]
知识星球
最新内容（feeds）
- 输入：group id
- 输出：topic_id, type, author, title, comments, likes, time, url
- 命令：opencli zsxq topics [options]
- 常用options：
- --limit [value] 返回结果数量，默认20
- --group_id [value] 默认当前激活group，一般第一次调用时建议带上该参数，后续统一会话里可以省略
搜索
- 输入：关键词
- 输出：topic_id, group, author, title, comments, likes, time, url
- 命令：opencli zsxq search [options]
- 常用options：同查询最新内容
查询完整内容&评论
一般如果搜索，得到content以及不完整，且需要进一步深入查看完整内容时使用
- 输入：topic id
- 输出：topic_id, type, author, title, comments, likes, comment_preview, url
- 命令：opencli zsxq topic [options]
- 常用options：
- --comment_limit [value] 返回的评论数量，默认 20
其他一些优质内容渠道
substack
- 搜索：opencli substack search (无需浏览器)
- 常用options：--type [value] 搜索类型（posts=文章, publications=Newsletter） default: posts choices: posts, publications
- 查看并下载某篇内容：opencli web read --url "" --output ""
HackerNews
- 搜索：opencli hackernews search
- 查看：opencli hackernews read
Youtube
- 搜索：opencli youtube search [options]
- 查看视频的metadata：opencli youtube video "" 注意url 一定要带引号
- 获取视频字幕：opencli youtube transcript "" [options]
通用网页内容获取
- 网页内容下载：opencli web read --url "" --output ""
