x_likes

List and download media from the authenticated user's X Likes via a local MCP server.

1|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/HerbertGao/x_likes_downloader --skill x-likes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x_likes
Source: https://github.com/HerbertGao/x_likes_downloader/tree/main/packaging/claude-code/skills/x_likes
Command: npx skills add https://github.com/HerbertGao/x_likes_downloader --skill x-likes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you manage your own X (Twitter) Likes hands-free by letting an AI list what you’ve liked and download the associated media while keeping your credentials local.

Core Features & Use Cases

  • List your Likes: Retrieve your liked tweets (including media) with pagination/incremental cursor support for efficient syncing.
  • Download media on demand: Download images/videos/gifs from selected like items into a sandboxed directory with progress updates.
  • Check credential health: Perform a lightweight real request to confirm whether your stored credentials can still access Likes endpoints.
  • Quick re-setup from a browser cURL: Import credentials and protocol parameters from a “Copy as cURL” export when auth expires.

Quick Start

Ask your AI agent: “Check my X likes for the latest Rust-related posts and download the videos into a folder, showing progress.”

Frequently Asked Questions about x_likes

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

FAQPage Schema
How do I download media from my X likes in batch?

To download media from X likes in batch, you can use an AI agent to call the download_media tool, which retrieves images, videos, and gifs from liked tweets into a sandboxed directory with HTTP range resume and progress notifications.

How do I automate incremental syncing of my Twitter likes?

Incremental syncing of Twitter likes is automated through the list_likes tool, which retrieves liked tweets with pagination and incremental cursor support for efficient, agent-driven synchronization workflows.

How do I check if my stored X credentials are still valid for accessing likes?

You can check if your stored X credentials are valid by using the auth_status tool, which performs a lightweight real request to confirm whether your credentials can still access the Likes endpoints.

How do I re-setup X authentication when my credentials expire?

To re-setup X authentication when credentials expire, use the setup_from_curl tool to import credentials and protocol parameters directly from a browser Copy as cURL export, ensuring safe credential handling.

What do I need to run an MCP server for downloading my X likes?

To run an MCP server for downloading X likes, you need a local installation of x_likes_downloader version 2.1.0 or higher, started with the serve --mcp command to expose the necessary automation tools.

Can an AI agent filter my X likes and download specific videos?

Yes, an AI agent can filter your X likes and download specific videos by listing liked tweets, identifying target media, and invoking the download_media tool with progress updates into a sandboxed directory.