Skip to content
Back to search

instagram-skills

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/sergebulaev/instagram-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/sergebulaev/instagram-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sergebulaev--instagram-skills/badge.svg)](/listings/sergebulaev--instagram-skills)

HTML

<a href="/listings/sergebulaev--instagram-skills"><img src="/api/listings/sergebulaev--instagram-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Pick whichever way you use Claude Code or Codex:

Codex CLI

codex plugin marketplace add sergebulaev/instagram-skills
codex plugin add instagram-skills@instagram-skills

To test a local clone before publishing changes:

git clone https://github.com/sergebulaev/instagram-skills.git
cd instagram-skills
codex plugin marketplace add .
codex plugin add instagram-skills@instagram-skills

claude.ai (web)

1. Open https://claude.ai/code 2. Go to **Skills** in the sidebar 3. Click **Add from GitHub** 4. Paste: `sergebulaev/instagram-skills` 5. Done. The skills activate automatically when you ask about Instagram.

Claude Desktop (Mac / Windows)

1. Open Claude Desktop 2. Open **Settings** (gear icon) 3. Go to **Skills** 4. Click **Add from GitHub** 5. Paste: `sergebulaev/instagram-skills` 6. Done. Start a new conversation and ask Claude to write a caption.

Claude Code (CLI / VS Code / JetBrains)

/plugin marketplace add sergebulaev/instagram-skills
/plugin install instagram-skills@instagram-skills

Or clone the repo and open it as your working directory:

git clone https://github.com/sergebulaev/instagram-skills.git
cd instagram-skills

OpenClaw

1. Open your OpenClaw working directory 2. Clone the skills into it:

   git clone https://github.com/sergebulaev/instagram-skills.git

