Install
npx skills add DataVoyantLab/instagram-agent-skills --all
Open agent skills
Give your agent five focused ways to collect public Instagram data through DataVoyantLab Actors on Apify. Install once, describe the result you need, and keep every run within a defined spending limit.
Quick start
The skills use the Apify REST API. No Instagram login is required.
npx skills add DataVoyantLab/instagram-agent-skills --allexport APIFY_TOKEN="your_token"Describe the profiles, links, hashtags, time window, and budget you need.
Choose the right skill
Advanced Stories is the recommended starting point for live story media and metadata.
instagram-stories-scraper
Get current public Stories with media URLs, timestamps, mentions, links, music, locations, and partnership metadata.
“Download the current public stories for natgeo and return every media URL.”
npx skills add DataVoyantLab/instagram-agent-skills --skill instagram-stories-scraperinstagram-followers-scraper
Extract follower usernames and available public profile fields with a maximum spend set before the run.
“Get the followers of this public Instagram profile with a maximum spend of $2.”
npx skills add DataVoyantLab/instagram-agent-skills --skill instagram-followers-scraperinstagram-following-scraper
Find the accounts followed by one or more public Instagram profiles for research and lead workflows.
“Find the accounts followed by these three Instagram usernames.”
npx skills add DataVoyantLab/instagram-agent-skills --skill instagram-following-scraperinstagram-highlights-scraper
Extract story items and available metadata from public Instagram Highlight URLs.
“Extract every story item from these Instagram Highlight URLs.”
npx skills add DataVoyantLab/instagram-agent-skills --skill instagram-highlights-scraperinstagram-campaign-monitor
Monitor recent branded hashtag posts, filter with brand terms, and optionally deliver matches to a webhook.
“Monitor #mycampaign for the last 24 hours and send matching posts to this webhook.”
npx skills add DataVoyantLab/instagram-agent-skills --skill instagram-campaign-monitorPredictable execution
Each skill checks the Actor's active pay-per-event pricing before execution and sends Apify's maxTotalChargeUsd parameter.
Followers and Following use a $5 default cap when no budget is supplied. Other skills calculate their cap from the submitted usernames, links, or scan pages.
The complete dataset and run identifiers remain available for downstream automation. Empty successful results are reported as empty, not as failures.
Apify access
The skills call external paid services on Apify. Approved Free users receive limited access through the existing DataVoyantLab entitlement system.
Questions
No. They teach an AI agent how to call the corresponding DataVoyantLab Actor. The Actor collects the requested public data when the skill runs.
The instructions require the token through the APIFY_TOKENenvironment variable and explicitly prevent printing or storing it.
Only approved Free users can run these Actors. Email DataVoyantLab with the Apify user ID that will execute the run.
The agent returns the dataset items and keeps the run and dataset identifiers available for later API calls or automation.
Start with Stories
Install the full collection or begin with the Advanced Instagram Stories skill.