Skill: dotheworknow/xhunt-hot-tweets (version 2.0.2)

--- name: xhunt-hot-tweets description: 从 XHunt 抓取 X/Twitter 热门推文榜单并输出中文摘要与互动数据。用户提到“最火推文/热门帖子/Top20/4小时最火/只要AI/AI最火/给我链接+摘要”等请求时使用。支持 group=global|cn、hours=1|4|24、tag=ai|crypto|全部，并可切换过滤模式（全部/仅AI产品与模型更新/允许政治争议）。 compatibility: 需要可访问 https://trends.xhunt.ai；优先 browser 快照抓取，失败时可降级 web_fetch（结果可能不完整）。 metadata: author: Javis version: 2.0.2 --- # XHunt 热门推文提取（v2） 目标：稳定输出“可直接转发/复盘”的热门推文清单（链接 + 一句话摘要 + 核心互动数据）。 ## 1) 参数解析（先做） 默认参数： - `group=global` - `hours=24` - `tag=ai` - `limit=20` - `mode=all`（不过滤政治） 按用户话术覆盖： - “华语区”→ `group=cn` - “4小时/1小时/24小时”→ `hours` - “只要AI”→ `tag=ai` - “全部最火”→ 不传 `tag` - “Top10/Top20/Top30”→ `limit` - “只看AI产品/模型更新”→ `mode=ai-product-only` - “可以有政治争议”→ `mode=all` URL 模板： - 基础：`https://trends.xhunt.ai/zh/tweets?group=<group>&hours=<hours>` - 有标签：在末尾追加 `&tag=<tag>` ## 2) 抓取策略（固定顺序） 1. 优先 `browser` 打开目标 URL + `snapshot(refs=aria)`。 2. 从榜单卡片提取：排名、作者、链接、标题、views、likes、retweets、热度。 3. 若 browser 失败，降级 `web_fetch`，并在输出首行标注： - `说明：本次使用降级抓取，字段可能不完整。` 4. 若两种抓取都失败，直接返回错误说明，不得编造数据： - `说明：抓取失败（网络或页面结构变化），请稍后重试。` ## 3) 过滤规则 ### mode=all - 不做内容过滤（含政治争议）。 ### mode=ai-product-only 保留： - 模型发布/更新（如 Claude、GPT、Qwen、Gemini 等） - AI 产品与工具更新（如 Cursor、Perplexity、Notion AI、Devin 等） - AI agent/workflow/开发工具实操内容 - AI 基础设施与算力（与 AI 直接相关） 剔除： - 纯政治选举/党争（无 AI 主体） - 纯加密炒作（无 AI 主体） - 娱乐八卦与空洞内容 若过滤后不足 `limit`： - 继续向后补齐；仍不足则如实返回实际条数，不编造。 ## 4) 输出格式（严格） 首行口径： - `数据源：XHunt 推文榜（<group> / <hours>h / <tag或全部>）` 列表：每条固定 3 行 1. `N) <tweet_url>` 2. `摘要：<一句中文摘要>` 3. `数据：<views>｜<likes>｜<retweets>｜热度<score>` 末尾补“观察”3条： - 当前最强话题簇 - 高互动内容的共同结构 - 适合用户二次创作的切入角度 ## 5) 质量门槛 - 不输出无链接条目。 - 不输出“内容为空”类摘要；遇到则跳过补位。 - 摘要必须是“信息点 + 结果/影响”，避免空话。 - 数据字段缺失时写“NA”，不要臆造。 - 若过滤后不足 `limit`，返回真实条数，并在末尾加一句： - `说明：符合条件条目不足 <limit>，已返回全部可用结果。` ## 6) 快速模板（执行时可直接套） 用户：`四小时最火帖子，只要AI，给我Top20，每个一条摘要` 执行参数： - `group=global` - `hours=4` - `tag=ai` - `limit=20` - `mode=ai-product-only`

path: CHANGELOG.md
content: # Changelog

## 2.0.2 - 2026-02-26

- Updated README docs to focus on user value and installation only.
- Removed ClawHub publishing instructions from README files.
- Aligned skill naming in docs with repository name (`xhunt-hot-tweets-skill`).
- Added clear install guides for both GitHub and ClawHub paths.

