⁠X Reader⁠

👤 zuolicong 📦 v0.1.0 ⭐ 4.4 ⬇️ 962 下载
📚 知识管理 免费

📖 技能介绍


name: x-reader description: Read and summarize X/Twitter links with low-token routing. Use when a user shares an x.com/twitter.com/t.co link or asks to read, summarize, extract, or inspect a tweet, thread, or X article. Prefer xreach for normal tweets; use Playwright only for X article pages or t.co links that resolve to x.com/i/article/ URLs.


X Reader

Use the bundled Node script to read X links with minimal token overhead.

Workflow

  1. Run scripts/xreader.mjs with the URL.
  2. Let the script decide the cheapest path:
  3. normal tweet → xreach tweet
  4. explicit thread request → xreach thread
  5. article / t.co → resolve first, use Playwright only when needed
  6. Return the script's structured JSON; summarize from that instead of pasting raw page content.

Positioning

  • No official X API required.
  • No developer application or paid X API access required.
  • Works with login cookies plus low-token routing, which keeps normal tweet reads cheap and uses Playwright only when article rendering is necessary.

    更多技能请访问小葱技能站7w4.net。

  • Compared with xreach, this skill is a higher-level reader for agent workflows: it adds article handling, authored-thread filtering, and unified structured output.
  • Compared with xcurl, this skill focuses on content extraction from links instead of low-level request control.

Commands

Summary mode (default):

node skills/x-reader/scripts/xreader.mjs "https://x.com/..."

Full mode:

node skills/x-reader/scripts/xreader.mjs --mode full "https://x.com/..."

Thread mode (explicit only, to save tokens):

node skills/x-reader/scripts/xreader.mjs --thread "https://x.com/.../status/..."

Debug mode (headed browser for article extraction):

node skills/x-reader/scripts/xreader.mjs --debug "https://x.com/i/article/..."

Dependencies

Required:

  • xreach
  • Node.js
  • valid X auth cookies

Install article-mode dependency inside the skill directory:

cd skills/x-reader
npm install

Auth

Primary auth path:

~/.config/xreader/session.json

Legacy fallback path:

~/.config/xfetch/session.json

If legacy auth exists, the script migrates it to the new path automatically.

Expected JSON format:

{
  "authToken": "...",
  "ct0": "..."
}

Output contract

Expect structured JSON with fields such as:

  • ok
  • type (tweet, thread, or article)
  • url
  • canonicalUrl
  • source (xreach or playwright)
  • author
  • publishedAt
  • title
  • text / contentText
  • contentMarkdown
  • summaryText
  • fallback / warnings / error

Prefer quoting or summarizing summaryText for low-token responses. Use contentText or contentMarkdown only when the user clearly wants more detail.

Quick verification

Run these after install/auth setup:

node skills/x-reader/scripts/xreader.mjs "https://x.com/yangguangai/status/2033736815405121642?s=46"
node skills/x-reader/scripts/xreader.mjs "https://x.com/yangguangai/status/2033522959407878621?s=46"
node skills/x-reader/scripts/xreader.mjs --thread "https://x.com/google/status/2031558824042058064"

Notes

  • Default tweet reads are single-post only for token efficiency.
  • Use --thread only when the user clearly wants the authored thread.
  • Article extraction is MVP quality: good enough for reading and summarization, but long X articles with many examples/code blocks may still include some template noise.
  • If article extraction fails, the script falls back to the original tweet payload and marks the failure in warnings / articleError.
  • This skill relies on X login cookies (auth_token + ct0). Cookie-based automation may carry account risk, including additional verification or account restrictions. The risk is usually low for light personal use, but recommend using a secondary account instead of a primary high-value account.

Release checklist

  • Confirm SKILL.md includes usage, dependencies, auth path, and limitations.
  • Confirm node skills/x-reader/scripts/xreader.mjs --help works.
  • Smoke test one tweet, one article, and one thread URL.
  • Confirm auth file is not packaged into the skill.
  • Package the skill and verify validation passes before publishing.

🤖 AI 评测

这个 Skill 质量不错,能可靠地读取 X 上的推文、线程和文章内容。它在智能路由和错误处理方面做得好——普通推文读取轻量快速,文章页面自动切换到完整渲染模式,提取失败时还能优雅降级回退到原推文。线程处理也考虑了过滤干扰内容。不过它依赖 X 登录 Cookie 使用,存在一定的账户风险;文章提取偶尔可能带出一些页面模板残留;整体需要一些额外配置才能跑起来。总体而言,对于日常使用已经足够好用,但重度用户需要注意账号安全。

📊 多维度评分

适应性4.7
规范性4.2
有效性4.5
可靠性4.5
可信度4.5

📁 包含文件 (5 个)

📄 SKILL.md 4.1 KB
📄 _meta.json 131 B
📄 package-lock.json 1.6 KB
📄 package.json 123 B
📄 scripts/xreader.mjs 18.5 KB