Instagram Data Fetcher

This skill fetches read-only data from Instagram — it never likes, comments, follows, or otherwise engages. It wraps Apify's official apify/instagram-scraper actor behind a standard agent interface, so every agent gets data with a single uniform command without setting up an Apify CLI call.

What does it do?

It runs one of four modes:

• profile — profile metadata: name, bio, follower/following/post counts, verification, external link.
• posts — the likes, comments, date, caption, and type (image / carousel / reel / video) of the last N posts.
• hashtag — the top/recent posts under one or more hashtags and their metrics.
• reel — the last N reels; performance including views (viewCount).

If you give a username it automatically converts it to a profile URL; if you give a full URL it uses it as-is. It filters out private/deleted accounts and returns a no_results warning.

When to use it?

When you need a snapshot of a competitor's IG account, engagement analysis of recent posts, a reel-views comparison, a hashtag trend scan, or follower-count tracking. Only public profiles/content can be fetched; content that requires login is out of scope.

Output

A JSON dataset with consistently keyed rows (id, type, likesCount, commentsCount, viewCount, timestamp, hashtags, etc.) — feedable directly into engagement analysis, ranking, or a report. The caller also gets a cost estimate (~$2.3/1K results). The credential is read from APIFY_API_TOKEN in ~/.claude/.env; starting with a low max_items is recommended for rate-limit and cost reasons.