threads — Threads 全功能自动化

基于 Chrome CDP 的 Threads.net 自动化工具，支持登录、浏览、发帖、互动、多账号管理和复合运营。

前置条件：Chrome 必须先启动

所有命令依赖 Chrome 调试端口，使用前确认 Chrome 已运行：

python scripts/chrome_launcher.py

Chrome 启动后会保持运行，无需每次重启。

一、认证管理

检查登录状态

python scripts/cli.py check-login

登录（Instagram 账号）

python scripts/cli.py login

浏览器自动打开登录页，手动输入账号密码后 Cookie 自动保存，长期有效。

退出 / 切换账号

python scripts/cli.py delete-cookies

多账号管理

python scripts/cli.py add-account --name "work" --description "工作号"
python scripts/cli.py list-accounts
python scripts/cli.py set-default-account --name "work"
python scripts/cli.py remove-account --name "work"

# 指定账号执行任意命令
python scripts/cli.py --account work post-thread --content "..."

二、内容发现

首页 Feed

python scripts/cli.py list-feeds
python scripts/cli.py list-feeds --limit 30

搜索

python scripts/cli.py search --query "AI"
python scripts/cli.py search --query "AI" --type recent   # 最新
python scripts/cli.py search --query "AI" --type profiles # 用户
python scripts/cli.py search --query "AI" --limit 10

帖子详情

python scripts/cli.py get-thread --url "https://www.threads.net/@user/post/xxx"

用户主页

python scripts/cli.py user-profile --username "@someuser"
python scripts/cli.py user-profile --username "someuser" --limit 20

三、内容发布

分步发布（推荐，可预览）

# 第一步：填写内容
python scripts/cli.py fill-thread --content "今天天氣真好 ☀️"

# 含图片
python scripts/cli.py fill-thread --content "今天的風景" --images "/path/photo.jpg"

# 第二步：浏览器确认后发布
python scripts/cli.py click-publish

一步发布

python scripts/cli.py post-thread --content "Hello Threads！"
python scripts/cli.py post-thread --content "今天的照片" --images "/path/photo1.jpg" "/path/photo2.jpg"

内容规则：≤ 500 字符，图片最多 10 张（JPG/PNG/GIF/WEBP），使用绝对路径。 所有 AI 生成内容一律使用繁體中文。

四、社交互动

点赞 / 取消点赞

python scripts/cli.py like-thread --url "https://www.threads.net/@user/post/xxx"

转发

python scripts/cli.py repost-thread --url "https://www.threads.net/@user/post/xxx"

回复

python scripts/cli.py reply-thread --url "https://www.threads.net/@user/post/xxx" --content "這個觀點很有意思！"

系统自动记录已回复帖子（~/.threads/replied_posts.json），防止重复回复。

关注用户

python scripts/cli.py follow-user --username "@someuser"

五、复合运营

批量互动

操作间隔 ≥ 3 秒，单次会话点赞 ≤ 50，关注 ≤ 20。

批量回复（GUI 助手）

# 1. 获取目标帖子
python scripts/cli.py search --query "關鍵詞" --type recent --limit 20

# 2. 将帖子写入临时文件，调用 GUI 助手
uv run python scripts/reply_assistant.py --posts-file /tmp/threads_batch.json

弹窗操作：發布（Ctrl+Enter）/ 跳過（Esc）/ 結束

决策逻辑

失败处理