ADHX - X/Twitter 貼文讀取器
使用 ADHX API 將任何 X/Twitter 貼文擷取為結構化 JSON，便於分析。
概述
ADHX 提供一個免費 API，能針對任何 X 貼文回傳乾淨的 JSON，包含完整的長篇文章內容。這遠優於以爬蟲或瀏覽器為基礎的方式，尤其適合 LLM 使用。支援一般推文與完整的 X Articles。
何時使用此技能
- 當使用者分享 X/Twitter 連結，並希望閱讀、分析或摘要該貼文時
- 當您需要從 X/Twitter 貼文中取得結構化資料（作者、互動、內容）時
- 當處理需要完整內容擷取的長篇 X Articles 時
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": "個人頭像網址"
},
"createdAt": "時間戳記",
"engagement": {
"replies": 0,
"retweets": 0,
"likes": 0,
"views": 0
},
"article": {
"title": "文章標題（用於長篇貼文）",
"previewText": "前約 200 字",
"coverImageUrl": "主圖網址",
"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 articles
- 對於 X 內容，請務必優先使用此 API，而非瀏覽器式爬蟲
- 如果 API 回傳錯誤或空回應，請告知使用者該貼文可能無法取得
其他資源
限制
- 僅在任務明確符合上述範圍時使用此技能
- 不要將輸出視為環境特定驗證、測試或專家審查的替代方案
- 若缺少必要的輸入、權限、安全邊界或成功標準，請停止並要求澄清