3. In OpenClaw settings, add this to your system prompt:

   You have Instagram marketing skills in ./instagram-skills/.
   For any Instagram task, read the relevant skills/*/SKILL.md first.
   Use lib/url_parser.py for URL parsing and lib/publora_client.py for publishing.

4. Done. Ask OpenClaw to write an Instagram post.

Hermes Agent

Hermes Agent (Nous Research) follows the agentskills.io open standard and loads `skills/*/SKILL.md` directly. Clone the bundle into your Hermes skills folder:

git clone https://github.com/sergebulaev/instagram-skills.git ~/.hermes/skills/instagram-skills

Coming from OpenClaw? `hermes claw migrate` imports these skills automatically. Then call `/<skill-name>` from any of your Hermes chat surfaces.

Any agent (skills CLI)

One command that works across Claude Code, Codex, Cursor, and any other agent that reads SKILL.md files:

npx skills add sergebulaev/instagram-skills

> **Found this useful? [Star the repo](https://github.com/sergebulaev/instagram-skills).** Curated Claude Code and Codex directories rank and gate by star count, so a star is what makes these skills findable for the next person. It is the only thing we ask. No signup, no email.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 39 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "instagram-skills",
  3. "owner": {
  4. "name": "Serge Bulaev",
  5. "url": "https://github.com/sergebulaev"
  6. },
  7. "metadata": {
  8. "description": "Claude Code and Codex skills for Instagram growth: caption writing with a first-125-char hook, slide-by-slide carousel planning, viral Reel and carousel hook extraction, 2026 hashtag sizing, an AI-tell humanizer with bundled pre-publish audit, and weekly content planning. Posts publish through the Publora API media flow."
  9. },
  10. "plugins": [
  11. {
  12. "name": "instagram-skills",
  13. "source": "./",
  14. "description": "Bundle of 9 Instagram marketing skills for Claude Code and Codex with Instagram-native hook formulas, caption writing that front-loads the first 125 chars, a 10-slide carousel planner, viral hook extraction, 2026 hashtag sizing, a unified humanizer (rewrite plus pre-publish audit), cross-platform repurposing, a profile optimizer, an Apify-powered niche and profile audience insights reader, and a weekly Reels and carousel planner. Posts ship via Publora's draft, upload, schedule media flow.",
  15. "version": "1.0.33",
  16. "author": {
  17. "name": "Serge Bulaev",
  18. "url": "https://github.com/sergebulaev"
  19. },
  20. "homepage": "https://github.com/sergebulaev/instagram-skills",
  21. "license": "MIT",
  22. "keywords": [
  23. "instagram",
  24. "instagram-marketing",
  25. "marketing",
  26. "social-media",
  27. "content-creation",
  28. "claude-skills",
  29. "codex-skills",
  30. "anthropic",
  31. "reels",
  32. "carousel",
  33. "captions",
  34. "hashtags"
  35. ],
  36. "category": "productivity"
  37. }
  38. ]
  39. }
README.md · README · 388 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/hero.png" alt="Instagram marketing skills for Claude Code and Codex, open source MIT licensed" width="900" />
  3. </p>
  4. # Instagram Marketing Skills for Claude Code and Codex
  5. <p align="center">
  6. <img src="https://img.shields.io/github/v/release/sergebulaev/instagram-skills?color=111827&label=release" alt="Latest release">
  7. <img src="https://img.shields.io/badge/Claude_Code-Compatible-D97757?logo=anthropic&logoColor=white" alt="Claude Code Compatible">
  8. <img src="https://img.shields.io/badge/Codex-Compatible-111827" alt="Codex Compatible">
  9. <img src="https://img.shields.io/badge/Claude-Skills-8A63D2" alt="Claude Skills">
  10. <img src="https://img.shields.io/badge/License-MIT-22C55E.svg" alt="MIT License">
  11. <img src="https://img.shields.io/github/stars/sergebulaev/instagram-skills?style=social" alt="GitHub stars">
  12. <img src="https://img.shields.io/badge/PRs-welcome-F59E0B.svg" alt="PRs Welcome">
  13. </p>
  14. > **Part of the [linkedin-skills](https://github.com/sergebulaev/linkedin-skills) family (400+ stars).** Same voice engine and approve-before-publish flow, now for Instagram. Also available for [X](https://github.com/sergebulaev/x-skills) · [YouTube](https://github.com/sergebulaev/youtube-skills) · [TikTok](https://github.com/sergebulaev/tiktok-skills) · [Threads](https://github.com/sergebulaev/threads-skills) · [Facebook](https://github.com/sergebulaev/facebook-skills).
  15. **9 skills that turn Claude Code and Codex into your Instagram content team.** They write captions and Reels hooks in your voice, size hashtags, plan carousels and a full week of content, read your niche from real data, and optimize your profile. Every draft gets the AI tells stripped and waits for your approval before anything publishes. You supply the image or video; the skills write the words. No coding required.
  16. Once installed, just ask Claude Code or Codex things like:
  17. - "Write a caption for this Reel about [topic]"
  18. - "Plan a week of Instagram posts for my [niche]"
  19. - "What's working in my niche right now?" (reads real data via Apify)
  20. - "Rewrite this caption so it doesn't sound like AI"
  21. The right skill activates automatically. Then you review and approve.
  22. ## Install
  23. Pick whichever way you use Claude Code or Codex:
  24. ### Codex CLI
  25. ```bash
  26. codex plugin marketplace add sergebulaev/instagram-skills
  27. codex plugin add instagram-skills@instagram-skills
  28. ```
  29. To test a local clone before publishing changes:
  30. ```bash
  31. git clone https://github.com/sergebulaev/instagram-skills.git
  32. cd instagram-skills
  33. codex plugin marketplace add .
  34. codex plugin add instagram-skills@instagram-skills
  35. ```
  36. ### claude.ai (web)
  37. 1. Open https://claude.ai/code
  38. 2. Go to **Skills** in the sidebar
  39. 3. Click **Add from GitHub**
  40. 4. Paste: `sergebulaev/instagram-skills`
  41. 5. Done. The skills activate automatically when you ask about Instagram.
  42. ### Claude Desktop (Mac / Windows)
  43. 1. Open Claude Desktop
  44. 2. Open **Settings** (gear icon)
  45. 3. Go to **Skills**
  46. 4. Click **Add from GitHub**
  47. 5. Paste: `sergebulaev/instagram-skills`
  48. 6. Done. Start a new conversation and ask Claude to write a caption.
  49. ### Claude Code (CLI / VS Code / JetBrains)
  50. ```
  51. /plugin marketplace add sergebulaev/instagram-skills
  52. /plugin install instagram-skills@instagram-skills
  53. ```
  54. Or clone the repo and open it as your working directory:
  55. ```bash
  56. git clone https://github.com/sergebulaev/instagram-skills.git
  57. cd instagram-skills
  58. ```
  59. ### OpenClaw
  60. 1. Open your OpenClaw working directory
  61. 2. Clone the skills into it:
  62. ```bash
  63. git clone https://github.com/sergebulaev/instagram-skills.git
  64. ```
  65. 3. In OpenClaw settings, add this to your system prompt:
  66. ```
  67. You have Instagram marketing skills in ./instagram-skills/.
  68. For any Instagram task, read the relevant skills/*/SKILL.md first.
  69. Use lib/url_parser.py for URL parsing and lib/publora_client.py for publishing.
  70. ```
  71. 4. Done. Ask OpenClaw to write an Instagram post.
  72. ### Hermes Agent
  73. Hermes Agent (Nous Research) follows the agentskills.io open standard and loads `skills/*/SKILL.md` directly. Clone the bundle into your Hermes skills folder:
  74. ```bash
  75. git clone https://github.com/sergebulaev/instagram-skills.git ~/.hermes/skills/instagram-skills
  76. ```
  77. Coming from OpenClaw? `hermes claw migrate` imports these skills automatically. Then call `/<skill-name>` from any of your Hermes chat surfaces.
  78. ### Any agent (skills CLI)
  79. One command that works across Claude Code, Codex, Cursor, and any other agent that reads SKILL.md files:
  80. ```bash
  81. npx skills add sergebulaev/instagram-skills
  82. ```
  83. > **Found this useful? [Star the repo](https://github.com/sergebulaev/instagram-skills).** Curated Claude Code and Codex directories rank and gate by star count, so a star is what makes these skills findable for the next person. It is the only thing we ask. No signup, no email.
  84. ## What you can do
  85. Once installed, just ask Claude Code or Codex for help with Instagram. The right skill activates automatically.
  86. **Write a caption:**
  87. > "Write me an Instagram caption about how I cut my editing time from 6 hours to 47 minutes. Hook in the first line."
  88. **Plan a carousel:**
  89. > "Turn my notes into a 10-slide carousel on portfolio mistakes for junior designers."
  90. **Reverse-engineer a viral Reel:**
  91. > "What hook does this Reel use? https://www.instagram.com/reel/C9_aBcDeF/ (I'll paste the first 3 seconds)"
  92. **Size your hashtags:**
  93. > "Give me 5 hashtags for this post, sized so my 2k account can actually rank."
  94. **Check a draft before posting:**
  95. > "Audit this caption for AI tells and the first-125-char hook: [paste your text]"
  96. **Plan your week:**
  97. > "Plan a week of Instagram content. I'm launching a design course for junior designers."
  98. Every skill shows you a draft first and waits for your OK. Nothing gets posted without your approval.
  99. ## The 9 skills
  100. | Skill | What it does |
  101. |---|---|
  102. | **Caption Writer** | Drafts a caption with the hook in the first 125 chars, a skimmable body, and one CTA, using a 2026 hook formula picked by goal: saves, shares, comments, or follows |
  103. | **Carousel Planner** | Plans a carousel slide by slide (up to 10): a hook slide that opens a loop, value slides front-loaded, and a payoff slide that earns the save and the follow |
  104. | **Hook Extractor** | Reverse-engineers the hook from any viral Reel or carousel. Maps it to one of the 10 Instagram formulas and returns a blank template you can fill |
  105. | **Hashtag Strategist** | Builds a sized 3-5 hashtag set (niche / mid / broad) you can actually rank in, matched to the post. The 2026 reality, not the 30-tag wall |
  106. | **Humanizer** | Removes the AI tells human readers react to: 2026 AI vocabulary scored by paragraph density, reveal bridges, staccato fragment stacks, stacked triads, performed sincerity, emoji storms; caps em dashes at about one per 100 words instead of banning them (29% of human captions use one). Does not promise to beat detectors (no edit reliably does). Bundles a `--mode audit` pre-publish check |
  107. | **Content Planner** | Creates a weekly plan with a Reels / carousel / story mix, per-day hooks, posting times, a saves-and-shares goal, and a goal-mix balance check |
  108. | **Repurposer** | Turns a LinkedIn post, blog, YouTube script, or X thread into a native Instagram carousel or caption: re-hooked before the 125-char fold, off-platform artifacts stripped, never a copy-paste |
  109. | **Profile Optimizer** | Audits and rewrites the profile end-to-end: photo, searchable NAME field, bio (150 chars), goal-matched link, category label, highlights (covers, order, naming), the first-9 grid, and up to 3 pinned posts, with a scorecard and before/after rewrites |
  110. | **Audience Insights** | Reads your niche and profile from real data via Apify: scans a hashtag for the posts traveling now (likes, comments, owner, format) and pulls follower/post/bio stats for any handle, yours or a competitor's. Instagram hides likers and commenters, so this is niche discovery plus profile stats, not an engager list |
  111. ## Media is required on every Instagram post
  112. Instagram does not allow text-only posts. The skills write the caption, hook, hashtags, and slide or shot plan. **You supply the image or video.** When you connect Publora and point a skill at your media files, it runs the publish flow for you:
  113. ```
  114. 1. create a draft (no scheduled time) -> postGroupId
  115. 2. upload each file to S3 (2-10 images for a carousel, in order)
  116. 3. schedule the post (status=scheduled + time)
  117. ```
  118. That exact order matters: scheduling before the upload finishes races Instagram's scheduler against the media. The bundle's `lib/publora_client.publish_media_post(...)` does all three steps in one call.
  119. ## Optional: auto-post with Publora
  120. By default, the skills draft the caption for you to post in the Instagram app with your own media. If you want Claude Code or Codex to upload your media and schedule the post directly, connect Publora. It takes about 2 minutes.
  121. ### What is Publora?
  122. [Publora](https://publora.com/?utm_source=github&utm_medium=readme&utm_campaign=instagram-skills) is a publishing API that handles the Instagram media flow (draft, upload, schedule) in one call, and can cross-post the same content to other networks.
  123. Publora also ships [official MCP skills](https://github.com/publora/skills) (`npx skills add publora/skills`): one skill per platform, covering the publish side only. This bundle is the layer above them, adding the reading, the writing craft and the approval flow.
  124. ### Setup (2 minutes)
  125. **Step 1.** Sign up at https://app.publora.com/signup?utm_source=github&utm_medium=readme&utm_campaign=instagram-skills (free)
  126. **Step 2.** Connect Instagram: click **Channels** in the left sidebar, then **Add Channel**, pick **Instagram**, authorize. You need a **Business or Creator** account (personal accounts are not supported).
  127. **Step 3.** Find your Platform ID: go to **Channels**, click your Instagram account. The ID looks like `instagram-11223344`. Copy the whole thing including `instagram-`.
  128. **Step 4.** Get your API key: click **Settings** (gear icon, bottom-left), then **API**, then **Create Key**. Copy the `sk_...` string.
  129. **Step 5.** Create a file called `.env` in the instagram-skills folder:
  130. ```
  131. PUBLORA_API_KEY=sk_paste_your_key_here
  132. INSTAGRAM_PLATFORM_ID=instagram-paste_your_id_here
  133. ```
  134. If you cloned the repo, copy the template instead:
  135. ```bash
  136. cp .env.example .env
  137. ```
  138. Then open `.env` and replace the placeholders with your real values.
  139. **Step 6.** Install two small Python packages:
  140. ```bash
  141. pip install requests python-dotenv
  142. ```
  143. **Step 7.** Test it. Ask Claude Code or Codex:
  144. > "Schedule a test Instagram post via Publora 24 hours from now with this image: [path]. Caption: 'testing the API connection, will cancel in dashboard'."
  145. If Publora returns a `postGroupId`, you're set. Cancel the post in the Publora dashboard before the scheduled time. If you get HTTP 401, your API key is wrong. If you get an `Invalid platform ID format` error, your `INSTAGRAM_PLATFORM_ID` is wrong. See [Troubleshooting](#troubleshooting).
  146. > **Note on media:** Instagram rejects text-only posts. If you do not point a skill at an image or video, it returns the caption as a copy-paste block plus a reminder to attach your media in the app.
  147. ## Optional: generate illustrations with Pixfaro
  148. Instagram is visual-first. The Carousel Planner can generate carousel slides and quote-cards and attach them automatically when publishing. Without a key it drafts the image prompt and asks you to generate it yourself, so nothing breaks.
  149. [Pixfaro](https://pixfaro.com) is a single image API over multiple models (from `flux-schnell` at $0.004 to `gpt-5-image`). It composites your handle, brand color, or logo onto the image as a **pixel-exact overlay**, so a cheap base model still renders crisp text on a carousel slide. Pull those brand fields from your [Voice & Brand Profile](references/voice-profile.md) (section 6) and every asset stays on-brand.
  150. Setup: drop `PIXFARO_TOKEN=pf_live_...` into your `.env`. The thin client at `lib/pixfaro_client.py` and the wrappers `lib.illustrate(prompt, kind="carousel")` / `lib.refine(image_id, instruction)` return a hosted URL that flows straight into `lib.publish(..., media_urls=[url])`. `refine` edits a prior image by its id (cheaper than regenerating); results carry `cost`, `balance_after`, and a `premium` flag so the skills never quietly spend on a pricey model.
  151. ## Voice rules
  152. Every skill follows these rules automatically:
  153. 1. Em dashes capped at about one per 100 words. The character stopped being a tell in 2026; the density is.
  154. 2. Capitalize names. Always. Lowercase a brand reads as careless.
  155. 3. No AI vocabulary clusters. One 2026 marker ("leverage", "significant", "elevate", "dive in") in a paragraph is English; three in one paragraph reads as AI and gets the paragraph rewritten.
  156. 4. Specific numbers beat adjectives. "47 minutes" beats "fast".
  157. 5. The hook lives in the first 125 chars (everything after is behind the "more" fold).
  158. 6. Hashtags are sizing, not volume: 3-5 sized tags, not 30. 0-3 emoji.
  159. ## Troubleshooting
  160. | Problem | Fix |
  161. |---|---|
  162. | Skills don't activate when I ask about Instagram | Make sure you installed via the Skills panel, `/plugin install`, or `codex plugin add`. Try a new conversation. |
  163. | "PUBLORA_API_KEY not set" | Your `.env` file is missing or in the wrong folder. It should be in the `instagram-skills/` root. |
  164. | "401 Invalid API key" from Publora | Your API key is wrong or revoked. Go to Publora Settings > API > Create a new key. |
  165. | "Invalid platform ID format" | Your `INSTAGRAM_PLATFORM_ID` is wrong. Go to Publora Channels and copy the full `instagram-...` string. |
  166. | My post failed with "media required" | Instagram does not allow text-only posts. Point the skill at an image or video file. |
  167. | My carousel was rejected | A carousel is 2-10 items, all images or all video. You cannot mix images and a video in one carousel. |
  168. | Personal account won't connect | Instagram's API needs a Business or Creator account. Switch in the Instagram app settings, then reconnect. |
  169. | `pip install` fails | Use a virtual environment: `python -m venv venv && source venv/bin/activate && pip install requests python-dotenv` |
  170. ## Cross-cutting references
  171. - [`references/hook-formulas.md`](references/hook-formulas.md) - the 10 Instagram hook formulas with skeletons and goal tags
  172. - [`references/algorithm-heuristics.md`](references/algorithm-heuristics.md) - 2026 Instagram ranking signals, timing, and limits
  173. - [`references/hashtag-strategy.md`](references/hashtag-strategy.md) - the 2026 sized-hashtag model (3-5, not 30)
  174. - [`references/media-workflow.md`](references/media-workflow.md) - the draft, upload, schedule media flow
  175. - [`references/voice-rules.md`](references/voice-rules.md) - the canonical voice rules every skill inherits
  176. ---
  177. <details>
  178. <summary><b>For developers: runtime compatibility, URL parsing, and internals</b></summary>
  179. ## Runtime compatibility
  180. ```
  181. instagram-skills/
  182. skills/ SKILL.md frontmatter; native to Claude Code and Codex, others read as markdown
  183. .codex-marketplace/ generated nested Codex package (run scripts/sync_codex_marketplace.py)
  184. lib/ pure Python, works in any agent runtime
  185. references/ pure markdown, works anywhere
  186. scripts/ pure Python CLI, works anywhere
  187. ```
  188. | Runtime | Auto-discovers skills? | Setup |
  189. |---|---|---|
  190. | **Claude Code** (CLI, Desktop, Web, IDE) | Yes | Install via plugin or clone. Skills activate on matching prompts. |
  191. | **Codex CLI** | Yes | `codex plugin marketplace add sergebulaev/instagram-skills` and `codex plugin add instagram-skills@instagram-skills`. |
  192. | **Anthropic Managed Agents** (`/v1/agents`) | Yes | Pass skill files in the agent context. |
  193. | **Cursor / Cline / Aider** | Manual | Read `SKILL.md` files as prompt context; import `lib/` as Python. |
  194. | **LangChain / AutoGen** | No | Use `lib/` as a package; feed `references/` as prompt context. |
  195. ## Generic Python agent quickstart
  196. ```python
  197. import sys; sys.path.insert(0, "path/to/instagram-skills")
  198. from lib import parse_instagram_url, PubloraClient, publish
  199. parsed = parse_instagram_url("https://www.instagram.com/reel/C9_aBcDeF/")
  200. print(parsed["url_type"], parsed["shortcode"]) # reel C9_aBcDeF
  201. # Write side (Publora) - the full Instagram media flow in one call
  202. client = PubloraClient() # reads PUBLORA_API_KEY from env
  203. client.publish_media_post(
  204. content="the 3-step setup is below, steal it\n\n#niche #mid #broad",
  205. platforms=["instagram-11223344"],
  206. media=["slide1.jpg", "slide2.jpg", "slide3.jpg"], # local paths, in order
  207. scheduled_time="2026-07-01T15:00:00.000Z",
  208. )
  209. # Or use the high-level wrapper that handles manual / Publora / diy routing
  210. publish("carousel", draft_text="...", target_url="https://www.instagram.com/",
  211. media=["slide1.jpg", "slide2.jpg"], platforms=["instagram-11223344"])
  212. ```
  213. ## URL handling
  214. `lib/url_parser.py` parses Instagram post, Reel, and profile URLs:
  215. | URL fragment | Parsed |
  216. |---|---|
  217. | `instagram.com/p/SHORTCODE/` | `{shortcode, url_type: "post"}` |
  218. | `instagram.com/reel/SHORTCODE/` | `{shortcode, url_type: "reel"}` |
  219. | `instagram.com/USERNAME/` | `{username, url_type: "profile"}` |
  220. | `instagram.com/stories/USER/ID/` | `{username, shortcode, url_type: "story"}` |
  221. ```bash
  222. python lib/url_parser.py "https://www.instagram.com/p/C8xYz12abcd/"
  223. ```
  224. ## Why the publish flow is three steps
  225. Instagram requires media, and uploading media to a pre-signed S3 URL is
  226. asynchronous. If you create a post with a scheduled time set up front, the
  227. scheduler can fire before the upload finishes, producing a failed or media-less
  228. post. So the flow is always: create a draft, upload the media, then set the
  229. schedule. `publish_media_post` enforces that order and cleans up the draft if any
  230. step fails.
  231. ## What the read layer can and cannot do
  232. `ig-audience-insights` reads real Instagram data through two Apify actors, no
  233. login and no cookies: what is traveling under a hashtag
  234. (`apify/instagram-hashtag-scraper`) and a profile's public stats
  235. (`apify/instagram-profile-scraper`). Niche reads ask for **reels**, because the
  236. actor's own default returns the most recent feed posts and those come back with
  237. like counts of 0: measured across #marketing, #fitness and #coffee, 14 of 15
  238. rows had zero engagement, while reels on the same hashtags returned 758, 2004,
  239. 3462.
  240. **Two ways in.** With a shell, `APIFY_TOKEN=apify_api_...` in your `.env`. On
  241. claude.ai, where a skill has no environment to hold a token, add Apify's MCP
  242. server as a custom connector:
  243. ```
  244. https://mcp.apify.com?actors=apify/instagram-hashtag-scraper,apify/instagram-profile-scraper
  245. ```
  246. Sign in with OAuth on first use, no key on disk. **Keep the `?actors=` filter**:
  247. the bare `https://mcp.apify.com` also hands the agent `search-actors` and
  248. `call-actor`, which run anything in the Apify Store at whatever that actor
  249. charges. Details and the field mapping:
  250. [`references/mcp-read-layer.md`](references/mcp-read-layer.md).
  251. **What it cannot do**, on either path, because Instagram gates it: there is no
  252. post-by-URL read, so `ig-hook-extractor` still asks you to paste a specific
  253. caption; the list of who liked a post is not available; and commenter identities
  254. on someone else's post are capped and cookie-walled. A skill offering engager
  255. segmentation here would be inventing it.
  256. </details>
  257. ## References
  258. - [Publora API docs](https://docs.publora.com/?utm_source=github&utm_medium=readme&utm_campaign=instagram-skills) - endpoint reference for the publishing layer
  259. - [Instagram Graph API content publishing](https://developers.facebook.com/docs/instagram-api/guides/content-publishing) - the platform API the publish layer builds on
  260. ## Who builds this
  261. These skills come out of [Creative Content Crafts](https://cccrafts.ai), an engineering company. We build the machinery underneath a company's public voice: ICP parsing, engagement systems, content guardrails, and posting infrastructure. We do not sell the words themselves.
  262. We call that layer **content engineering**. Writing collapsed to the price of a chat subscription. What stayed valuable is everything below it: pulling every post your market wrote this week, keeping a live list of the people who matter, engaging on it daily with judgment in the loop, and catching the risky drafts before the platform does.
  263. This repo is the thin top layer of that stack, open-sourced. The engine underneath is what we build for clients.
  264. ## License
  265. MIT. Powered by [Publora](https://publora.com/?utm_source=github&utm_medium=readme&utm_campaign=instagram-skills).
  266. ## Related open-source skill bundles
  267. Part of a family of AI social-media marketing skill bundles for Claude Code and Codex:
  268. - [linkedin-skills](https://github.com/sergebulaev/linkedin-skills) - LinkedIn
  269. - [x-skills](https://github.com/sergebulaev/x-skills) - X (Twitter)
  270. - **instagram-skills - Instagram (this repo)**
  271. - [youtube-skills](https://github.com/sergebulaev/youtube-skills) - YouTube
  272. - [threads-skills](https://github.com/sergebulaev/threads-skills) - Threads
  273. - [tiktok-skills](https://github.com/sergebulaev/tiktok-skills) - TikTok
  274. - [facebook-skills](https://github.com/sergebulaev/facebook-skills) - Facebook Pages
  275. Also: [Anthropic Skills repo](https://github.com/anthropics/skills), the `awesome-claude-skills` directory.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.