ADHX - X/Twitter 帖子阅读器
使用 ADHX API 将任何 X/Twitter 帖子获取为结构化 JSON，以便进行分析。
概述
ADHX 提供免费的 API，可返回任意 X 帖子的干净 JSON，包含完整的长文内容。这远比基于爬虫或浏览器的方法更适合 LLM 消费。支持普通推文和完整的 X 文章。
何时使用此技能
- 当用户分享 X/Twitter 链接并希望阅读、分析或总结帖子时
- 当需要从 X/Twitter 帖子中获取结构化数据（作者、互动量、内容）时
- 当处理需要完整内容提取的长篇 X 文章时
API 端点
https://adhx.com/api/share/tweet/{username}/{statusId}
URL 模式
从以下任意 URL 格式中提取 username 和 statusId：
| 格式 | 示例 |
|---|---|
x.com/{user}/status/{id} | https://x.com/dgt10011/status/2020167690560647464 |
twitter.com/{user}/status/{id} | https://twitter.com/dgt10011/status/2020167690560647464 |
adhx.com/{user}/status/{id} | https://adhx.com/dgt10011/status/2020167690560647464 |
工作流程
当用户分享 X/Twitter 链接时：
- 解析 URL 以从路径段中提取
username和statusId - 获取 JSON，使用 curl：
curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"
- 使用结构化响应 来回答用户的问题（总结、分析、提取要点等）
响应结构
{
"id": "statusId",
"url": "原始 x.com URL",
"text": "短推文文本（如果是文章帖子则为空）",
"author": {
"name": "显示名称",
"username": "用户名",
"avatarUrl": "个人资料图片 URL"
},
"createdAt": "时间戳",
"engagement": {
"replies": 0,
"retweets": 0,
"likes": 0,
"views": 0
},
"article": {
"title": "文章标题（适用于长文帖子）",
"previewText": "前约 200 个字符",
"coverImageUrl": "主图 URL",
"content": "包含图片的完整 Markdown 内容"
}
}
安装
选项 A：Claude Code 插件市场（推荐）
/plugin marketplace add itsmemeworks/adhx
选项 B：手动安装
curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md
示例
示例 1：总结推文
用户：“总结这篇帖子 https://x.com/dgt10011/status/2020167690560647464”
curl -s "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"
然后使用返回的 JSON 提供总结。
示例 2：分析互动量
用户：“这篇推文获得了多少点赞？https://x.com/handle/status/123”
- 解析 URL：username =
handle，statusId =123 - 获取：
curl -s "https://adhx.com/api/share/tweet/handle/123" - 从响应中返回
engagement.likes的值
最佳实践
- 在调用 API 之前，始终解析完整的 URL 以提取 username 和 statusId
- 当用户想要完整内容（不仅仅是推文文本）时，检查
article字段 - 当用户询问点赞、转发或浏览量时，使用
engagement字段 - 不要尝试直接爬取 x.com——而是使用此 API
备注
- 无需身份验证
- 适用于短推文和长篇 X 文章
- 始终优先使用此 API，而非基于浏览器的 X 内容爬取
- 如果 API 返回错误或空响应，请告知用户该帖子可能不可用
附加资源
限制
- 仅当任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少所需的输入、权限、安全边界或成功标准，请停止并请求澄清。