twitter-downloader

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Saving media and text from Twitter/X posts manually is tedious, and direct API access requires authentication. This Skill fetches tweet content through public fxtwitter/vxtwitter endpoints, downloads the media files into your workspace, and returns chat-ready Markdown with inline media links. ## Core Features & Use Cases - Tweet Summarization: Extracts author, text, creation time, sensitive flag, and original media URLs into a readable summary. - Media Downloading: Saves images, video thumbnails, GIFs, and videos (best-bitrate variant) into a structured workspace folder. - Markdown Output: Returns inline media syntax and file links ready to paste directly into chat. - Use Case: A user shares an x.com status link and asks what the tweet contains; the Skill fetches the JSON, downloads the attached video, and replies with a summary plus an embedded playable video link. ## Quick Start Download and summarize this tweet with all its media: 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 post?▼

Run the twitter_downloader.sh script with the tweet URL, and it fetches tweet JSON from api.fxtwitter.com, then downloads the best-bitrate video or GIF variant into the workspace tweet_media folder. Use --video to download only videos.

How to get a tweet summary without downloading media?▼

Pass the --no-download flag to the script with the tweet URL. It fetches the JSON, generates a text summary with author, text, creation time, and sensitive flag, and returns Markdown links to the summary and raw JSON files only.

Does this work with both twitter.com and x.com links?▼

Yes, the URL parser accepts both twitter.com and x.com status URLs, extracting the username and numeric tweet ID. Query strings and trailing slashes are stripped before parsing.

Why does tweet downloading fail for some posts?▼

Fetching fails when the tweet is private, deleted, or when both the fxtwitter and vxtwitter APIs are unavailable. The script first retries with the fallback API, then reports the likely cause if both fail.

What dependencies are required to run the downloader script?▼

The script requires curl, jq, and python3. If any are missing, it attempts to install them automatically using apk add, so it targets Alpine-based environments by default.