xgo-fetch-tweets

推文拉取器 (Twitter Fetcher)

通过 XGo (xgo.ing) 开放接口拉取推文。支持关注者时间线、推荐、列表、标签和收藏等多种查询方式。

完整 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

API Key 绑定特定 XGo 用户账号。服务端会自动从密钥推断 userName，因此大多数请求中 userName 为可选参数。仅在 queryType=user 时需要指定 userName 以查询其他用户的公开推文。

默认拉取策略

用户未指定筛选条件时，使用以下默认值：

拉取方案（3 个并行请求）

# 1. 关注者推文 - 第1页（50条）
curl -s -X POST https://api.xgo.ing/openapi/v1/tweet/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $XGO_API_KEY" \
  -d '{"queryType":"following","timeRange":"LAST_24H","sortType":"influence","tweetType":"NO_RETWEET","currentPage":1,"pageSize":50}'

# 2. 关注者推文 - 第2页（50条）
curl -s -X POST https://api.xgo.ing/openapi/v1/tweet/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $XGO_API_KEY" \
  -d '{"queryType":"following","timeRange":"LAST_24H","sortType":"influence","tweetType":"NO_RETWEET","currentPage":2,"pageSize":50}'

# 3. 推荐推文（50条）
curl -s -X POST https://api.xgo.ing/openapi/v1/tweet/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $XGO_API_KEY" \
  -d '{"queryType":"recommendation","timeRange":"LAST_24H","sortType":"influence","tweetType":"NO_RETWEET","currentPage":1,"pageSize":50}'

并行执行所有请求。必须显式传递 sortType — 服务端默认值为 recent，本 skill 默认覆盖为 influence。

若 totalPage > currentPage，每个 queryType 最多拉取 4 页（方案中已覆盖 2 页）。若还有更多页，告知用户结果已截断，建议缩小 timeRange 或提高 influenceScore 过滤阈值。

客户端过滤说明: recommendation 查询类型服务端已强制过滤 influenceScore >= 100，>= 50 的客户端过滤实际仅作用于 following 结果。

分场景拉取方案

默认场景（关注 + 推荐）: 使用上方 3 个并行请求的方案。

用户自己的推文（queryType: "user"）:

curl -s -X POST https://api.xgo.ing/openapi/v1/tweet/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $XGO_API_KEY" \
  -d '{"queryType":"user","sortType":"recent","currentPage":1,"pageSize":100}'

收藏推文（queryType: "bookmark"）:

curl -s -X POST https://api.xgo.ing/openapi/v1/tweet/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $XGO_API_KEY" \
  -d '{"queryType":"bookmark","sortType":"recent","currentPage":1,"pageSize":100}'

参数调整

根据用户输入调整参数：

辅助端点

获取用户语言列表

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

返回可用的推文语言列表，可用于设置 lang 筛选。

获取关注者标签

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

返回关注者标签（按频率排序），可用于设置 tags 筛选。

按 ID 批量查询推文

curl -s -X POST https://api.xgo.ing/openapi/v1/tweet/batch \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $XGO_API_KEY" \
  -d '{"tweetIds":["1234567890","9876543210"]}'

从 DB 缓存中按推文 ID 批量查询。适用于重新检查已收藏或已保存的推文。

可用端点

完整请求/响应字段详情见 references/api_reference.md。

核心工作流

第一步：拉取数据（有页数上限）

按对应拉取方案并行请求。检查 totalPage，每个 queryType 最多拉取 4 页。若还有更多页，向用户说明结果已截断。

第二步：客户端过滤与去重

第三步：输出完整详情

输出每条推文的所有 API 字段。不要概括或压缩 — 下游 skill 需要完整数据进行质量评估。

输出格式

## XGo 推文列表 (YYYY-MM-DD, 近 X 时，共 N 条)

---

### 1. @username - DisplayName
- **影响力**: 85 | **互动**: 👍 446 🔁 134 💬 36 🔄 12 📑 28 👁 45K
- **语言**: en | **时间**: 2026-02-28 14:30
- **内容**:
  推文完整文本内容...
- **链接**: [查看原文](https://x.com/username/status/id)
- **标签**: #tag1, #tag2
- **提及**: @user1, @user2
- **媒体**: 📷 2 张图片 / 🎬 1 个视频
- **引用推文**: [@quoted_user: 引用推文内容摘要...]

---

### 2. @username - DisplayName
...

输出字段映射

输出完整性规则

错误处理

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

常用筛选参数速查