Agent skill

Instagram

by unifapi-agent in unifapi-agent/agents

When a workflow needs public Instagram data through UnifAPI — profiles and follower size, posts and reels with engagement, post comments, location pages, or search.

MITAuto-check passedMarketing & SEO

Install Instagram

skills CLI
$ npx skills add unifapi-agent/agents --skill instagram -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install unifapi-agent/agents instagram --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/instagram-agent/instagram .claude/skills/instagram && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
instagram
GitHub stars
587
Token cost
~1.6k tokens
SKILL.md length
548 words
Files
2
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

When a workflow needs public Instagram data through UnifAPI — profiles and follower size, posts and reels with engagement, post comments, location pages, or search.

  • Works in 6 steps: Resolve a profile. Call… → Read content and engagement. Call… → Read reaction. Call… → …
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers Use the unifapi skill for live…, Response contract, Core operations and Workflow, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Instagram is an agent skill from unifapi-agent/agents. When a workflow needs public Instagram data through UnifAPI — profiles and follower size, posts and reels with engagement, post comments, location pages, or search. Also use on "research these IG creators," "pull posts for," "Instagram follower count," "comments on this post," "is this a paid partnership," or when another skill (KOL pricing, creator shortlist, audience fit) needs the deterministic Instagram read path. Connect via the unifapi skill first. Read-only research, never posts or DMs.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Marketing & SEO, covering Messaging and chat bots and Programmatic SEO. It works with Instagram. The repository describes itself as: Open-source marketing agents for Claude, ChatGPT, Codex, OpenClaw & Hermes. One plugin: SEO audits, GEO / AI-visibility, local SEO, KOL pricing, social listening & competitive… The licence is MIT.

When your agent uses it

  • Tasks that involve Messaging and chat bots
  • Tasks that involve Programmatic SEO