## 2.0.1 - 2026-02-26

- Added publishing-ready docs (`README.md`, `README.zh-CN.md`).
- Added agent metadata file (`agents/openai.yaml`).
- Hardened failure handling in `SKILL.md`:
  - explicit full-failure response when both extraction paths fail
  - explicit notice when filtered results are fewer than requested limit
- Prepared ClawHub publish command examples.

## 2.0.0 - 2026-02-26

- Initial release of XHunt hot tweets extraction skill.
- Supports `group`, `hours`, `tag`, `limit`, and filtering mode.
- Enforces stable 3-line output per item with Chinese summaries.


path: README.md
content: # xhunt-hot-tweets-skill

[中文说明](README.zh-CN.md)

A shareable OpenClaw/Codex skill that extracts hot tweets from XHunt and returns structured Chinese summaries.

## Problem It Solves

- Manually checking X/Twitter hot topics is noisy and time-consuming.
- This skill pulls XHunt ranking pages (`global`/`cn`, `1h/4h/24h`, optional tags) and returns a stable format:
  - tweet link
  - one-line Chinese summary
  - engagement stats (`views/likes/retweets/score`)
- It supports:
  - `all` mode (no content exclusion)
  - `ai-product-only` mode (focus on AI products/models/tools)

## Requirements

- Access to `https://trends.xhunt.ai`
- Runtime that can use browser snapshot tools for best extraction quality
- Fallback to web fetch is supported but may return incomplete fields

## Install From ClawHub

```bash
npx clawhub login
npx clawhub install xhunt-hot-tweets
openclaw skills info xhunt-hot-tweets
```

## Install From GitHub

```bash
git clone https://github.com/DoTheWorkNow/xhunt-hot-tweets-skill.git
mkdir -p ~/.openclaw/workspace/skills/xhunt-hot-tweets
rsync -a --delete ./xhunt-hot-tweets-skill/ ~/.openclaw/workspace/skills/xhunt-hot-tweets/
openclaw skills info xhunt-hot-tweets
```

Optional refresh:

```bash
openclaw gateway restart
```

## Trigger Examples

- `四小时最火帖子`
- `只要 AI 的最火推文，给我 Top20`
- `给我热门帖子链接+摘要`


path: README.zh-CN.md
content: # xhunt-hot-tweets-skill

[English](README.md)

一个可用于 OpenClaw / Codex 的技能：从 XHunt 抓取热门推文，并输出结构化中文摘要。

## 解决的问题

- 人工筛选 X/Twitter 热帖噪音大、耗时高。
- 这个技能会读取 XHunt 榜单（`global`/`cn`，`1h/4h/24h`，可带标签），并按固定格式输出：
  - 推文链接
  - 一句话中文摘要
  - 互动数据（`views/likes/retweets/score`）
- 支持两种模式：
  - `all`：不过滤争议/政治内容
  - `ai-product-only`：只保留 AI 产品/模型/工具相关内容

## 环境要求

- 可访问 `https://trends.xhunt.ai`
- 运行环境最好支持 browser snapshot（优先抓取策略）
- 失败时可降级 web fetch（字段可能不完整）

## 通过 ClawHub 安装

```bash
npx clawhub login
npx clawhub install xhunt-hot-tweets
openclaw skills info xhunt-hot-tweets
```

## 通过 GitHub 安装

```bash
git clone https://github.com/DoTheWorkNow/xhunt-hot-tweets-skill.git
mkdir -p ~/.openclaw/workspace/skills/xhunt-hot-tweets
rsync -a --delete ./xhunt-hot-tweets-skill/ ~/.openclaw/workspace/skills/xhunt-hot-tweets/
openclaw skills info xhunt-hot-tweets
```

可选刷新：

```bash
openclaw gateway restart
```

## 触发示例

- `四小时最火帖子`
- `只要 AI 的最火推文，给我 Top20`
- `给我热门帖子链接+摘要`


path: agents/openai.yaml
content: version: 1
display_name: XHunt Hot Tweets
short_description: Extract trending XHunt tweets with structured Chinese summaries
default_prompt: Fetch the hottest XHunt tweets and return links, one-line summaries, and engagement stats.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)