# weibo

Adopt this skill: https://proskills.md/skills/other/xltang-hotspots-weibo

Page: https://proskills.md/skills/other/xltang-hotspots-weibo
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 6919
upstream: https://github.com/xltang/hotspots_weibo/blob/HEAD/SKILL.md

````text
---
name: weibo
description: 用于拉取并展示微博热点内容（接口为 https://hotspot.api4claw.com/hotspots/platform/微博?timestamp=$TIME_STEMP，返回 JSON 数组）。默认会提示用户创建定时任务（不自动执行），在用户确认后提供 cron 注册命令。适用于用户查询微博热点、服务状态、按 source_name 分组标题，或由已存在的定时消息触发执行。触发词："微博"、"微博热点"。
required_tools:
  - web_fetch
optional_tools:
  - openclaw
network_access:
  - https://hotspot.api4claw.com
side_effects:
  - none_by_default
  - user_approved_optional_cron_setup
---

# OpenClaw Hotspot Consumer Skill

## Installation and Setup

Default mode is stateless and read-only.

Do not automatically:

- write local files
- generate persistent identifiers
- create/update cron jobs

By default, proactively suggest creating a cron job for daily updates. Do not execute commands automatically; provide manual commands and ask for confirmation before execution.

Default prompt template:

- `建议开启定时推送：每天 09:30 (Asia/Shanghai) 自动拉取微博热点。要我为你生成并执行 cron 创建命令吗？`

Optional manual setup example:

```bash
openclaw cron add \
  --name "hotspots-weibo-scheduled-shanghai" \
  --cron "30 9 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --agent default \
  --announce \
  --channel "当前会话的 channel（自动替换）" \
  --to "当前会话的用户 ID（自动替换）" \
  --message '定时执行 hotspots_weibo skill：请读取 skill「hotspots_weibo」并按 Consumer Workflow 执行「微博热点」——先生成分钟级 TIME_STEMP，再请求 GET https://hotspot.api4claw.com/hotspots/platform/微博?timestamp=$TIME_STEMP；按 JSON 解析并直接展示接口内容（按 source_name 分组标题）。'
```

If `openclaw` is unavailable, report setup failure and continue in non-scheduled mode.

### Prerequisites for scheduled runs

- 接收 cron 的 OpenClaw agent **须能加载本 skill**（同一项目中的 `SKILL.md` / 规则包）。若定时环境无本 skill，须在 `--message` 中内联完整 URL 与 Output Rules 要点。
- 修改 `--cron` / `--tz` 时保持 `--message` 明确为 **hotspots_weibo consumer** 拉取，避免与其它定时报告混淆。

## Scheduled runs（定时触发时）

When user-approved scheduling is already configured and a scheduled message triggers this skill, or the user explicitly requests **hotspots_weibo** / 微博热点:

**⚠️ 每次执行都必须实际调用 API！禁止使用缓存或上次的结果！**

1. **第一步：获取当前时间并报告**
   - 获取当前北京时间（精确到分钟），保存到 `TIME_STEMP`（示例：`TIME_STEMP="$(TZ=Asia/Shanghai date +%Y-%m-%dT%H:%M)"`）
   - 输出：`📡 [HH:mm] 正在调用 API: GET https://hotspot.api4claw.com/hotspots/platform/微博?timestamp=$TIME_STEMP`

2. **必须使用 `web_fetch` 工具** 调用上述 URL（`extractMode: "text"`）
   - ⛔ 禁止假设、禁止缓存、禁止编造数据
   - ⛔ 禁止跳过 API 调用直接使用旧数据

3. **第二步：报告调用结果**
   - 成功：输出 `✅ [HH:mm] API 调用成功，获取到 X 个来源，共 Y 条热点`
   - 失败：输出 `❌ [HH:mm] API 调用失败：[具体错误原因]`

4. 解析返回的 JSON 数组，按 **Consumer Workflow** 处理
5. 遵循本文件 **Output Rules** 与 **Reliability Rules**

**🔍 验证要求：** 每次输出的时间戳必须是当前实际时间，如果时间戳与预期不符或重复，说明没有实际调用 API。

## Scope

This skill is only for Consumer behavior.

Use this skill when users ask to:

- read 微博 hotspot data from `/hotspots/platform/微博?timestamp=$TIME_STEMP` (primary: JSON)
- view titles grouped by `source_name`
- check hotspot service status

Do not include Publisher generation logic or Server upload/storage internals in responses.

## Endpoints

Base URL:

- `https://hotspot.api4claw.com`

Only endpoint:

- `GET /hotspots/platform/微博?timestamp=$TIME_STEMP`: 使用 **`web_fetch` 工具**（`extractMode: "text"`）获取微博热点 JSON 数据。调用前必须先生成分钟级 `TIME_STEMP`。返回 JSON 数组，每个元素是一个 source block（包含 `source`, `source_name`, `fetched_at`, `items[]`），每个 item 通常包含 `title`, `content`, `link`, `hotness`。

## Consumer Workflow

For each user intent:

