twitter-downloader

Download Twitter/X tweet text, images, GIFs, and videos via fxtwitter and vxtwitter APIs.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/riipandi/minis-skills --skill twitter-downloader-riipandi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twitter-downloader
Source: https://github.com/riipandi/minis-skills/tree/main/twitter-downloader
Command: npx skills add https://github.com/riipandi/minis-skills --skill twitter-downloader-riipandi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, python3, and includes scripts (resource) components.

What problem does it solve? It retrieves tweet content and media from Twitter/X links without needing a Twitter account or API key, saving media locally and returning chat-ready Markdown summaries. ## Core Features & Use Cases - Tweet Fetching: Parses twitter.com/x.com status URLs and fetches structured JSON from api.fxtwitter.com with automatic fallback to api.vxtwitter.com. - Media Download: Downloads photos, video thumbnails, GIFs, and videos, selecting the highest-bitrate video variant when available. - Markdown Output: Returns a tweet summary (author, text, created time, sensitive flag) plus inline minis:// media links ready to paste into chat. - Use Case: A user pastes an x.com status link and asks to save the video; the skill downloads the media and returns inline Markdown so the video displays directly in the conversation. ## Quick Start Download the tweet and all its media from this link: https://x.com/user/status/1234567890.

Frequently Asked Questions about twitter-downloader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download videos from a Twitter/X link?

Run the twitter_downloader.sh script with the tweet URL, and it fetches tweet JSON from api.fxtwitter.com, then downloads the highest-bitrate video or GIF variant into the output directory. The result includes inline Markdown links for chat display.

How to get tweet text and metadata without a Twitter API key?

Use the fxtwitter or vxtwitter public APIs, which return structured tweet JSON including author, text, creation date, and media URLs without authentication. The script queries api.fxtwitter.com first and falls back to api.vxtwitter.com on failure.

Can I download only images or only videos from a tweet?

Yes, pass --images to download photos and video thumbnails only, or --video to download videos and GIFs only. With no media flag, both types are downloaded by default; --no-download fetches only the summary and JSON.

Why does tweet download fail for some Twitter links?

Failures occur when the URL is not a valid twitter.com/x.com status link, or when both fxtwitter and vxtwitter APIs cannot return data. In the latter case the tweet is likely private, deleted, or the API is temporarily unavailable.

What dependencies are required to run the tweet downloader script?

The script requires curl, jq, and python3. On Alpine-based systems it auto-installs missing packages using apk add --no-cache before running.