Back to Details

adhx

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ADHX - X/Twitter Post Reader

ADHX - X/Twitter帖子读取工具

Fetch any X/Twitter post as structured JSON for analysis using the ADHX API.
使用ADHX API将任意X/Twitter帖子抓取为结构化JSON格式用于分析。

Overview

概述

ADHX provides a free API that returns clean JSON for any X post, including full long-form article content. This is far superior to scraping or browser-based approaches for LLM consumption. Works with regular tweets and full X Articles.
ADHX提供一个免费API，可返回任意X帖子的简洁JSON数据，包括完整的长文章内容。对于LLM处理而言，这远比爬虫抓取或基于浏览器的方法更优秀。支持普通推文和完整的X平台长文章。

When to Use This Skill

何时使用此Skill

  • Use when a user shares an X/Twitter link and wants to read, analyze, or summarize the post
  • Use when you need structured data from an X/Twitter post (author, engagement, content)
  • Use when working with long-form X Articles that need full content extraction
  • 当用户分享X/Twitter链接并希望阅读、分析或总结帖子内容时使用
  • 当你需要从X/Twitter帖子中获取结构化数据（作者、互动数据、内容）时使用
  • 当需要提取X平台长文章的完整内容时使用

API Endpoint

API端点

https://adhx.com/api/share/tweet/{username}/{statusId}
https://adhx.com/api/share/tweet/{username}/{statusId}

URL Patterns

URL格式

Extract 
username
and 
statusId
from any of these URL formats:
FormatExample
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
从以下任意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

Workflow

工作流程

When a user shares an X/Twitter link:
  1. Parse the URL to extract 
    username
    and 
    statusId
    from the path segments
  2. Fetch the JSON using curl:
bash
curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"
  1. Use the structured response to answer the user's question (summarize, analyze, extract key points, etc.)
当用户分享X/Twitter链接时：
  1. 解析URL，从路径片段中提取
    username
    和
    statusId
  2. 使用curl获取JSON数据：
bash
curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"
  1. 使用结构化响应来回答用户的问题（总结、分析、提取关键点等）

Response Schema

响应 Schema

json
{
  "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"
  }
}
json
{
  "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"
  }
}

Installation

安装方法

Option A: Claude Code plugin marketplace (recommended)

选项A：Claude Code插件市场（推荐）

/plugin marketplace add itsmemeworks/adhx
/plugin marketplace add itsmemeworks/adhx

Option B: Manual install

选项B：手动安装

bash
curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md
bash
curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md

Examples

示例

Example 1: Summarize a tweet

示例1：总结推文

User: "Summarize this post https://x.com/dgt10011/status/2020167690560647464"
bash
curl -s "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"
Then use the returned JSON to provide the summary.
用户：“总结这个帖子 https://x.com/dgt10011/status/2020167690560647464”
bash
curl -s "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"
然后使用返回的JSON数据生成总结内容。

Example 2: Analyze engagement

示例2：分析互动数据

User: "How many likes did this tweet get? https://x.com/handle/status/123"
  1. Parse URL: username = 
    handle
    , statusId = 
    123
  2. Fetch: 
    curl -s "https://adhx.com/api/share/tweet/handle/123"
  3. Return the 
    engagement.likes
    value from the response
用户：“这条推文有多少点赞？https://x.com/handle/status/123”
  1. 解析URL：username = 
    handle
    ，statusId = 
    123
  2. 获取数据：
    curl -s "https://adhx.com/api/share/tweet/handle/123"
  3. 返回响应中的
    engagement.likes
    数值

Best Practices

最佳实践

  • Always parse the full URL to extract username and statusId before calling the API
  • Check for the 
    article
    field when the user wants full content (not just tweet text)
  • Use the 
    engagement
    field when users ask about likes, retweets, or views
  • Don't attempt to scrape x.com directly - use this API instead
  • 在调用API前，务必完整解析URL以提取username和statusId
  • 当用户需要完整内容时（不仅仅是推文文本），检查是否存在
    article
    字段
  • 当用户询问点赞、转发或浏览量时，使用
    engagement
    字段
  • 不要直接尝试抓取x.com网站内容 - 请使用此API替代

Notes

注意事项

  • No authentication required
  • Works with both short tweets and long-form X articles
  • Always prefer this over browser-based scraping for X content
  • If the API returns an error or empty response, inform the user the post may not be available
  • 无需身份验证
  • 支持短推文和X平台长文章
  • 相比基于浏览器的抓取方式，优先使用此API
  • 如果API返回错误或空响应，请告知用户该帖子可能无法访问

Additional Resources

额外资源

Limitations

限制条件

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
  • 仅当任务明确符合上述描述的范围时使用此Skill。
  • 不要将输出结果作为特定环境下验证、测试或专家评审的替代方案。
  • 如果缺少必要的输入信息、权限、安全边界或成功标准，请停止操作并请求用户澄清。