Open Skills Logo
Open Skills

baoyu-danger-x-to-markdown

Converts X (Twitter) tweets and articles to markdown with YAML front matter. Uses reverse-engineered API requiring user consent. Use when user mentions "X to markdown", "tweet to markdown", "save tweet", or provides x.com/twitter.com URLs for conversion.

Author

@JimLiu

Category

Document Processing

Install

Hot:5

Download and extract to your skills directory

Copy command and send to OpenClaw for auto-install:

Download and install this skill https://openskills.cc/api/download?slug=jimliu-skills-baoyu-danger-x-to-markdown&locale=en&source=copy

baoyu-danger-x-to-markdown

Overview of Skills


A command-line tool that converts X (Twitter) tweets and articles into Markdown files with YAML Front Matter. It supports extracting complete content from both tweet threads and long-form articles.

Use Cases

  • Content archiving and backup: When you need to save important tweets, tweet threads, or X Articles locally, export them as structured Markdown files for offline reading and long-term storage.

  • Collecting material for content creators: Bloggers, researchers, and journalists who need to gather valuable content from the Twitter/X platform for citation can use this tool to quickly convert it into editable Markdown format.

  • Knowledge base and notes integration: Import X platform content into Markdown-compatible note tools such as Obsidian and Logseq. YAML Front Matter can be automatically recognized as metadata tags.

    • Core Features

  • Tweet and article conversion: Supports extracting complete content from single tweets, tweet threads, and X Articles. It automatically generates YAML Front Matter containing metadata such as the URL, author information, and the number of tweets.

  • Intelligent authentication management: Supports configuration via environment variables (X_AUTH_TOKEN, X_CT0). It also provides Chrome auto-login and cookie caching. After the first login, the authenticated state can be reused.

  • User consent mechanism: Since the tool uses reverse-engineered unofficial APIs, it includes a user consent flow and a disclaimer. This ensures users understand potential risks (API changes, account restrictions, etc.) and choose to use the tool voluntarily.

    • Frequently Asked Questions

    Is this tool safe? Will it lead to account suspension?


    This tool uses a reverse-engineered X API rather than an official interface. Although the tool is designed with caution, using an unofficial API carries some risk, including but not limited to: the X platform API changing and causing the tool to stop working, and possible restrictions on account usage. The tool requires users to read and accept the disclaimer before use. Please assess the risk based on your own situation.

    What URL formats are supported?


    It supports the following three URL formats:
  • https://x.com/<username>/status/<tweetID>

  • https://twitter.com/<username>/status/<tweetID>

  • https://x.com/i/article/<articleID>

    • How do I configure authentication information?


    It’s recommended to use environment variables (higher priority): set X_AUTH_TOKEN and X_CT0. If they are not configured, the tool will try to automatically open the Chrome browser to complete login and cache cookies locally for reuse in later runs. Use the --login parameter to refresh the authentication state separately.