# Send X Twitter Collector to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "x-twitter-collector",
    "name": "X Twitter Collector",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/pinotao/x-twitter-collector",
    "canonicalUrl": "https://clawhub.ai/pinotao/x-twitter-collector",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/x-twitter-collector",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x-twitter-collector",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "config.json",
      "template.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/x-twitter-collector"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/x-twitter-collector",
    "downloadUrl": "https://openagent3.xyz/downloads/x-twitter-collector",
    "agentUrl": "https://openagent3.xyz/skills/x-twitter-collector/agent",
    "manifestUrl": "https://openagent3.xyz/skills/x-twitter-collector/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/x-twitter-collector/agent.md"
  }
}
```
## Documentation

### 技能名称

x-twitter-collector

### 功能描述

自动收集指定 X/Twitter 用户在过去 24 小时内的所有推文（原创 + 转帖），生成包含中英双语、截图、链接和数据分析的完整报告。

### 使用场景

监控公众人物/企业的社交媒体动态
收集特定用户的推文用于分析或存档
生成每日/每周推文摘要报告
多语言团队需要了解 X 内容

### 前置条件

浏览器已配置：OpenClaw 浏览器工具可用
X 账号登录：建议登录 X 账号以获取完整内容（未登录可能有内容限制）
目标用户公开：目标 X 账号必须是公开账号

### 基础用法

收集 @用户名 过去 24 小时的推文

### 完整命令示例

帮我收集 @elonmusk 过去 24 小时的推文，要中英双语和截图

整理 @NASA 昨天的所有推文，带链接

### 参数说明

参数说明默认值@用户名X 账号用户名（不含 @ 也可）必填时间范围过去多少小时的内容24 小时语言报告语言中英双语截图是否包含页面截图是链接是否包含推文直链是

### 报告结构

数据概览 - 推文数量统计表格
原创推文 - 每条包含：

中英双语对照表格
发布时间和内容
互动数据（回复/转帖/点赞/浏览）
推文直链


转帖列表 - 表格形式展示
主题分析 - 按内容分类统计
数据汇总 - 总计数据
页面截图 - 完整长截图

### 输出格式

Markdown 格式，支持表格和中英对照
截图以附件形式提供
所有推文链接可点击跳转

### 步骤 1: 打开浏览器

browser.start({ profile: "openclaw" })

### 步骤 2: 访问用户主页

browser.open({ 
  profile: "openclaw", 
  targetUrl: "https://x.com/{username}" 
})

### 步骤 3: 等待页面加载

browser.act({ 
  profile: "openclaw",
  request: { kind: "wait", timeMs: 5000 },
  targetId: "{targetId}"
})

### 步骤 4: 获取页面快照

browser.snapshot({ 
  profile: "openclaw", 
  refs: "aria", 
  targetId: "{targetId}" 
})

### 步骤 5: 滚动加载更多内容

browser.act({ 
  profile: "openclaw",
  request: { kind: "evaluate", fn: "window.scrollTo(0, document.body.scrollHeight)" },
  targetId: "{targetId}"
})

### 步骤 6: 获取页面截图

browser.screenshot({ 
  profile: "openclaw", 
  fullPage: true, 
  targetId: "{targetId}",
  type: "png"
})

### 步骤 7: 解析和整理数据

从快照中提取：

推文内容（中英文）
发布时间
互动数据
推文链接
区分原创/转帖

### 步骤 8: 生成报告

按照预设模板生成完整的中英双语报告。

### 原创推文识别

不包含 "已转帖" / "Retweeted" 标识
用户头像和名称直接显示

### 转帖识别

包含 "已转帖" / "Retweeted" 标识
显示原始推文作者

### 时间解析

"X 小时前" → 过去 X 小时
"XX 月 XX 日" → 具体日期
"202X 年 X 月 X 日" → 具体日期

### 互动数据解析

回复数：💬 或 "回复"
转帖数：🔄 或 "转帖"
点赞数：❤️ 或 "喜欢"
浏览数：👁️ 或 "次浏览"

### 内容限制

X.com 对未登录用户有限制，建议登录
受保护账号的内容无法访问
被删除的推文无法获取

### 性能优化

大量推文时可能需要多次滚动
截图文件较大，注意存储空间
建议定期清理 media 目录

### 隐私和合规

仅收集公开账号内容
遵守 X 平台服务条款
不用于商业爬虫用途

### 可添加的增强功能

定时收集 - 设置 cron 定时任务
多用户对比 - 同时收集多个账号对比分析
情感分析 - 对推文内容进行情感分析
趋势统计 - 统计推文主题趋势变化
导出格式 - 支持导出为 PDF/Excel/JSON

### 自定义模板

可以根据需求修改报告模板：

仅中文或仅英文
简化版（不含截图）
详细版（包含引用推文的完整内容）

### 常见问题

问题原因解决方案浏览器无法启动浏览器配置问题检查 browser status内容加载不全页面未完全加载增加等待时间或手动滚动截图失败内存不足关闭 fullPage 或分屏截图链接无效推文已删除标注为"不可用"

### 错误处理

浏览器启动失败 → 提示用户检查浏览器配置
页面访问受限 → 提示用户登录 X 账号
快照解析失败 → 尝试重新加载页面

### 相关文件

SKILL.md - 技能说明文档（本文件）
collect.sh - 可选的命令行脚本
template.md - 报告模板文件
config.json - 配置文件（可选）

### 版本历史

v1.0 (2026-02-27) - 初始版本

基础推文收集功能
中英双语报告
页面截图支持
数据分析表格

### 作者

Generated for OpenClaw workspace

### 许可证

遵循 OpenClaw 技能许可协议
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: pinotao
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/x-twitter-collector)
- [Send to Agent page](https://openagent3.xyz/skills/x-twitter-collector/agent)
- [JSON manifest](https://openagent3.xyz/skills/x-twitter-collector/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/x-twitter-collector/agent.md)
- [Download page](https://openagent3.xyz/downloads/x-twitter-collector)