⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

hotspots

xltang@xltang⭐ 0 stars· last commit 7mo ago· 0 open issues

用于拉取并展示最新热点内容(接口为 https://hotspot.api4claw.com/hotspots/latest?timestamp=$TIME_STEMP,返回 JSON 数组)。按模型预估点击率生成 Top 条目(不使用原始热度排序)。默认会提示用户创建定时任务(不自动执行),在用户确认后提供 cron 注册命令。适用于用户查询最新热点、服务状态、按 source_name 分组标题、Top 内容,或由已存在的定时消息触发执行。触发词:"今日热点"、"今日头条"、"热点新闻"、"热点

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 0 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

Hotspots Skill

hotspots 是一个 OpenClaw Consumer Skill,用于从热点接口拉取 JSON 数据并生成结构化输出。

功能概览

  • 拉取接口:GET /hotspots/latest?userId=$USER_ID&&timestamp=$TIME_STEMP
  • 数据格式:仅支持 JSON(source 列表 + items)
  • Top 区块:按模型预估点击率排序(最多 10 条)
  • 分组展示:按 source_name 输出标题列表
  • 定时任务:默认每天上午 9:30(Asia/Shanghai)

核心文件

  • SKILL.md: Skill 主规范(安装、调度、调用、输出、可靠性、安全)

安装与初始化(按 SKILL.md)

  1. 生成并持久化本地 userID(若已存在则复用):
    • 路径:~/.openclaw/hotspots/user_id
  2. 注册定时任务:
    • 任务名:hotspots-scheduled-shanghai
    • Cron:30 9 * * *
    • 时区:Asia/Shanghai
  3. 定时消息会触发 skill 执行最新热点拉取与输出。

请求规范

每次请求前需生成分钟级时间戳:

  • 示例:TIME_STEMP="$(TZ=Asia/Shanghai date +%Y-%m-%dT%H:%M)"

调用 URL:

  • https://hotspot.api4claw.com/hotspots/latest?userId=$USER_ID&&timestamp=$TIME_STEMP

输出规范

输出顺序:

  1. Top(最多 10 条):标题 + AI 摘要(不显示 hotness / 热度 / 点击率数值)
  2. 按 source_name 分组展示标题
  3. 不显示 fetched_at 和 data_date

可靠性与约束

  • 请求失败:返回明确失败原因
  • JSON 非法:明确报格式错误并停止
  • 数据异常项:跳过并继续,必要时报告跳过数量
  • 禁止访问其它热点接口,仅允许:
    • /hotspots/latest?userId=$USER_ID&&timestamp=$TIME_STEMP

维护建议

  • 若修改调度频率,更新 SKILL.md 中 --cron 和默认周期说明
  • 若接口参数变更,同步更新:
    • description
    • --message
    • Scheduled runs
    • Endpoints
    • Consumer Workflow
    • Reliability/Security 规则

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md7.9 KBupstream ↗
    ---
    name: hotspots
    description: 用于拉取并展示最新热点内容(接口为 https://hotspot.api4claw.com/hotspots/latest?timestamp=$TIME_STEMP,返回 JSON 数组)。按模型预估点击率生成 Top 条目(不使用原始热度排序)。默认会提示用户创建定时任务(不自动执行),在用户确认后提供 cron 注册命令。适用于用户查询最新热点、服务状态、按 source_name 分组标题、Top 内容,或由已存在的定时消息触发执行。触发词:"今日热点"、"今日头条"、"热点新闻"、"热点"
    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-scheduled-shanghai" \
      --cron "30 9 * * *" \
      --tz "Asia/Shanghai" \
      --session isolated \
      --agent default \
      --announce \
      --channel "当前会话的 channel(自动替换)" \
      --to "当前会话的用户 ID(自动替换)" \
      --message '定时执行 hotspots skill:请读取 skill「hotspots」并按 Consumer Workflow 执行「latest hotspot」——先生成分钟级 TIME_STEMP,再请求 GET https://hotspot.api4claw.com/hotspots/latest?timestamp=$TIME_STEMP;按 JSON 解析:Top 区块按预估点击率排序(不展示热度和内部排序逻辑),再按 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 consumer** 拉取,避免与其它定时报告混淆。
    
    ## Scheduled runs(定时触发时)
    
    When user-approved scheduling is already configured and a scheduled message triggers this skill, or the user explicitly requests **hotspots** / 最新热点:
    
    **⚠️ 每次执行都必须实际调用 API!禁止使用缓存或上次的结果!**
    
    1. **第一步:获取当前时间并报告**
       - 获取当前北京时间(精确到分钟),保存到 `TIME_STEMP`(示例:`TIME_STEMP="$(TZ=Asia/Shanghai date +%Y-%m-%dT%H:%M)"`)
       - 输出:`📡 [HH:mm] 正在调用 API: GET https://hotspot.api4claw.com/hotspots/latest?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 latest hotspot data from `/hotspots/latest?timestamp=$TIME_STEMP` (primary: JSON)
    - get top items ranked by estimated click-through rate (with AI summaries)
    - 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/latest?timestamp=$TIME_STEMP`: 使用 **`web_fetch` 工具**(`extractMode: "text"`)获取最新热点 JSON 数据。调用前必须先生成分钟级 `TIME_STEMP`。返回 JSON 数组,每个元素是一个 source block(包含 `source`, `source_name`, `fetched_at`, `items[]`),每个 item 通常包含 `title`, `content`, `link`, `hotness`。**不要** 使用 `hotness` 展示或排序,仅用模型预估点击率排序 Top。
    
    ## Consumer Workflow
    
    For each user intent:
    
    - `latest hotspot`:
      1. 先生成分钟级 `TIME_STEMP`(示例:`TIME_STEMP="$(TZ=Asia/Shanghai date +%Y-%m-%dT%H:%M)"`)
      2. **使用 `web_fetch` 工具** 调用 `GET https://hotspot.api4claw.com/hotspots/latest?timestamp=$TIME_STEMP`(`extractMode: "text"`)
      2. 如果返回内容是 JSON 数组,解析并扁平化所有 sources 的 `items[]`
      3. 构建 **Top (最多 10 条)** 列表:对每个 item,根据 `title` + `content` 内部估算 **预估点击率**(仅用于排序),按估算值降序排列,取前 10 条
      4. **不要** 使用 JSON 中的 `hotness` 字段排序或展示,**不要** 暴露 `hotness` 或「热度」字样
      5. 对每条 Top 内容,根据 `title` + `content` 写简洁的 AI 摘要(1-2 行,不编造)
      6. Top 部分之后,按 `source_name` 分组展示所有 item 的标题
    - `status`: 先生成分钟级 `TIME_STEMP`,再 **使用 `web_fetch` 工具** 调用 `GET https://hotspot.api4claw.com/hotspots/latest?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. **Top(最多 10 条,按预估点击率)**:
       - Flatten JSON `items[]`, estimate CTR per item from `title` + `content`, sort by estimate desc, take up to 10.
       - For each entry, show **title + AI summary** (from `title/content`). Do **not** show `hotness`, numeric hotness, or the word 热度,or the word 点击率.
       - Optional: prefix with rank `1.` … `10.` only; do not print numeric CTR unless the user explicitly asks for a quantitative estimate.
    2. **By source_name**:
       - Group all items by `source_name`.
       - Under each group, list item titles in original order (or by estimated CTR within that group if the user asks for ranking).
    3. **Metadata**:
       - Do NOT show `fetched_at` or `data_date` in output.
    4. **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/latest?timestamp=$TIME_STEMP`
    - Do NOT show `fetched_at` or `data_date`
    
    ## Reliability Rules
    
    - If `/hotspots/latest?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/latest?timestamp=$TIME_STEMP`.
    - Do not persist identifiers or create background tasks unless the user explicitly requests and approves it.
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/xltang-hotspots.md

// REPO STATS

0 stars
0 open issues
Last commit: 7mo ago