---

name: twitter description: Fetch tweet content (text and media) from Twitter/X URLs. Use when user asks to access, fetch, or get information from a tweet. allowed-tools: Bash

Twitter/X Tweet Fetching

Access tweet content from Twitter/X URLs using the syndication API, which works without authentication or JavaScript requirements.

Script Location

~/Repositories/scripts/skills/twitter/fetchTweet.js

Usage

Fetch Tweet by URL or ID

node ~/Repositories/scripts/skills/twitter/fetchTweet.js <tweet-url-or-id>

Examples:

# Using full URL
node ~/Repositories/scripts/skills/twitter/fetchTweet.js "https://x.com/username/status/1234567890"

# Using tweet ID only
node ~/Repositories/scripts/skills/twitter/fetchTweet.js "1234567890"

Response Format

The script outputs JSON containing tweet data:

{
  "text": "Tweet content here...",
  "user": {
    "screen_name": "username",
    "name": "Display Name"
  },
  "created_at": "timestamp",
  "favorite_count": 123,
  "retweet_count": 45,
  "photos": [
    {
      "url": "https://...",
      "width": 1200,
      "height": 675
    }
  ],
  "video": {
    "variants": [...]
  }
}

Key Fields

• text: The tweet's text content
• user.screen_name: Author's handle
• user.name: Author's display name
• photos: Array of image objects with URLs and dimensions
• video: Video data if present
• favorite_count: Number of likes
• retweet_count: Number of retweets
• created_at: Tweet timestamp

Error Handling

The script exits with error code 1 for:

• Invalid tweet ID format
• Tweet not found (404)
• Tweet tombstone (deleted/unavailable)
• API errors

Notes

• Works without Twitter API keys or authentication
• Uses Twitter's public syndication API
• Accepts both full URLs and tweet IDs
• Returns full tweet data including text, media, and metadata
• No rate limiting for this endpoint (as of implementation)