xgo-manage-follows

关注管理器 (XGo Manage Follows)

通过 XGo (xgo.ing) 开放接口管理和分析 Twitter/X 关注列表 — 查看关注、刷新数据、检查关注状态、统计分析、推荐关注/取消关注。

完整 API 参数详情见 references/api_reference.md。

认证

所有请求需要 X-API-KEY 请求头。从环境变量 XGO_API_KEY 读取密钥：

-H "X-API-KEY: $XGO_API_KEY"

若 XGO_API_KEY 未设置，提示用户配置。

接口地址：https://api.xgo.ing

可用端点

核心工作流

场景 A: 查看关注列表

分页查看关注列表：

curl -s "https://api.xgo.ing/openapi/v1/following/list?page=1&size=50" \
  -H "X-API-KEY: $XGO_API_KEY"

字段名说明: following/list 返回的 UserDTO 中自定义标签字段为 markTags，自定义备注字段为 markNotes；而 following/status 返回的 FollowingStatusDTO 中对应字段名为 tags 和 remark。两者含义相同，但字段名不同。

场景 B: 刷新关注列表

从 Twitter API 异步刷新关注列表数据：

curl -s -X POST "https://api.xgo.ing/openapi/v1/following/refresh" \
  -H "X-API-KEY: $XGO_API_KEY"

刷新间隔限制:

场景 C: 检查是否关注某用户

curl -s "https://api.xgo.ing/openapi/v1/following/status?targetUserName=elonmusk" \
  -H "X-API-KEY: $XGO_API_KEY"

返回：

场景 D: 查看关注统计

curl -s "https://api.xgo.ing/openapi/v1/following/stats" \
  -H "X-API-KEY: $XGO_API_KEY"

返回：

场景 E: 查看关注标签

curl -s "https://api.xgo.ing/openapi/v1/following/tags" \
  -H "X-API-KEY: $XGO_API_KEY"

返回按计数倒序排列的标签列表，每项包含 tag（标签名）和 count（使用该标签的关注用户数）。

场景 F: 关注分析报告

综合使用多个端点生成完整的关注分析报告。并行执行以下请求：

# 1. 关注统计
curl -s "https://api.xgo.ing/openapi/v1/following/stats" \
  -H "X-API-KEY: $XGO_API_KEY"

# 2. 关注标签分布
curl -s "https://api.xgo.ing/openapi/v1/following/tags" \
  -H "X-API-KEY: $XGO_API_KEY"

# 3. 关注列表（第一页）
curl -s "https://api.xgo.ing/openapi/v1/following/list?page=1&size=50" \
  -H "X-API-KEY: $XGO_API_KEY"

场景 G: 推荐关注

获取系统推荐的值得关注的用户（最近活跃、尚未关注的热门用户，按粉丝数升序，最多 20 人）:

curl -s "https://api.xgo.ing/openapi/v1/following/suggest-follow" \
  -H "X-API-KEY: $XGO_API_KEY"

返回 List<UserDTO>（完整用户资料），最多 20 人。

交互流程:

# 关注单个用户
curl -s -X POST "https://api.xgo.ing/openapi/v1/following/follow?targetUserName=TARGET_USER" \
  -H "X-API-KEY: $XGO_API_KEY"

返回 true 表示关注成功。

场景 H: 推荐取消关注

获取系统推荐取消关注的用户（粉丝 ≤100 或 60 天无推文的不活跃用户，按粉丝数升序，最多 50 人）:

curl -s "https://api.xgo.ing/openapi/v1/following/suggest-unfollow" \
  -H "X-API-KEY: $XGO_API_KEY"

返回 List<UserDTO>（完整用户资料），最多 50 人。

交互流程:

# 取消关注单个用户
curl -s -X POST "https://api.xgo.ing/openapi/v1/following/unfollow?targetUserName=TARGET_USER" \
  -H "X-API-KEY: $XGO_API_KEY"

返回 true 表示取关成功。

参数调整

根据用户输入调整参数：

输出格式

关注列表

## 我的关注列表 (共 N 人，第 M/P 页)

| # | 用户名 | 显示名 | 标签 | 备注 |
|---|--------|--------|------|------|
| 1 | @elonmusk | Elon Musk | AI, Tech | |
| 2 | @sama | Sam Altman | AI, Startup | OpenAI CEO |
| 3 | @naval | Naval | Startup, Investing | |

关注状态

✅ 你已关注 @elonmusk
- **标签**: AI, Tech
- **备注**: Tesla & SpaceX CEO

❌ 你未关注 @unknown_user

关注统计

## 关注统计

- **总关注数**: 356
- **列表数**: 8
- **已分类**: 280 (78.7%)
- **未分类**: 76 (21.3%)

### 列表分布

| 列表名称 | 成员数 |
|---------|--------|
| AI Researchers | 45 |
| Web3 Builders | 38 |
| Startup Founders | 32 |
| Tech News | 28 |

标签分布

## 关注标签分布

| 标签 | 用户数 |
|------|--------|
| AI | 89 |
| Tech | 72 |
| Startup | 56 |
| Web3 | 34 |
| Investing | 28 |

推荐关注

## 推荐关注 (共 N 人)

| # | 用户名 | 显示名 | 简介 | 粉丝 | 系统标签 |
|---|--------|--------|------|------|----------|
| 1 | @user1 | User One | AI researcher... | 12.5K | AI, ML |
| 2 | @user2 | User Two | Full-stack dev... | 8.3K | Dev, Web |
| ... | ... | ... | ... | ... | ... |

是否要关注其中的某些用户？请指定编号（如"关注 1, 3, 5"），或输入"全部"/"跳过"。

推荐取消关注

## 推荐取消关注 (共 N 人)

| # | 用户名 | 显示名 | 粉丝 | 最近推文 | 原因 |
|---|--------|--------|------|---------|------|
| 1 | @user1 | User One | 15 | 无推文 | 粉丝过少 |
| 2 | @user2 | User Two | 82 | 65 天前 | 长期不活跃 |
| ... | ... | ... | ... | ... | ... |

是否要取消关注其中的某些用户？请指定编号（如"取关 1, 2, 4"），或输入"全部"/"跳过"。

关注/取关执行结果

## 批量关注执行结果

### 第 1 批 (1-5)
- ✅ @user1 — 关注成功
- ✅ @user2 — 关注成功
- ❌ @user3 — 失败：用户不存在
- ✅ @user4 — 关注成功
- ✅ @user5 — 关注成功

### 第 2 批 (6-8)
- ✅ @user6 — 关注成功
- ✅ @user7 — 关注成功
- ✅ @user8 — 关注成功

**统计**: 成功 7 / 失败 1 / 共 8 人

刷新结果

✅ 关注列表刷新已启动（异步执行，稍后生效）
⚠️ 距上次刷新不足 15 天（PLUS 会员），请稍后再试

输出完整性规则

错误处理

重要: 始终先检查 response.success 再处理 response.data。部分错误返回 HTTP 200 但 success: false — 不要仅依赖 HTTP 状态码。

批量操作错误处理

关注/取关批量操作中，每次调用 following/follow 或 following/unfollow 后必须检查 response.success:

空结果处理