adhx

Files (1)

• SKILL.md

SKILL.md (first lines)

# ADHX - X/Twitter Post Reader

Fetch any X/Twitter post as structured JSON for analysis using the ADHX API.

## Overview

ADHX is a third-party retrieval service. It may provide structured public-post/article data; do not promise every post, full content, free access or current metrics. Verify provider availability and record retrieval time. Do not send private URLs, cookies or authentication tokens.

## When to Use This 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

## API Endpoint

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

## URL Patterns

Extract `username` and `statusId` from any of these URL formats:

| Format | Example |
|--------|---------|
| `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 --fail --show-error --silent --max-time 20 "https://adhx.com/api/share/tweet/{username}/{statusId}"
```
3. **Use the structured response** to answer the user's question (summarize, analyze, extract key points, etc.)

## Response 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"
  }
}
```

## Installation

### Option A: Claude Code plugin marketplace (recommended)
```
/plugin marketplace add itsmemeworks/adhx
```

### Option B: Manual install
```bash
# AAS already includes this skill; installing a second copy is optional.
# Review an immutable upstream revision in a private staging directory first.
# Copy into an explicitly selected host directory only if the user requested installation.
# Preserve an existing host skill instead of overwriting it silently.
```

## Examples

### Example 1: Summarize a tweet

User: "Summarize this post https://x.com/dgt10011/status/2020167690560647464"

```bash
curl --fail --show-error --silent --max-time 20 "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"
```

Then use the returned JSON to provide the summary.

### Example 2: Analyze engagement

User: "How many likes did this tweet get? https://x.com/handle/status/123"

1. Parse URL: username = `handle`, statusId = `123`
2. Fetch: `curl --fail --show-error --silent --max-time 20 "https://adhx.com/api/share/tweet/handle/123"`
3. Return the `engagement.likes` value from the response

## Best Practices

- Parse and validate an HTTPS x.com, twitter.com or adhx.com URL with the exact /<handle>/status/<decimal-ID> path. Reject embedded credentials, malformed handles/IDs and unrelated hosts instead of interpolating arbitrary input into requests
- 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

## Notes

- The illustrated endpoint historically required no authentication; do not infer access to private or deleted posts
- Works with both short tweets and long-form X articles
- Use the user-selected retrieval method; if the third-party API is unavailable, use an authorized browser/source or report that the content could not be retrieved
- If the API returns an error or empty response, inform the user the post may not be available

## Additional Resources

From sickn33/agentic-awesome-skills, MIT.

More from sickn33/agentic-awesome-skills