Instagram Following Scraper

安装指南

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

什么是

Instagram Following Scraper 是一项 Openclaw Skills 集成，可将公开的 Instagram 用户名提交给 DataVoyantLab 的 Apify Actor，并返回这些账号关注的账号及可用的公开个人资料字段。它接受用户名、@username 值或个人资料 URL，并在运行前规范化和去重输入。
此工作流程旨在实现透明、可控的数据检索：检查 Actor 当前价格、设置费用上限，并要求用户在开始计费抓取前明确批准。它专用于关注列表，而非粉丝、Stories、Highlights、帖子或评论。

应用场景

查找一个或多个 Instagram 个人资料关注了哪些公开账号。
收集关注列表中的用户名和公开个人资料字段，用于研究或分析。
在一次 Apify 运行中提交最多 50 个不重复的 Instagram 用户名。
在用户拥有符合条件的 Apify 账号或获准使用 DataVoyantLab 免费用户权限时获取结果。
在执行前查看当前价格并批准确切的最高费用，以避免意外支出。

工作原理

确认请求针对的是个人资料关注的账号，而不是其粉丝或其他 Instagram 内容。
告知用户，请求中的用户名将发送至 Apify，并要求设置 APIFY_TOKEN 环境变量；不得显示或持久化其值。
规范化用户名、@username 值和 Instagram 个人资料 URL；移除重复项、拒绝空值，并在剩余不重复用户名超过 50 个时停止。
获取 Actor 当前价格，包括最低费用、Actor 启动价格和每个关注项目的价格。如果无法验证价格，则不要运行 Actor。
应用用户预算或默认的 5 USD 上限。拒绝低于 Actor 最低费用的预算；估算该上限可能涵盖的结果数量。
向用户展示 Actor、已验证的用户名、当前价格、预估结果数量、拟定上限和计费账号。只有在用户明确批准该确切上限后才能启动。
异步启动 Apify Actor，轮询其运行状态直至达到终止状态，并在成功后获取数据集项目。
返回所有已获取项目、运行 ID 和数据集 ID、请求的用户名、应用的上限，以及费用限制是否可能导致结果不完整。

配置指南

要求：
一个可访问该 Actor 的 Apify 账号所对应的 APIFY_TOKEN，或已获批准的 DataVoyantLab 免费用户权限。
环境中可使用 curl 和 jq。
每次计费运行前，向用户披露信息并明确获得对确切费用上限的批准。
此技能未指定软件包安装命令。将令牌配置为环境变量并妥善保密：
export APIFY_TOKEN="your-apify-token"
Actor ID 为 xDzzMiRH9Ha4YgBUy。每次运行前，请通过有文档说明的 Apify API 验证其最新有效价格。除非用户提供其他有效预算，否则最高费用默认为 5 USD。不得在不告知用户的情况下提高低于最低费用的预算，也不得将令牌发送到有文档说明的 Apify API 以外的任何位置。如果 Apify 拒绝未获批准的 Free 账号，请引导用户发送邮件至 datavoyant@gmail.com，并附上其 Apify 用户 ID 以申请访问权限。
Instagram Following Scraper 数据架构与分类体系
请求输入
字段 格式或限制
usernames 规范化后的 Instagram 用户名数组；每次运行最多 50 个不重复值
技能元数据 skill: true、skillName: instagram-following-scraper、skillVersion: 1.0.1
费用上限 maxTotalChargeUsd，设置为用户明确批准的预算或默认的 5 USD
Actor 输入为 JSON，例如 {"usernames":["natgeo"]}。用户提供的 @username 值和个人资料 URL 会在提交前进行规范化。
价格元数据
此技能会读取 .data.pricingInfos 中最新的有效条目，包括 minimalMaxTotalChargeUsd、Actor 启动事件价格以及 following-item-fetched.eventPriceUsd。结果数量上限估算值为（最高费用减去 Actor 启动价格）除以单项价格后向下取整；此估算并非保证值。
运行与结果数据
成功后，会从运行的数据集项目端点获取结果，并以干净的 JSON 返回。给用户的响应包括已获取项目、运行 ID、数据集 ID、请求的用户名、应用的最高费用，以及在费用上限可能导致采集停止时发出的结果不完整警告。此技能未指定本地文件生成或持久化格式。

高级特性

在启动运行前验证 Actor 实时价格和允许的最低费用。
使用明确的最高费用，并要求每次计费执行前对该确切上限作出肯定批准。
根据 Actor 启动价格和单项价格估算可能的结果数量，并明确说明估算不作保证。
异步运行、轮询终止状态，并且仅在成功后获取数据集项目。
在费用限制可能导致采集停止时报告结果可能不完整；此时不声称结果完整。
将令牌的使用限制在有文档说明的 Apify API 中，不显示或持久化令牌。
将关注列表检索与粉丝列表抓取区分开，并明确排除 Stories、Highlights、帖子和评论。

name: instagram-following-scraper description: Extract the accounts followed by public Instagram profiles through Apify. Use when a user asks who an Instagram account follows or needs following-list usernames and public profile fields; do not use for follower lists, Stories, Highlights, posts, or comments.