# Threads Auth

> Threads 認證與帳號管理。觸發詞：登錄、登出、檢查登錄、是否已登錄、登入狀態、切換帳號、退出帳號、清除Cookie、添加帳號、新增帳號、多帳號、帳號列表、設置默認帳號、刪除帳號、check-login。

- **Type:** Skill
- **Install:** `agentstack add skill-gaojiongwenv587-beep-threads-skills-threads-auth`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gaojiongwenv587-beep](https://agentstack.voostack.com/s/gaojiongwenv587-beep)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [gaojiongwenv587-beep](https://github.com/gaojiongwenv587-beep)
- **Source:** https://github.com/gaojiongwenv587-beep/threads-skills/tree/main/threads-auth
- **Website:** https://openclaw.dev

## Install

```sh
agentstack add skill-gaojiongwenv587-beep-threads-skills-threads-auth
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

license: MIT-0
acceptLicenseTerms: true

# threads-auth — 认证管理

管理 Threads 登录状态与多账号切换。

## 前置条件：Chrome 必须先启动

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

```bash
# 启动 Chrome（默认端口 8666）
python scripts/chrome_launcher.py

# 已有实例时强制重启
python scripts/chrome_launcher.py --restart
```

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

## 登录说明

Threads 使用 **Instagram 账号**登录，Cookie 持久化在 `~/.threads/chrome-profile/`，**登录一次长期有效**，无需重复登录。

## 命令

### 检查登录状态

```bash
python scripts/cli.py check-login
```

实测返回（用户名提取有时失败，以 `logged_in` 字段为准）：
```json
{ "logged_in": true, "username": null, "message": "已登录（用户名获取失败）" }
{ "logged_in": false, "username": null, "message": "未登录，请执行 login 命令" }
```

### 登录

```bash
python scripts/cli.py login
```

执行后浏览器自动打开登录页，用户在浏览器中手动输入 Instagram 账号密码完成登录，Cookie 自动保存。登录完成后用 `check-login` 确认。

### 退出 / 切换账号

```bash
python scripts/cli.py delete-cookies
```

清除当前账号 Cookie，执行后需重新 `login`。

### 多账号管理

每个账号使用独立的 Chrome Profile 和调试端口（从 8667 递增），账号间完全隔离。

```bash
# 添加账号（自动分配端口）
python scripts/cli.py add-account --name "work" --description "工作号"

# 列出所有账号（含端口号）
python scripts/cli.py list-accounts

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

# 设置默认账号
python scripts/cli.py set-default-account --name "work"

# 删除账号
python scripts/cli.py remove-account --name "work"
```

## 决策逻辑

1. **其他操作报错"未登录"** → 先 `check-login`，未登录则引导执行 `login`
2. **用户说"检查登录"** → `check-login`
3. **用户说"登录"** → `login`，提示在浏览器完成后确认
4. **用户说"退出"/"切换账号"** → `delete-cookies` 后 `login`
5. **用户说"换个号操作"** → `--account ` 参数，无需切换 Cookie

## 失败处理

| 错误 | 原因 | 处理 |
|------|------|------|
| 连接 Chrome 失败 | Chrome 未启动或端口错误 | 运行 `python scripts/chrome_launcher.py` |
| `logged_in: false` | Cookie 过期或未登录 | 执行 `login` |
| 登录页卡住 | 可能需要 2FA 或验证码 | 引导用户在浏览器中手动处理 |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gaojiongwenv587-beep](https://github.com/gaojiongwenv587-beep)
- **Source:** [gaojiongwenv587-beep/threads-skills](https://github.com/gaojiongwenv587-beep/threads-skills)
- **License:** MIT
- **Homepage:** https://openclaw.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-gaojiongwenv587-beep-threads-skills-threads-auth
- Seller: https://agentstack.voostack.com/s/gaojiongwenv587-beep
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.