安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install instagram-highlights-scraper
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 instagram-highlights-scraper。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Instagram Highlights Scraper 是一项 Openclaw Skills 集成，可使用 DataVoyantLab 的 Apify Actor，从公开 Instagram 精选动态网址获取快拍媒体和可用元数据。它接受精选动态网址，而非个人资料网址或用户名，并返回完整的数据集项目，按提交的网址分组或计数，不会剔除原始字段。
此工作流程旨在安全、审慎控制成本地提取数据：验证并规范化网址、检查当前 Actor 价格、计算最高费用，并要求用户在任何计费运行前批准该确切上限。此功能需要付费 Apify 账户或获批准的 DataVoyantLab 免费用户资格。

应用场景

用户提供
instagram.com/stories/highlights/
网址时，从一个或多个公开 Instagram 精选动态中提取快拍项目。
收集精选动态合集中的可用媒体和元数据，用于研究或报告。
批量处理精选动态网址，并按提交的网址查看结果。
检查当前 Apify 价格，并在开始提取前提供明确的支出上限。
识别成功但结果为空的情况；这可能表示精选动态不可用、设为私密、已过期或为空。
不用于当前 24 小时快拍、个人资料网址、用户名、粉丝、关注列表、帖子或评论。

工作原理

要求提供 APIFY_TOKEN 并妥善保密；仅将其用于文档说明的 Apify API。
仅接受路径以 /stories/highlights/ 开头且后接数字精选动态 ID 的 HTTPS Instagram 网址。移除片段和追踪参数、规范化尾部斜线、去重链接，并拒绝无效网址。
使用规范化链接及技能元数据构建 Actor 输入：skill: true、skillName: instagram-highlights-scraper 和 skillVersion: 1.0.1。
获取 Actor 的有效价格信息，并读取 Actor 启动价格和每个链接的 link-request 事件价格。若有效价格或所需事件信息缺失，则不得继续。
将费用上限计算为 Actor 启动价格加上唯一链接数量乘以每链接价格，再加 $0.01；向上取整至美分。
每次计费运行前，告知用户 Actor、唯一链接数量、当前价格、确切的 maxTotalChargeUsd 上限，以及与该令牌关联的 Apify 账户将被扣费。只有在用户明确批准该确切上限后才可继续；若输入或价格发生变化，须重新计算并再次请求批准。
对于不超过 10 个链接的批次，调用同步运行并获取端点。对于更大的批次，启动异步运行、轮询至终止状态，并获取其默认数据集。
返回所有数据集项目、最高授权费用，以及可用时的运行和数据集标识符。按提交的精选动态网址分组或计数项目，保留原始字段，并如实报告成功但结果为空的情况，不得编造数据。

配置指南

创建或访问具有付费权限的 Apify 账户，或拥有获批准的 DataVoyantLab 免费用户资格的账户。
在代理的环境中配置 APIFY_TOKEN。技能还需要系统提供 curl 和 jq。切勿显示或持久保存令牌。
每次运行前，通过文档说明的 Apify API 确认 Actor 的有效价格；价格必须同时包含 Actor 启动和每链接 link-request 事件。
发送运行请求前，取得用户对计算所得最高费用的明确批准。仅请求提取精选动态并不代表已授权付款。

在环境中安全设置令牌；不要将其粘贴到日志或输出中。

export APIFY_TOKEN=""

确认已安装所需的命令行工具。

command -v curl
command -v jq
Actor ID：sUluczVbvIYrxH5n7。Actor 商店页面：https://apify.com/datavoyantlab/instagram-highlights-scraper-api-by-url。如果 Apify 拒绝未获批准的免费账户，请发送电子邮件至 datavoyant@gmail.com，并附上 Apify 用户 ID 申请访问权限。
Instagram Highlights Scraper 数据架构与分类体系
Actor 输入
字段 类型 说明
links 字符串数组 经过验证、带有数字 ID 的 HTTPS Instagram 精选动态网址。
skill 布尔值 设置为 true 以标识技能请求。
skillName 字符串 instagram-highlights-scraper。
skillVersion 字符串 1.0.1。
输入示例：
{
"links": ["https://www.instagram.com/stories/highlights/1234567890/"],
"skill": true,
"skillName": "instagram-highlights-scraper",
"skillVersion": "1.0.1"
}
结果和运行元数据
Actor 返回包含已获取快拍项目、媒体和可用元数据的数据集项目。具体项目字段由 Actor 决定；保留原始字段，不要假定存在固定架构。
按提交的精选动态网址整理或统计返回的项目。
返回完整数据集项目，以及可用时的运行 ID 和数据集 ID，并附上最高授权费用。
成功但数据集为空是有效结果，应如实报告；除了指出精选动态可能不可用、设为私密、已过期或没有可获取的公开项目外，不要推断缺失内容。
计费事件包括 Actor 启动和提交的精选动态链接。计算得出的上限包含这两类事件的费用，以及 $0.01 缓冲额，并向上取整至美分。

高级特性

按照确切的精选动态路径和数字 ID 要求验证 HTTPS 网址；移除片段和追踪参数、规范化尾部斜线，并对链接去重。
检查最新的有效 Apify 价格条目；如果缺少所需价格信息，则拒绝启动。
计算并强制执行
maxTotalChargeUsd
上限，每次计费运行都必须取得用户明确批准。
对不超过 10 个链接的批次使用同步运行并获取；对更大的批次使用异步运行轮询并获取数据集。
仅在文档说明的 Apify API 中使用 Apify 令牌，不显示或持久保存令牌。
保留完整的原始数据集项目，并按提交的精选动态网址整理结果。

name: instagram-highlights-scraper description: Extract public Instagram Highlights from Highlight URLs through Apify, including their story media and available metadata. Use when a user supplies instagram.com/stories/highlights URLs or asks to download Highlight contents; do not use for current Stories, followers, following lists, posts, or comments.