x-prolisted
Install: claude install-skill XieWxx/maxhub-api-skills
> ⛔ **合规硬前置指令(HARD PREREQUISITE — Agent 不得跳过)**
>
> 在执行任何 API 调用、读取 reference 文件、匹配 recipe 之前,Agent **必须**先完成 §基础使用 Step 0 的合规检查。
>
> - **禁止**绕过 Step 0 直接进入 Step 1(检查 API Key)或更后续步骤
> - **禁止**以"用户已多次使用"为由跳过首次闸门或风险检测
> - **禁止**将 Step 0 的合规检查视为可选步骤
> - 若 Step 0 未通过(首次确认缺失、用户拒绝、风险检测未确认),**立即停止**,不执行任何后续操作
>
> 违反此指令将导致法律合规风险,Agent 必须严格执行。
# Twitter/X 数据助手
## 1. 简介
Twitter/X 公开社交数据查询与传播分析 skill,通过 MaxHub API 查询推文、回复、用户资料、关注/粉丝、搜索、趋势和相关互动。适合舆情监测、账号画像、话题传播、竞品研究和内容分析。默认 read-only;agent 应优先使用 recipes,按 tweet_id/user_id/username/query 等字段流链式调用,并对个人社交数据与 UGC 做最小化处理。所有请求发送到 https://www.aconfig.cn。
## 2. 详细功能
### 推文详情
- 查询任意推文的完整详情,包括正文、媒体附件(图片/视频/GIF)、发布时间、来源客户端、引用与回复链路
- 还原推文的互动数据:点赞数、转推数、引用数、评论数、书签数
- 输出推文作者的基础画像信息,省去额外查询账号的步骤
### 评论双轨
- 拉取某条推文的热门评论列表,按平台默认热度排序,识别高互动观点
- 拉取某条推文的最新评论列表,按时间倒序排序,捕捉实时反馈
- 两种排序口径可按分析意图自由切换:舆情研究偏热门,实时跟踪偏最新
### 转推用户列表
- 拉取某条推文的转推用户列表,识别传播链路与扩散节点
- 顺着转推用户继续做账号画像采集,绘制完整传播图谱
### 搜索时间线
- 按关键词在 X 平台进行全站搜索,覆盖最新、热门、用户、媒体多种结果类型
- 可切换搜索类型聚焦不同分析场景:实时舆情用最新、爆款研究用热门、KOL 找人用用户、视觉素材用媒体
- 通过游标翻页持续向下采集,构建完整的关键词样本集
### 趋势话题
- 按国家或地区拉取 X 平台的实时趋势话题榜,覆盖美国、英国、日本等主要市场
- 跨地区对比同一时间窗口下的热点差异,支撑跨境品牌的多市场监控
### 用户画像
- 查询任意 Twitter / X 用户的完整资料,包括头像、简介、注册时间、所在地、认证状态、粉丝/关注数等
- 拉取用户发布的推文时间线,回溯完整发推记录
- 拉取用户的回复时间线(仅回复其他人的推文),分析其互动行为模式
- 拉取用户的媒体推文(仅含图片/视频的推文),快速浏览视觉内容
- 拉取用户的关注列表与粉丝列表,分析社交圈层与影响力辐射
### screen_name ↔ rest_id 互通
- 同时支持用户名(@handle)与数字账号 ID 两种入口定位用户
- 当账号改名或更换 handle 后,可继续使用稳定的数字 ID 持续追踪同一账号
### 账号余额查询
- 查询 MaxHub API 账号剩余额度,支持 `x-api-key` 或 `Authorization: Bearer` 两种认证方式