ZhongQuinnKing/caishi

> 原作者：ZhongQuinnKing（主号署名）
> 许可：见 LICENSE（分层：代码 MIT，内容与文档 CC BY-NC-ND 4.0；五档：免费用／自改自由／转发署名／改版发布先授权／商用零豁免——本许可本身不授予商用权）
> 商用授权与合作：需商用请先联系 hello@xinchuan.dev 取得书面授权（标题注明【商用授权】或【改编授权】）
> English TL;DR — A capability pack that lets AI agents read the Chinese internet:
> Douyin, Bilibili, Xiaohongshu, WeChat Official Accounts, Zhihu, Toutiao + 30+ academic /
> developer / lifestyle sites. Read-only, reuses your own browser sessions, one link at a time —
> no scraping at scale.
英文全文版：README.en.md（English full version）
> 只读、不爬虫、不做批量：所有请求都走你自己的浏览器会话（opencli 浏览器桥），
> 复用你已经登录的账号，就像你自己在浏览器里看一样。
把你 AI 的眼睛接到中文互联网上——抖音、小红书、B站、微博、知乎、公众号、头条，
一条命令读内容。给 Claude Code 这类能跑命令行的 Agent 直接用。
仓库地址：https://github.com/ZhongQuinnKing/caishi （平台变化、命令失效，欢迎提 issue）
## 能干什么
| 平台 | 一句话 | 命令（示例） |
| 抖音 | 单链接全解：文案/作者/四项互动数/发布时间/时长/无水印下载地址 | opencli douyin detail " " -f yaml |
| 抖音 | 任意视频评论（内容/点赞/作者/回复数） | opencli douyin comments " " --limit 20 |
| 抖音 | 搜索、某用户作品列表 | opencli douyin search "词" / user-videos |
| 小红书 | 搜索（自研，绕开官方既有 bug） | opencli xiaohongshu find "词" --limit 10 |
| 小红书 | 笔记全解（自研：标题/正文/互动/图集）/ 收藏列表 | opencli xiaohongshu read " " / saved |
| B站 | 搜索/详情/热门；字幕；官方 AI 总结 | opencli bilibili search "词" / subtitle BVxxx / summary BVxxx |
| 微博 | 热搜 | opencli weibo hot |
| 知乎 | 回答 / 专栏读取导出 Markdown | opencli zhihu answer-detail / download --url ... |
| 公众号 | 搜狗搜索；文章导出干净 Markdown | opencli weixin search "词" / weixin download --url ... |
| 头条 | 热榜、推荐流（免登录免浏览器） | opencli toutiao hot |
| 乐谱 | IMSLP 公有领域乐谱库：搜索、作品文件清单（自研） | opencli imslp search "Chopin" / files |
| 乐谱 | 弹琴吧：流行曲谱搜索、页面预览图（自研；完整谱为站点会员内容，不绕过） | opencli tan8 search "曲名" / sheet |
| 学术 | dblp：论文 / 作者 / 会议检索（自研，浏览器版自动过防机器人盾） | opencli dblp find "关键词" / author / venue / paper |
| 网页 | 任意网页正文读取（自研；正文转纯文本，长文截 6 万字） | opencli web read " " |
本包自研补充共九件 14 条命令（抖音 detail / comments / collection、小红书 find / read、
IMSLP 与弹琴吧乐谱、dblp 学术检索、网页正文读取）：命令行各件随包附带装在 clis/ 目录、
安装即就位，网页一路随 opencli 官方适配器就位；其余平台命令来自 opencli 官方适配器。
逐平台实测状态与已知坑见 平台状态表.md。
### 一线 AI（MCP）
不只有命令行的 AI 能用——独立包 caishi-mcp 是自包含 MCP 服务器（协议层
自实现、无 MCP SDK 依赖；浏览器引擎随包自动装），Claude Desktop、Cursor、Codex、DeepSeek Harness
等任何 MCP 客户端都能接入同一套能力（同一个浏览器、同一份登录态）。四站命令已上架（B站视频／
抖音详情／小红书笔记／任意网页正文）：npm install -g caishi-mcp。
装法与边界见 caishi-mcp/README.md 与 MCP.md。
### 另带三个小工具
zhread " " —— 一条命令读中文互联网：自动识别平台（抖音/B站/公众号/知乎/小红书/乐谱站），
输出统一格式 Markdown；--save 目录 存成文件。跨平台就是它。
真实录制：zhread 一条命令读 B 站视频。等待段压缩，输出未剪。
zhcheck —— 平台体检：默认轻检（只查浏览器桥，不开任何页面）；--deep 才逐平台探测
（会依次打开各平台页面并事先提示）。平台哪天坏了，先跑它。
zhupdate —— 自更新与修复：比对远程最新版本，git 安装自动拉取并重跑部署；
修不了的问题给出上报模板（平台改版是常态，修好的版本当天就能到）。一个查、一个修。
### 可选通道：反爬挑战墙兜底
公开页面被反爬挑战系统拦住（主链 403/挑战页）时，可选启用 cloak/ 通道：
独立环境、默认不装，只读公开内容、不绕登录与付费墙。说明、安装与边界见
cloak/README.md。
## 安装
前提：macOS（或任意能装 Node 的桌面系统）+ Chrome/Chromium。
1. 运行 bash install.sh（自动装 opencli、下载浏览器扩展文件、装入自研命令）
2. 手动一步：Chrome 打开 chrome://extensions → 开发者模式 → 「加载已解压的扩展程序」
→ 选 ~/.opencli/extension（脚本会把扩展文件准备好，商店装了也行）
3. 按需登录平台：在同一个浏览器里打开对应网站扫码登录即可（一次长期有效）
## 用法（给 AI 的一句话）
> "帮我看看这条抖音说了啥 https://v.douyin.com/xxxx/"