TweetSave

by zezeron

320 downloads
Not rated
GitHub

About

Twitter/X analysis without token waste. Fetch tweets, download media. No API key required.

Details

Author
zezeron
Downloads
320
Categories
Other, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name TweetSave
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Connect via remote MCP (recommended) with npx -y mcp-remote https://mcp.tweetsave.org/sse, or run locally with npx -y tweetsave-mcp. The server exposes tools including tweetsave_get_tweet, tweetsave_get_thread, tweetsave_to_blog, `tweetsave_batch

tweetsave_get_tweet

Fetch a single tweet with all its content including text, media (photos, videos, GIFs), polls, and engagement metrics. This tool retrieves tweet data from Twitter/X using the FxTwitter API. It returns the tweet content, author info, media URLs, and engagement stats. Args: - url (string): Tweet URL or tweet ID - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: Tweet data including: - Author info (name, username, avatar) - Tweet text - Media URLs (photos, videos) - Engagement (likes, retweets, replies, views) - Poll data (if applicable) - Quote tweet (if applicable) Examples: - "Get tweet from https://x.com/elonmusk/status/123456" - "Fetch this tweet: 123456789" Note: Does not fetch replies. Use tweetsave_to_blog for a complete blog post with formatting.

tweetsave_get_thread

Fetch a tweet thread (multiple connected tweets by the same author). Note: Current implementation fetches the main tweet. Full thread crawling requires additional API access. Args: - url (string): URL or ID of any tweet in the thread - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: Array of tweets in the thread with all content and media. Examples: - "Get the full thread from this tweet: https://x.com/user/status/123"

tweetsave_to_blog

Convert a tweet into a formatted blog post with title, content, media, and metadata. This tool transforms a tweet into a readable blog post format, perfect for: - Archiving tweets - Creating content from threads - Generating blog posts from viral tweets Args: - url (string): Tweet URL or tweet ID - include_engagement (boolean): Include likes/retweets/etc. (default: true) - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: BlogPost with: - Generated title from tweet content - Author info with avatar - Formatted content with media - Tags from hashtags - Read time estimate - Engagement summary - Source link Examples: - "Convert this tweet to a blog post: https://x.com/user/status/123" - "Make a blog from tweet 123456789"

tweetsave_batch

Fetch multiple tweets at once (max 10). Useful for: - Collecting tweets from a list - Building a feed from multiple sources - Comparing multiple tweets Args: - urls (string[]): Array of tweet URLs or IDs (max 10) - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: Array of tweets or a combined feed in markdown format. Examples: - "Fetch these tweets: [url1, url2, url3]"

tweetsave_extract_media

Extract direct media URLs (photos, videos, GIFs) from a tweet. Returns direct URLs that can be downloaded or embedded. Video URLs are the highest quality available. Args: - url (string): Tweet URL or tweet ID - media_type ('all' | 'photos' | 'videos'): Filter by media type (default: 'all') Returns: List of media items with: - type (photo/video/gif) - url (direct download URL) - dimensions (width/height) - duration (for videos) Examples: - "Get all media from this tweet: https://x.com/user/status/123" - "Extract video URLs from tweet 123456"

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tweetsave": {
            "tweetsave": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.tweetsave.org/sse"
                ]
            }
        }
    }
}

McpServers

{
    "tweetsave": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-remote",
            "https://mcp.tweetsave.org/sse"
        ]
    }
}

Features

- Fetch tweets with full content, media, and engagement metrics - Convert tweets to formatted blog posts - Extract media URLs (photos, videos, GIFs) - Batch fetch multiple tweets (up to 10) - Support for quote tweets and polls - Markdown and JSON output formats ## Quick Start ### Remote MCP (Recommended) No installation required - connect directly to hosted server: ```bash npx -y mcp-remote https://mcp.tweetsave.org/sse Local (npx) npx -y tweetsave-mcp Available Tools - tweetsave_get_tweet - Fetch a single tweet - tweetsave_get_thread - Fetch tweet thread - tweetsave_to_blog - Convert tweet to blog post - tweetsave_batch - Batch fetch (max 10) - tweetsave_extract_media - Extract media URLs
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.