适用于 Openclaw 的 X Analytics CLI

一个稳健的只读命令行界面,用于通过 v2 API 检索和分析 X (Twitter) 数据。

bin-huang
v1.0.0
2026年4月8日
0
632
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install x-analytics-cli

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 x-analytics-cli。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 X Analytics CLI?

X Analytics CLI 是一款以开发者为中心的工具,旨在架起 AI 代理与 X (Twitter) 平台之间的桥梁。作为 Openclaw Skills 生态系统的一部分,它提供了一种结构化的方式来查询推文数据、用户资料和互动指标,无需离开终端。它利用 X API v2 并支持 OAuth 1.0a 身份验证,确保安全可靠地访问实时社交数据。

通过集成此技能,开发者可以自动化收集社交信号、执行情感分析并监控品牌提及。对于任何需要精确 X 平台指标和社交媒体时间线程序化访问的数据驱动型工作流构建者来说,此 Openclaw Skills 技能至关重要。

X Analytics CLI 应用场景

  • 监控实时品牌提及或标签以进行市场研究。
  • 分析竞争对手的粉丝增长和互动指标。
  • 随时间追踪推文数量趋势以识别病毒式话题。
  • 检索已认证的用户时间线以归档或审计社交活动。
  • 对特定推文 ID 进行深入查找以进行程序化报告。

X Analytics CLI 工作原理

  1. 用户提供查询或命令,例如搜索特定关键字或查找用户资料。
  2. CLI 使用存储的 OAuth 1.0a 凭据(包括 API 密钥和访问令牌)对请求进行身份验证。
  3. 该工具与 X API v2 端点交互以获取请求的数据,支持各种扩展和特定字段。
  4. 结果以结构化、美化的 JSON 返回,包括数据、包含项和用于分页的元数据对象。
  5. AI 代理或用户解析此输出以获取见解,或在 Openclaw Skills 框架内触发进一步的自动化操作。

X Analytics CLI 配置指南

# 通过 npm 全局安装 CLI
npm install -g x-analytics-cli

# 验证可用性
x-analytics-cli --help

# 在 ~\/.config\/x-analytics-cli\/credentials.json 配置凭据
# 或设置环境变量:X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET

X Analytics CLI 数据架构与分类体系

该技能基于 X API v2 响应规范组织数据,以实现一致性和易于解析。

组件 描述
data 主要结果,例如单条推文、用户对象或计数数组。
includes 扩展对象,例如作者详情、置顶推文或媒体元数据。
meta 元数据,包括分页令牌 (next_token) 和结果计数。
public_metrics 互动数据:点赞、转发、回复、引用和展示量。

X Analytics CLI 高级特性

  • 使用 tweet-counts 命令,通过分钟、小时或天的时间桶进行细粒度的时间序列分析。
  • 支持高级搜索查询语法,包括布尔运算符、语言过滤器和用户排除项。
  • 通过 next-token 标志进行自动分页管理,适用于大规模数据检索任务。
  • 灵活的输出格式,具有专为 shell 管道和自动化设计的精简模式。
  • 支持复杂的扩展,可在单次请求中检索关联的媒体、投票和地点详情。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*