前言¶

做 X/Twitter 相关分析时，常见的做法是自己维护一套爬虫：处理登录态、应对限流、重试、解析页面结构。前端改版或接口变更都会让脚本失效。另一条路径是直接调 X 官方 API，但开发者计划（Developer Plan）的配额、沙箱权限和审核流程，对只做原型验证的团队来说成本偏高。

keyapi-twitter 这个 Skill 走的是第三条路：把查询动作收敛到一个 SKILL.md 描述的流程里，底层统一走 KeyAPI REST API，由上游负责抓取和配额。

这是什么¶

keyapi-twitter 是一个社区来源的 Agent Skill，用于分析 X/Twitter 的公开内容数据。发布者是 user_2e47cd26，在 SkillHub 上坐标为 @user_2e47cd26/keyapi-twitter-content-analytics，当前版本 1.1.2，分类为 data-analysis。

Skill 自带 “live official docs”，也就是在运行时拉取 KeyAPI 的最新官方文档，再据此构造请求。这意味着接口字段、路径、参数以文档为准，不依赖硬编码在 Skill 里的过期版本。

核心功能¶

Skill 简介列出的覆盖范围如下：

• 单条推文详情、推文串（threads）、回复、评论
• 用户资料（profiles）、时间线（timelines）
• 媒体（media）数据
• 搜索（search）、趋势（trends）
• 社区（communities）、列表（lists）、Spaces
• 招聘信息（jobs）
• 粉丝与关注列表（followers、following）、转推（retweets）、社交图谱（social graph）

覆盖面比单纯做内容抓取要宽，从单条内容一直延伸到关系数据。

安装与启用¶

已抓取资料没有提供具体的安装命令或目录约定，这里如实说明，不做推测。

根据 SkillHub 页面元数据，该 Skill 的来源标记为 community（社区），也就是说不是 SkillHub 官方维护的包。使用前需要到官方地址确认安装方式：

https://www.skillhub.cn/skills/user_2e47cd26/keyapi-twitter-content-analytics

标签里有一个关键信息：requires_api_key=true。说明运行前需要准备 KeyAPI 的 API Key，并在调用时传入。Key 的申请入口在 KeyAPI 官方站点，资料中没有给出具体地址，请自行核实。

关于 Cursor、Codex CLI、Claude Code 三种环境的安装差异，资料未提供对应说明，本文不写。

典型用法¶

已抓取资料中没有包含可复现的调用示例、请求体或响应片段。因此这里只给出推理出的调用骨架，具体路径和参数必须以 Skill 运行时拉取到的官方文档为准：

POST /v1/tweet/detail          # 推文详情，路径仅为示意
Authorization: Bearer <KeyAPI_API_KEY>

实际使用流程是：先让 Agent 读取 Skill 内的 SKILL.md，拿到「先拉文档、再按文档构造请求」的约定；然后由 Agent 调文档接口拿到当前可用的能力清单和参数表；最后带着 API Key 发起业务请求并解析返回。

适用场景与注意¶

适合的场景：需要在 Agent 工作流里做 X/Twitter 内容调研、账号关系分析、趋势追踪，且不想自己维护爬虫或申请 X 开发者权限的团队。

需要注意的几点：

• 数据来源是 KeyAPI 上游，不是 X 官方直连。涉及数据合规、字段口径、更新延迟的问题，要向上游确认。
• Requires API Key，调用前必须准备好有效的 KeyAPI 凭证，否则请求会被拒绝。
• 来源标记为 community，版本 1.1.2。社区 Skill 的更新频率和长期维护没有保障，生产环境使用前建议先在小范围数据上验证。
• Skill 评分 100000、下载 471、安装 0（截至抓取时间）。安装数为零说明当前没有公开的使用记录可参考。

结尾¶

keyapi-twitter 的价值在于把「查 X/Twitter 数据」这件事变成一次结构化调用，覆盖面从内容延伸到社交图谱。适合做原型验证和数据调研，但因为它走的是第三方上游，正式接入前要把合规和配额边界问清楚。

官方地址：https://api.skillhub.cn/user_2e47cd26/keyapi-twitter-content-analytics