fetch-tweet

Q: How do I install fetch-tweet?

Run npx skills add https://github.com/playableintelligence/game-creator --skill fetch-tweet in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/fetch-tweet/ (personal) or .claude/skills/fetch-tweet/ (project).

by playableintelligenceBackend & APIs

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.

Installs: 809
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

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

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads fetch-tweet automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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):

Parse the URL to extract username and tweet ID
Convert to https://api.fxtwitter.com/<user>/status/<id>
Fetch using WebFetch with the API URL
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

FAQ

What does the fetch-tweet skill do?

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.

How do I install fetch-tweet?

Run npx skills add https://github.com/playableintelligence/game-creator --skill fetch-tweet in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/fetch-tweet/ (personal) or .claude/skills/fetch-tweet/ (project).

Which AI agents can use fetch-tweet?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is fetch-tweet safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains fetch-tweet?

It is published by playableintelligence in playableintelligence/game-creator. It has 809 recorded installs.