kscz0000 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": "original x.com URL",
"text": "short-form tweet text (empty if article post)",
"author": {
"name": "Display Name",
"username": "handle",
"avatarUrl": "profile image URL"
},
"createdAt": "timestamp",
"engagement": {
"replies": 0,
"retweets": 0,
"likes": 0,
"views": 0
},
"article": {
"title": "Article title (for long-form posts)",
"previewText": "First ~200 chars",
"coverImageUrl": "hero image URL",
"content": "Full markdown content with images"
}
}
安装
方式 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 文章
- 对于 X 内容，始终优先使用此方法而非基于浏览器的爬取
- 如果 API 返回错误或空响应，请告知用户该帖子可能不可用
其他资源
限制
- 仅当任务明确符合上述描述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。