- `微博热点`:
  1. 先生成分钟级 `TIME_STEMP`（示例：`TIME_STEMP="$(TZ=Asia/Shanghai date +%Y-%m-%dT%H:%M)"`）
  2. **使用 `web_fetch` 工具** 调用 `GET https://hotspot.api4claw.com/hotspots/platform/微博?timestamp=$TIME_STEMP`（`extractMode: "text"`）
  3. 如果返回内容是 JSON 数组，解析并扁平化所有 sources 的 `items[]`
  4. 按 `source_name` 分组展示 item 标题
- `status`: 先生成分钟级 `TIME_STEMP`，再 **使用 `web_fetch` 工具** 调用 `GET https://hotspot.api4claw.com/hotspots/platform/微博?timestamp=$TIME_STEMP`，报告可达性 + 基础统计（source 数量、item 总数）。**不要** 展示 `fetched_at` 或 `data_date`
- `source filter`: 按 `source`/`source_name` 过滤展示

JSON grouping targets (if present):

- `xwlb` / `新闻联播`
- `weibo` / `微博`
- `zhihu` / `知乎`
- `qqMorningPost` / `腾讯早报`

## Configuration

Required:

- No user identifier is required.

Fixed:

- `HOTSPOT_BASE_URL`: `https://hotspot.api4claw.com` (constant, not configurable).

Recommended defaults:

- request timeout around `6000 ms`
- clear error text for timeout/network/HTTP failures

## Output Rules

When showing hotspot content, use this order:

1. **By source_name**:
   - Group all items by `source_name`.
   - Under each group, list item titles in original order.
2. **Metadata**:
   - Do NOT show `fetched_at` or `data_date` in output.
3. **Completeness checks**:
   - If some source has empty `items`, keep the source header and mark it as empty.

When showing status:

- reachable or unreachable
- endpoint used: `/hotspots/platform/微博?timestamp=$TIME_STEMP`
- Do NOT show `fetched_at` or `data_date`

## Reliability Rules

- If `/hotspots/platform/微博?timestamp=$TIME_STEMP` fails, return explicit failure reason.
- Do not fabricate content when server is unreachable.
- In JSON mode, skip malformed items safely and continue with valid items; report skipped count briefly if non-zero.
- If response is not valid JSON, report format mismatch explicitly and stop.
- Return explicit degraded reason and a next action.
- Keep responses concise and user-facing.

## Security Rules

- Do not expose tokens or secret headers in output.
- Do not call any hotspot endpoint except `/hotspots/platform/微博?timestamp=$TIME_STEMP`.
- Do not persist identifiers or create background tasks unless the user explicitly requests and approves it.
````

## File: README.md
upstream: https://github.com/xltang/hotspots_weibo/blob/HEAD/README.md

````text
# hotspots_weibo

微博热点消费型 Skill，基于 OpenClaw 使用统一接口拉取热点数据，并按 `source_name` 分组展示标题。

## 功能说明

- 拉取微博热点数据（JSON 数组结构）
- 按 `source_name` 分组展示热点标题
- 支持 `status` 状态检查（可达性 + 基本统计）
- 默认会提示是否创建 OpenClaw 定时任务；仅在用户确认后再提供/执行 cron 命令（不自动写盘、不自动生成标识）

## 接口信息

- Base URL: `https://hotspot.api4claw.com`
- Endpoint: `GET /hotspots/platform/微博?timestamp=$TIME_STEMP`

完整示例：

```text
https://hotspot.api4claw.com/hotspots/platform/微博?timestamp=$TIME_STEMP
```

## 快速使用

常见指令意图：

- `微博热点`：拉取并展示最新热点（按 `source_name` 分组）
- `status`：检查接口可达性并返回 source 数量、item 总数
- `source filter`：按 `source` 或 `source_name` 过滤结果

## 定时任务（OpenClaw）

默认先向用户确认是否需要定时推送；用户同意后再给出下方命令（Skill 内不自动执行）。

建议任务名：`hotspots-weibo-scheduled-shanghai`  
默认时区：`Asia/Shanghai`  
默认 cron：`30 9 * * *`

参考命令：

```bash
openclaw cron add \
  --name "hotspots-weibo-scheduled-shanghai" \
  --cron "30 9 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --agent default \
  --announce \
  --channel "当前会话的 channel（自动替换）" \
  --to "当前会话的用户 ID（自动替换）" \
  --message '定时执行 hotspots_weibo skill：请读取 skill「hotspots_weibo」并按 Consumer Workflow 执行「微博热点」——先生成分钟级 TIME_STEMP，再请求 GET https://hotspot.api4claw.com/hotspots/platform/微博?timestamp=$TIME_STEMP；按 JSON 解析并直接展示接口内容（按 source_name 分组标题）。'
```

## 输出规则（简版）

- 展示热点时按 `source_name` 分组
- 每组内按原顺序列出标题
- 不展示 `fetched_at`、`data_date`
- 某个 source 无 `items` 时仍保留分组并标记为空

## 可靠性与安全

- 接口失败时返回明确失败原因，不伪造内容
- JSON 非法时明确报错并停止
- 不输出 token 或敏感请求头
- 仅调用该项目约定接口：`/hotspots/platform/微博?timestamp=$TIME_STEMP`

## 文件说明

- `SKILL.md`：Skill 主说明与执行规则
- `README.md`：项目概览与快速上手文档

## License

This project is licensed under the MIT License. See `LICENSE`.
````
