Get Instagram profiles, posts, and reels

Instagram scraper

by gooseworks-ai · MIT license · ★ 1,220 on GitHub · updated Sep 21

---
name: instagram-scraper
description: Get Instagram profiles, posts, and reels
source: scrapecreators
---


# Instagram Scraper

## Setup

Read `scrapecreators-api` first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.


Scrape public Instagram data including profiles, posts, and reels.

## When to Use

Overview

Read scrapecreators-api first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.

Manual install (npx, ZIP)

Claude Codenpx skills add gooseworks-ai/goose-skills --skill instagram-scraper -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/gooseworks-ai/goose-skills/tar.gz/615c685f34f8 \
  | tar -xz -C ~/.claude/skills --strip-components=4 goose-skills-615c685f34f8/skills/social/capabilities/instagram-scraper

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/09b50032f62adc04fc62/instagram-scraper.zip" -OutFile "$env:TEMP\instagram-scraper.zip"; Expand-Archive "$env:TEMP\instagram-scraper.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md2.3 KB
skill.meta.json330 B

Read the files here

gooseworks-ai/615c6852 files

SKILL.md

Show the full text107 lines

instagram-scraper/SKILL.md107 lines · 2.3 KB

Instagram Scraper

Setup

Read scrapecreators-api first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.

Scrape public Instagram data including profiles, posts, and reels.

When to Use

User asks about Instagram content
User wants to see posts from an account
Social media research

How It Works

Uses the ScrapeCreators API through its direct GooseWorks proxy.

Usage

Get User Profile & Posts

provider: scrapecreators
method: GET
path: /v1/instagram/profile
query:
  handle: openai

Get Individual Post/Reel

provider: scrapecreators
method: GET
path: /v1/instagram/post
query:
  url: https://instagram.com/p/abc123

Get Basic Profile by User ID

provider: scrapecreators
method: GET
path: /v1/instagram/basic-profile
query:
  userId: "12345"

Parameters

Profile

handle (required) - Instagram handle (without @)
trim (optional) - Set to "true" for a trimmed response

Post/Reel

url (required) - Instagram post or reel URL
trim (optional) - Set to "true" for a trimmed response

Basic Profile

userId (optional) - Instagram user ID

Response

Profile includes:

Username, display name, bio
Follower/following counts
Recent posts with captions, URLs, engagement metrics
Profile image

Post includes:

Post caption
Image/video URLs
Like count
Comment count
Timestamp

Examples

User: "What's OpenAI posting on Instagram?" Use the Get User Profile & Posts operation with handle: openai.

User: "Get details on this Instagram post" Use the Get Individual Post/Reel operation with the supplied post URL.

Error Handling

success: false — the API may temporarily fail; retry after a few seconds
Private accounts cannot be accessed — no workaround
Rate limiting may cause failures on rapid requests — add delays between calls

Tips

Private accounts cannot be accessed
Remove @ from handles
API may return errors for rate limiting - retry after a few seconds

1	---
2	name: instagram-scraper
3	description: Get Instagram profiles, posts, and reels
4	source: scrapecreators
5	---
6
7
8	# Instagram Scraper
9
10	## Setup
11
12	Read `scrapecreators-api` first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.
13
14
15	Scrape public Instagram data including profiles, posts, and reels.
16
17	## When to Use
18
19	- User asks about Instagram content
20	- User wants to see posts from an account
21	- Social media research
22
23	## How It Works
24
25	Uses the ScrapeCreators API through its direct GooseWorks proxy.
26
27	## Usage
28
29	### Get User Profile & Posts
30
31	```yaml
32	provider: scrapecreators
33	method: GET
34	path: /v1/instagram/profile
35	query:
36	handle: openai
37	```
38
39	### Get Individual Post/Reel
40
41	```yaml
42	provider: scrapecreators
43	method: GET
44	path: /v1/instagram/post
45	query:
46	url: https://instagram.com/p/abc123
47	```
48
49	### Get Basic Profile by User ID
50
51	```yaml
52	provider: scrapecreators
53	method: GET
54	path: /v1/instagram/basic-profile
55	query:
56	userId: "12345"
57	```
58
59	## Parameters
60
61	### Profile
62	- handle (required) - Instagram handle (without @)
63	- trim (optional) - Set to "true" for a trimmed response
64
65	### Post/Reel
66	- url (required) - Instagram post or reel URL
67	- trim (optional) - Set to "true" for a trimmed response
68
69	### Basic Profile
70	- userId (optional) - Instagram user ID
71
72	## Response
73
74	### Profile includes:
75	- Username, display name, bio
76	- Follower/following counts
77	- Recent posts with captions, URLs, engagement metrics
78	- Profile image
79
80	### Post includes:
81	- Post caption
82	- Image/video URLs
83	- Like count
84	- Comment count
85	- Timestamp
86
87	## Examples
88
89	User: "What's OpenAI posting on Instagram?"
90	Use the Get User Profile & Posts operation with `handle: openai`.
91
92	User: "Get details on this Instagram post"
93	Use the Get Individual Post/Reel operation with the supplied post URL.
94
95	## Error Handling
96
97	- success: false — the API may temporarily fail; retry after a few seconds
98	- Private accounts cannot be accessed — no workaround
99	- Rate limiting may cause failures on rapid requests — add delays between calls
100
101
102	## Tips
103
104	- Private accounts cannot be accessed
105	- Remove @ from handles
106	- API may return errors for rate limiting - retry after a few seconds
107