Skip to content
OpenSmartRoute
Skillv1.0.0

fetch-tweet

Fetch tweet content directly from fxtwitter API. Use when given a tweet/X URL to extract the tweet text, author, media, and engagement stats without loading x.com.

by playableintelligence(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from playableintelligence/game-creator (skills/fetch-tweet/SKILL.md) via skills.sh. Install upstream with npx skills add playableintelligence/game-creator --skill fetch-tweet. Copyright stays with the author (MIT).

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 pattern API 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

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/playableintelligence-game-creator-fetch-tweet/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

playableintelligence-game-creator-fetch-tweet.ocm.jsonjson
{
  "ocm": "1",
  "id": "playableintelligence-game-creator-fetch-tweet",
  "kind": "skill",
  "name": "fetch-tweet",
  "description": "Fetch tweet content directly from fxtwitter API. Use when given a tweet/X URL to extract the tweet text, author, media, and engagement stats without loading x.com.",
  "publisher": "playableintelligence",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "twitter",
      "tweet",
      "fetch",
      "fxtwitter",
      "social-media",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Fetch tweet content directly from fxtwitter API. Use when given a tweet/X URL to extract the tweet text, author, media, and engagement stats without loading x.com."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/playableintelligence/game-creator",
      "path": "skills/fetch-tweet/SKILL.md",
      "ref": "HEAD",
      "url": "https://www.skills.sh/playableintelligence/game-creator/fetch-tweet",
      "key": "playableintelligence/game-creator/skills/fetch-tweet/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Fetch Tweet\n\nYou fetch tweet content using the fxtwitter API, which returns structured JSON without requiring JavaScript rendering or authentication.\n\n## Why fxtwitter\n\nX/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.\n\n## URL Conversion\n\nGiven any tweet URL, convert it to the fxtwitter API endpoint:\n\n| Input URL pattern | API URL |\n|---|---|\n| `https://x.com/<user>/status/<id>` | `https://api.fxtwitter.com/<",
  "cost": {
    "context_tokens": 627
  }
}

Fetch it by URL: GET /api/v1/registry/playableintelligence-game-creator-fetch-tweet/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.