360 Secure SkillHub
360 安全技能中心

X Article Extractor

该 Skill 通过无头浏览器抓取 X（Twitter）长文文章并输出 Markdown 文件，保留原始图片链接、将引用帖转为标准 Markdown 链接并去除界面杂乱元素。首次运行会自动下载 Playwright 与 Chromium 核心，耗时较长且需要网络访问；日常通过命令行调用并可用参数指定输出目录。

caol64
caol64
热度 37.64
最近更新 2026-05-11 17:39:51
分类：效率依赖：联网浏览搜索 / 代码执行 / 读写文件应用场景：文件转换 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add x-article-to-markdown
Metadata
name
x-article-to-markdown
description
AI-ready skill to extract long-form X (Twitter) articles and convert them into clean Markdown files using headless browser technology.

X Article Extractor (Omni-Article)

A specialized skill designed for AI Agents to capture long-form "Articles" from X (formerly Twitter). It utilizes a headless browser to bypass basic access restrictions and produces structured Markdown.

Capabilities

  • Zero-Config Extraction: No Cookies, Tokens, or API Keys required.
  • On-Demand Browser Setup: Automatic lazy-loading of Playwright and Chromium core.
  • Asset Preservation: Maintains original image URLs within the Markdown.
  • Reference Handling: Automatically converts quoted posts into standard Markdown links.
  • Clean Output: Strips UI clutter, focusing solely on the article body.

Prerequisites & Installation

The tool manages its own browser dependencies. Simply install the package:

pip install omni-article-markdown

Important (First Run Only): The Playwright engine and Chromium core are lazy-loaded. They will be automatically downloaded and configured during the first execution. Expect a significant delay (1-3 minutes depending on bandwidth) during the initial run. Subsequent runs will be near-instant.

AI Agent Instructions

When to use this skill

Call this skill when a user provides an X (Twitter) URL and asks to "save," "read," "extract," or "convert" the long-form content.

Parameters

  • url (Required): The full X post/article URL.
  • --output-dir (Optional): Target directory for the .md file.

First-Run Strategy

If the environment is fresh, the Agent should inform the user: "I'm setting up the browser environment for the first time, this might take a minute..." to prevent the user from thinking the process has hung.

Usage Examples

Standard Extraction

# Basic command
mdcli https://x.com/elonmusk/status/1234567890

Save to Specific Directory

mdcli https://x.com/username/status/xxxx -s ./downloads/articles/

Troubleshooting for Agents

  • Extended Latency: If the command takes >60s on the first run, do not kill the process; it is likely downloading the Chromium core.
  • Network Error: Ensure the environment has internet access to both x.com and the Playwright binary mirrors.

GitHub Repository

caol64/omni-article-markdown

License

MIT