x-read

当您需要在不登录的情况下阅读推文/文章内容时，渲染并总结公共 X (Twitter) 链接。

# X-Read Skill

## When to use this skill
Use `x-read` whenever you need to capture the text, media links, and basic metadata from a public X/Twitter permalink without using the API, creating an account, or burning Brave search credits. It works best for thread permalink URLs (`https://x.com/<user>/status/<id>`) and articles posted on X that surface their content on the same page.

## Inputs
- `url` (required): The exact permalink you want to render. Include the full `https://x.com/...` path so the Puppeteer browser can navigate directly.

## What happens when you run it
1. Puppeteer launches a sandboxed Chromium instance with a realistic user-agent and loads the URL.
2. The script waits for `article[data-testid="tweet"]` elements, captures the main thread (tweet + up to three replies), and extracts any linked card or media attachments.
3. Media is reprinted as `![](...)` markdown with `ALT` text when available, and the main article body is appended beneath the primary tweet.
4. The output is a short markdown summary listing the thread author, timestamp, text, links, and media so the Telegram chat stays readable.

## Output format
```
## Tweet Thread Summary
Source: <url>

### **MAIN TWEET** by Display Name (@handle)
*2026-02-21T18:24:00Z*
Tweet text …

**Linked Article:** [Title](card URL)
**Media:**
- ![](media1)
- ![](media2)
---
```
Replied tweets follow the same pattern with the `Reply` heading. Media URLs retain the `name=large` parameter for better quality.

## Limitations and troubleshooting
- The skill only reads publicly available tweets. If X blocks the navigation with a login wall, you will see an error that logging in is required.
- Long-form articles sometimes use `article.content`; the script appends that text to the main tweet so you still get the full written piece.
- Because the skill uses a browser, it may take a few extra seconds compared to an API call—expect 5–10 seconds per URL.
- For best results, keep the thread URLs focused and don’t try to feed a feed of multiple unrelated URLs at once; run the tool per link.

## Testing and safety
- The skill is read-only: it never posts, likes, DM’s, or authenticates to X.
- Review the `index.js` script if X changes its DOM selectors (it relies on `data-testid` attributes such as `tweet`, `tweetText`, `User-Name`, and `card.wrapper`).
- Run the skill manually with `openclaw use x-read read_tweet --url <link>` before publishing to confirm the output is what you expect.

---

## 中文说明

# X-Read Skill

## 何时使用此技能
当你需要捕获公共 X/Twitter 永久链接中的文本、媒体链接和基本元数据，而又不想使用 API、创建账户或消耗 Brave 搜索额度时，使用 `x-read`。它最适合处理推文串永久链接 URL（`https://x.com/<user>/status/<id>`）以及发布在 X 上、内容在同一页面展示的文章。

## 输入
- `url`（必填）：你想要渲染的确切永久链接。请包含完整的 `https://x.com/...` 路径，以便 Puppeteer 浏览器能够直接导航。

## 运行时会发生什么
1. Puppeteer 启动一个带有逼真 user-agent 的沙盒化 Chromium 实例并加载该 URL。
2. 脚本等待 `article[data-testid="tweet"]` 元素，捕获主推文串（推文 + 最多三条回复），并提取任何链接卡片或媒体附件。
3. 媒体会以 `![](...)` markdown 形式重新输出（在可用时附带 `ALT` 文本），主文章正文则附加在主推文下方。
4. 输出为一段简短的 markdown 摘要，列出推文串作者、时间戳、文本、链接和媒体，使 Telegram 聊天保持易读。

## 输出格式
```
## Tweet Thread Summary
Source: <url>

### **MAIN TWEET** by Display Name (@handle)
*2026-02-21T18:24:00Z*
Tweet text …

**Linked Article:** [Title](card URL)
**Media:**
- ![](media1)
- ![](media2)
---
```
回复的推文遵循相同的模式，使用 `Reply` 标题。媒体 URL 保留 `name=large` 参数以获得更好的画质。

## 限制与故障排查
- 此技能只读取公开可用的推文。如果 X 用登录墙阻止导航，你会看到一个提示需要登录的错误。
- 长文章有时使用 `article.content`；脚本会将该文本附加到主推文，因此你仍能获得完整的书面内容。
- 由于此技能使用浏览器，相比 API 调用可能会多花几秒——每个 URL 预计需要 5–10 秒。
- 为获得最佳效果，请保持推文串 URL 聚焦，不要试图一次喂入多个互不相关的 URL 的信息流；请逐个链接运行该工具。

## 测试与安全
- 此技能是只读的：它从不在 X 上发帖、点赞、发私信或进行认证。
- 如果 X 更改了其 DOM 选择器，请查看 `index.js` 脚本（它依赖诸如 `tweet`、`tweetText`、`User-Name` 和 `card.wrapper` 等 `data-testid` 属性）。
- 在发布前，使用 `openclaw use x-read read_tweet --url <link>` 手动运行该技能，以确认输出符合预期。