mcpField
F
fetch-tweet

fetch-tweet

github.com/playableintelligenceProductivity350816 installsUpdated 22w ago
Repository

About fetch-tweet

fetch-tweet is a skill for retrieving tweet content. It converts common tweet URLs to fxtwitter API endpoints and uses WebFetch to extract structured data for workflows that need tweet text and engagement details.

Key features

  1. 01Converts several tweet URL formats
  2. 02Retrieves tweet JSON through the API
  3. 03Extracts author, text, and date
  4. 04Collects engagement data and media URLs

Use cases

  1. 01Read tweets from x.com or twitter.com
  2. 02Summarize authors and engagement metrics
  3. 03Retrieve links to tweet photos or videos

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/playableintelligence/game-creator --skill fetch-tweet

After installing, type/fetch-tweetin Claude Code to confirm it loaded.

Details

From the project README

Fetch Tweet

You fetch tweet content using the fxtwitter API, which returns structured JSON without requiring JavaScript rendering or authentication.

Why fxtwitter

X/Twitter requires JavaScript to render tweets. WebFetch on x.com returns an empty shell. The fxtwitter API (api.fxtwitter.com) serves the same tweet data as plain JSON — no auth, no JS, no rate-limit friction for reasonable use.

URL Conversion

Given any tweet URL, convert it to the fxtwitter API endpoint:

Input URL patternAPI URL
https://x.com/<user>/status/<id>https://api.fxtwitter.com/<user>/status/<id>
https://twitter.com/<user>/status/<id>https://api.fxtwitter.com/<user>/status/<id>
https://fxtwitter.com/<user>/status/<id>https://api.fxtwitter.com/<user>/status/<id>
https://vxtwitter.com/<user>/status/<id>https://api.fxtwitter.com/<user>/status/<id>

Extract the <user> and <id> from the input URL, then construct https://api.fxtwitter.com/<user>/status/<id>.

How to Fetch

Use WebFetch with the converted API URL:

WebFetch(url: "https://api.fxtwitter.com/<user>/status/<id>", prompt: "Extract the tweet JSON. Return: author name, handle, tweet text, date, media URLs (if any), likes, retweets, replies, views.")

Response Structure

The fxtwitter API returns JSON with this structure:

{
  "code": 200,
  "message": "OK",
  "tweet": {
    "url": "https://x.com/user/status/123",
    "text": "The tweet content...",
    "author": {
      "name": "Display Name",
      "screen_name": "handle"
    },
    "created_at": "Thu Jan 30 12:00:00 +0000 2026",
    "likes": 1000,
    "retweets": 500,
    "replies": 200,
    "views": 50000,
    "media": {
      "photos": [...],
      "videos": [...]
    }
  }
}

Usage Pattern

When you receive a tweet URL (x.com, twitter.com, fxtwitter.com, or vxtwitter.com):

  1. Parse the URL to extract username and tweet ID
  2. Convert to https://api.fxtwitter.com/<user>/status/<id>
  3. Fetch using WebFetch with the API URL
  4. Present the tweet content in a readable format:
**Author Name** (@handle) — Date

"Tweet text here"

Engagement: X views, Y likes, Z retweets, W replies

If the tweet contains media (photos/videos), include the URLs.

Error Handling

  • If fxtwitter returns a non-200 status, the tweet may have been deleted or the account suspended
  • If the URL doesn't match any known tweet URL pattern, ask the user for a valid tweet link

Comments

Markdown supported