Example prompts

  • “research these IG creators,”
  • “pull posts for,”
  • “Instagram follower count,”
  • “/instagram”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Resolve a profile. Call instagram/users/{username} for follower_count,
  2. Read content and engagement. Call instagram/users/{username}/posts and
  3. Read reaction. Call instagram/posts/{shortcode}/comments (and the
  4. Discover new handles. Call instagram/search?q=...,
  5. Map a network or audience. Call instagram/users/{username}/followers,
  6. Cite everything. Every figure ties back to the post or profile it came

What it can do on your machine

Read from SKILL.md and the folder at commit fb53247. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Instagram loads about 1.6k tokens when it runs. Until then it costs about 128 tokens; SKILL.md has 548 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~128
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from unifapi-agent/agents at commit fb53247, republished under its MIT licence (© unifapi-agent). 548 words, ~1,607 tokens.

Download SKILL.mdSave it as .claude/skills/instagram/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
instagram
description
When a workflow needs public Instagram data through UnifAPI — profiles and follower size, posts and reels with engagement, post comments, location pages, or search. Also use on "research these IG creators," "pull posts for," "Instagram follower count," "comments on this post," "is this a paid partnership," or when another skill (KOL pricing, creator shortlist, audience fit) needs the deterministic Instagram read path. Connect via the `unifapi` skill first. Read-only research, never posts or DMs.
license
MIT
metadata.author
UnifAPI
metadata.version
1.0.0
metadata.homepage
https://unifapi.com/agents/instagram
metadata.source
https://github.com/unifapi-agent/agents

instagram

The deterministic read path for public Instagram data through UnifAPI. This is a Data Skill: it does not run a marketing job on its own — it names the concrete instagram/... operations, response shapes, and gotchas so any creator-first workflow (shortlisting, audience-fit, pricing context) reads from one known recipe instead of rediscovering the surface each time.

Read-only — eyes, not hands. It researches public Instagram data and returns cited records; it never posts, comments, or DMs, and UnifAPI never holds Instagram credentials.

Use the unifapi skill for live evidence

Connect once through the shared unifapi skill (OAuth MCP), then call the operations below. Profiles are keyed by {username} and posts by their {shortcode} (the URL segment) — instagram/resolve/* maps between username↔user-id and shortcode↔media-id when you need it. Keep any billing metadata so the output can state record cost.

Response contract

Single-entity endpoints return the object in data:

json
{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

List endpoints return an array in data plus pagination:

json
{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

When pagination.has_more is true, pass pagination.next_cursor as the next request's cursor. Always preserve billing when reporting cost.

Core operations

NeedOperation
Profile by handleinstagram/users/{username}
Posts / reelsinstagram/users/{username}/posts · .../reels
Stories / highlightsinstagram/users/{username}/stories · .../highlights
Followers / followinginstagram/users/{username}/followers · .../following
Tagged postsinstagram/users/{username}/tagged-posts
Post by shortcodeinstagram/posts/{shortcode}
Post comments / repliesinstagram/posts/{shortcode}/comments
Discoverinstagram/search (?q=...) · instagram/explore
Location page + postsinstagram/locations/{id} · instagram/locations/{id}/posts
Resolve handle/shortcodeinstagram/resolve/user-id · instagram/resolve/shortcode

Need a field not listed here? Use the unifapi skill's get_operation to read the exact schema before calling — but pick the operation from this table, don't discover blind.

Workflow

The deterministic recipes. Pick the one that matches the job; each names exactly what to call.

  1. Resolve a profile. Call instagram/users/{username} for follower_count, media_count, is_private, and is_verified.
  2. Read content and engagement. Call instagram/users/{username}/posts and .../reels; each InstagramPost carries like_count, comment_count, and play_count/view_count for video — and is_paid_partnership to flag sponsored content. Page via next_cursor.
  3. Read reaction. Call instagram/posts/{shortcode}/comments (and the replies endpoint) for sentiment on a top post.
  4. Discover new handles. Call instagram/search?q=..., instagram/explore, or instagram/locations/{id}/posts, then resolve the surfaced handles and loop to step 1.
  5. Map a network or audience. Call instagram/users/{username}/followers, .../following, or .../tagged-posts (who features them) for reach work.
  6. Cite everything. Every figure ties back to the post or profile it came from; report billing.records_charged (or estimate when billing metadata is absent).
Show full SKILL.md (174 more words)Show less

Shape notes

  • InstagramUser — keyed by {username}. follower_count, following_count, media_count, is_verified, is_private.
  • InstagramPost — keyed by {shortcode}. caption, like_count, comment_count, play_count, view_count, taken_at, media_type, is_paid_partnership, user, location, carousel.
  • InstagramComment — text, like_count, child_comment_count.
  • InstagramLocation — name, lat, lng, media_count.

Gotchas

  • Profiles are keyed by {username}, posts by {shortcode} — both read from the public IG URL. Use instagram/resolve/* only when you need the numeric user-id or media-id.
  • A private account (is_private) exposes the profile but limits media — surface it, don't paper over thin coverage.
  • is_paid_partnership marks disclosed sponsored posts — useful evidence for pricing and brand-safety, report it.
  • A low balance can silently truncate list pages: check billing.truncated_due_to_balance — when true the page is partial.

Output

Return the records the calling workflow needs, each cited to its post or profile, plus a one-line cost note (records_charged). When this skill is used directly, a compact creator summary is the default:

markdown
**@handle** — {followers} followers, {media} posts, verified {yes/no}. Recent posts: avg {likes} likes / {comments} comments. Paid partnerships: {N}. Evidence: {post URLs}. Records: ~{N}.
  • kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — price and vet Instagram creators on top of this read path.
  • unifapi — the shared data skill: connect MCP and look up exact schemas with get_operation.

© unifapi-agent, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/instagram-agent/instagram of unifapi-agent/agents.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit fb53247

Compare with similar skills

Instagram next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Instagram compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Instagram this skillunifapi-agent/agents587—~1.6kAutomated safety check: PassMIT
Threads Growthsocial-media-skills/skills125—~1.8kAutomated safety check: PassMIT
Comment FunnelLeoYeAI/openclaw-master-skills2.2k—~4.1kAutomated safety check: PassMIT
SEO Competitor Comparison PagesAgriciDaniel/claude-seo18k5 repos~1.9kAutomated safety check: PassMIT
Meta Ad Builderkrusemediallc/arcads-claude-code1.6k—~1.7kAutomated safety check: NotesMIT
Smscoreyhaines31/marketingskills54k1 repos~4.6kAutomated safety check: PassMIT

Similar skills

  • Threads Growth

    social-media-skills/skills

    The Threads account-growth strategy skill -- the channel layer above threads-post.

    125 GitHub stars~1.8k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed
  • Comment Funnel

    LeoYeAI/openclaw-master-skills

    Automate Instagram comment-to-DM funnels using the Upload-Post API.

    2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • SEO Competitor Comparison Pages

    AgriciDaniel/claude-seo

    Generates X vs Y comparison pages, alternatives-to-X pages, best-tools roundups and feature-matrix tables, with schema markup and verifiable data rules.

    18k GitHub starsUsed in 5 repos~1.9k tokens
    Marketing & SEOAuto-check passed
  • Meta Ad Builder

    krusemediallc/arcads-claude-code

    Publish finished creatives as live Meta (Facebook/Instagram) ads via the Meta Marketing API, plus research and ad-copy support.

    1.6k GitHub stars~1.7k tokensUpdated 15 days ago
    Marketing & SEOAuto-check: notes
  • Sms

    coreyhaines31/marketingskills

    When the user wants to plan, build, or optimize SMS, MMS, or WhatsApp marketing — including welcome flows, abandoned cart texts, post-purchase, win-back, promotional sends, or transactional/auth SMS.

    54k GitHub starsUsed in 1 repo~4.6k tokens
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    18k GitHub stars~4.9k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

More from unifapi-agent/agents

All 47 skills in this repo
  • LLM Mention Tracking

    unifapi-agent/agents

    When the user wants to track how often their brand or domain gets mentioned across ChatGPT and AI search engines over a set of prompts, and how that share of voice compares to named competitors over…

    587 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Buying Signal Monitor

    unifapi-agent/agents

    When a seller or SDR wants to catch public buying intent on X/Twitter and LinkedIn — someone asking for a tool they sell, complaining about or switching off a competitor, or hiring for a role that…

    587 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Customer Research

    unifapi-agent/agents

    When the user wants to research customers from public communities, or synthesize customer language, pains, and objections.

    587 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Keyword Research

    unifapi-agent/agents

    When the user wants to research keywords, find keyword opportunities, run a keyword gap analysis, build topic clusters, or compare what competitors rank for.

    587 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Schema

    unifapi-agent/agents

    When the user wants to add, fix, or optimize schema markup and structured data on their site.

    587 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • SEO Audit

    unifapi-agent/agents

    When the user wants to audit, review, or diagnose SEO issues on their site.

    587 GitHub stars~3.4k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Instagram

What does Instagram do?

When a workflow needs public Instagram data through UnifAPI — profiles and follower size, posts and reels with engagement, post comments, location pages, or search. Instagram is an agent skill from unifapi-agent/agents. When a workflow needs public Instagram data through UnifAPI — profiles and follower size, posts and reels with engagement, post comments, location pages, or search.

When should I use Instagram?

Instagram fits situations like: tasks that involve Messaging and chat bots; tasks that involve Programmatic SEO.

How do I install Instagram in Claude Code?

Run `npx skills add unifapi-agent/agents --skill instagram -a claude-code`. Or copy the skill folder (skills/instagram-agent/instagram in unifapi-agent/agents) into .claude/skills/instagram in your project. Claude Code loads it when a task matches its description.

How do I install Instagram in Codex?

Run `npx skills add unifapi-agent/agents --skill instagram -a codex`. Or copy the skill folder (skills/instagram-agent/instagram in unifapi-agent/agents) into .agents/skills/instagram in your project. Codex loads it when a task matches its description.

Can I use Instagram in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add unifapi-agent/agents --skill instagram -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/instagram, .gemini/skills/instagram, .github/skills/instagram and .opencode/skills/instagram in your project.

What does Instagram need to run?

SKILL.md names no scripts, command-line tools or credentials: Instagram is instructions for the agent only.

Does Instagram access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Instagram safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Instagram use?

Instagram is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Instagram use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Instagram?

Skills that share tags, products or a category with Instagram: Threads Growth (social-media-skills/skills, 125 stars), Comment Funnel (LeoYeAI/openclaw-master-skills, 2.2k stars), SEO Competitor Comparison Pages (AgriciDaniel/claude-seo, 18k stars) and Meta Ad Builder (krusemediallc/arcads-claude-code, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Instagram?

unifapi-agent (a GitHub organization) maintains it in unifapi-agent/agents, which has 587 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on September 5, 2026.

Source: unifapi-agent/agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.