Instagram Stories 抓取器

安装指南

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

什么是

Instagram Stories 抓取器是 Openclaw Skills 的一项集成，用于在 Apify 上使用 DataVoyantLab 的 Advanced Instagram Stories Scraper。它会获取公开个人资料当前发布的 Stories，并返回完整数据集，包括可用的照片或视频 URL、时间戳、提及、链接贴纸、音乐、地点和付费合作元数据。
此技能专为经过明确批准且需付费的抓取而设计：它会检查当前价格、计算最高费用，并要求用户明确同意后才开始运行。它不会抓取精选动态、粉丝、关注列表、帖子、Reels 或评论。

应用场景

获取一个或多个公开 Instagram 个人资料当前仍有效的 Stories。
收集可用的媒体 URL 和 Story 时间戳，用于研究或报告。
查看 Story 提及、链接贴纸、音乐、地点或付费合作信号。
使用适当的同步或异步工作流程，批量获取最多 100 个用户名的 Stories。
检查公开个人资料；结果为空也可能只是因为当前没有有效的 Stories。

工作原理

收集用户名、@username 值或 Instagram 个人资料 URL。告知用户，所请求的用户名将发送至 Apify。
要求提供 APIFY_TOKEN，将输入规范化为用户名，删除重复项和空值；如果剩余的唯一用户名超过 100 个，则停止操作。
获取公开的 Apify Actor 记录并确定最新适用价格。根据 Actor 启动价格、每个用户名的价格和 $0.01 缓冲金额计算费用上限，并向上取整到下一个美分。
显示 Actor、已验证的用户名、当前价格、确切的 maxTotalChargeUsd 上限和计费通知。在用户明确批准该确切上限之前，不得继续。
通过同步 dataset 端点提交最多 10 个用户名。对于 11–100 个用户名，启动异步运行、轮询其状态，并在成功后获取 dataset 项目。
返回完整的 dataset 项目、已授权的最高费用、按所请求用户名统计的数量，以及在异步流程中返回运行 ID 和 dataset ID。将成功但结果为空的情况报告为有效结果，而非失败。

配置指南

为该技能提供所需的环境变量和命令行工具。与令牌关联的 Apify 账户必须拥有付费访问权限，或获得 DataVoyantLab Free-user 资格授权。
export APIFY_TOKEN="your_apify_token"
command -v curl
command -v jq
切勿打印 APIFY_TOKEN、将其存入文件或将其包含在 URL 中。只能将其作为 bearer token 发送至有文档说明的 Apify API。每次付费运行前，检查当前 Actor 价格，并就计算得出的确切费用上限取得明确批准。该技能未指定单独的软件包安装命令。
Instagram Stories 抓取器 数据架构与分类体系
请求输入
字段 格式 限制
usernames 字符串数组 每次运行最多 100 个唯一 Instagram 用户名
Attribution skill、skillName、skillVersion 分别设为 true、instagram-stories-scraper 和 1.0.1
可接受的输入包括用户名、@username 值和 Instagram 个人资料 URL。通过去除首尾空格并删除开头的 @，将其规范化为用户名；保留句点和下划线，删除重复项，并拒绝空值。使用 jq 构建请求 JSON，不要手动插值。
结果和运行元数据
Actor 会返回 dataset 项目，包括可用的 Story 媒体 URL，以及时间戳、提及、链接贴纸、音乐、地点和付费合作信号等元数据。该技能未指定固定的逐字段输出架构。对于异步运行，还要返回运行 ID 和 dataset ID。包含已授权的最高费用，以及按所请求用户名统计的简要结果数量。没有可用的有效 Stories 时，空 dataset 也可能是成功结果。

高级特性

用户名不超过 10 个时选择同步获取；11–100 个时选择异步运行。
每次运行前验证 Actor 的实时价格，并设置
maxTotalChargeUsd
，加入一美分缓冲后向上取整到下一个美分。
发起付费请求前，必须取得对确切费用上限的明确批准；用户名、价格或上限发生变化时，必须重新取得批准。
持续轮询异步运行，直至达到终止状态；只有运行成功后才获取 dataset 项目。
保留完整的 dataset 结果，并将成功但结果为空的 dataset 与失败、中止或超时的运行分别报告。
将令牌的处理限制在有文档说明的 Apify API 范围内，并避免暴露内部日志详情。

name: instagram-stories-scraper description: Scrape current public Instagram Stories by username through Apify, including media URLs and rich story metadata. Use when a user needs live Stories, story downloads, mentions, links, music, locations, or paid-partnership signals; do not use for Highlights, followers, following lists, posts, or comments.