chrome-use-sites

English · 中文

The official chrome-use site adapter source. It contains adapters maintained by the chrome-use project, including ones for internal or self-hosted services that do not belong in the public epiral/bb-sites community source.

A site adapter is a small JS function with a /* @meta {…} */ header. chrome-use site <name>/<cmd> navigates to the adapter's domain in your own logged-in tab and runs the function there, returning structured JSON — no scraping, no screenshots, and it works behind auth/VPN because it runs as you.

chrome-use has two built-in adapter sources:

• Community: epiral/bb-sites
• Official: leeguooooo/chrome-use-sites

Both are fetched automatically on first use and by chrome-use site update. The official pack is synced last, so it wins a name both packs have. No site add or separate installer is required in versions containing chrome-use#133.

chrome-use can also run some commands from OpenCLI (@jackwener/opencli), but only names neither pack has: an adapter here always takes priority over OpenCLI's command of the same name. Commands we rely on are ported here and maintained here instead of being run from OpenCLI: douyin/delete, douyin/update, twitter/delete, twitter/like, twitter/follow, bilibili/user-videos and bilibili/creator-stats, under OpenCLI's Apache-2.0 license with attribution (see each pack's README).

Install and update

chrome-use site update
chrome-use site sources
chrome-use site list | grep '^sggit/'

For chrome-use v1.5.77 and earlier, use the legacy installer:

curl -fsSL https://raw.githubusercontent.com/leeguooooo/chrome-use-sites/main/install.sh | sh

Adapters run in your logged-in browser tab, so sign in to the target site first (and connect VPN/WARP if it's internal).

Packs

Each pack documents itself in its own folder, in English (README.md) and Chinese (README.zh.md).

pack	site	adapters
twitter/	x.com	search, thread, user, post, delete, like, follow	read + post + delete + like/follow
xiaohongshu/	www.xiaohongshu.com	me	read
xiaohongshu-creator/	creator.xiaohongshu.com	me, notes, note-stats	read
douyin-creator/	creator.douyin.com	me, works, video-publish, cover-select	read + publish
douyin/	creator.douyin.com	delete, update	delete + edit works
bilibili/	www.bilibili.com · member.bilibili.com	user-videos, creator-stats	read
bilibili-creator/	member.bilibili.com	video-publish, cover-select, cover-ai	publish
youtube-studio/	studio.youtube.com	channel, video-upload	read + publish
wechat-channels/	channels.weixin.qq.com	cover-select	new-draft cover selection
juejin/ · csdn/ · segmentfault/ · zhihu/	Chinese dev platforms	article-publish	publish
chatgpt/	chatgpt.com	me, conversations, conversation, projects, models, images, open-project	read (+ open project)
appstoreconnect/	appstoreconnect.apple.com	apps, app-create, builds	read + create
si12333/	si.12333.gov.cn	pension-payments	read
hackernews/	news.ycombinator.com	top, thread	read
sggit/	sg-cy-git.caminonode.com (self-hosted Gogs)	pr-create, pr-list, pr-merge	read + write
zentao/	zentao.pwtk.cc (self-hosted ZenTao)	bugs, bug, bug-image, bug-comment, bug-resolve	read + image upload + comment + resolve

Changes are logged in CHANGELOG.md. Contribution rules, required for every PR: CONTRIBUTING.md.

Adding an adapter

Read CONTRIBUTING.md first: every change updates the pack's README.md and README.zh.md and adds a CHANGELOG.md entry, and CI fails the PR otherwise.

Drop packname/command.js in this repo and follow the shape of the existing files. Current chrome-use versions discover .js adapters directly from the repository tree. Also add the path to PACKS in install.sh while the legacy v1.5.77 installer remains supported.

/* @meta
{ "name": "packname/command", "domain": "host.example.com",
  "args": { "foo": {"required": true, "description": "…"} },
  "capabilities": ["network"], "readOnly": true }
*/
async function (args) {
  // runs in the logged-in tab on `domain`; same-origin fetch has cookies.
  return { /* structured JSON */ };
}

Avoid arg names that collide with chrome-use global flags (state, profile, session, timeout, url, fn, …).

License

MIT, see LICENSE. Contributions are accepted under the same license. Exception: the files ported from OpenCLI (douyin/delete.js, douyin/update.js, twitter/delete.js, twitter/like.js, twitter/follow.js, bilibili/user-videos.js, bilibili/creator-stats.js) stay under the Apache License 2.0, with its text next to them (LICENSE-OpenCLI) and a header in each file saying what changed.