instagram-marketing

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Instagram Marketing Skills

Instagram营销技能包

A bundle of 9 focused skills for Instagram content ops in 2026. Each skill is single-purpose, follows the draft then approval then publish pattern, and uses the Publora API for the media-required publish flow.
一套面向2026年Instagram内容运营的9个专项技能集合。每个技能都专注单一用途,遵循“撰写草稿→审核→发布”的流程,并借助Publora API完成需附带媒体内容的发布流程。

When to use this bundle

何时使用此技能包

  • Writing a caption (hook in the first 125 chars, body, CTA) -> use
    ig-caption-writer
  • Planning a carousel slide by slide (hook slide to payoff slide) -> use
    ig-carousel-planner
  • Reverse-engineering the hook from a viral Reel or carousel -> use
    ig-hook-extractor
  • Sizing hashtags (the 3-5 niche/mid/broad reality, not 30) -> use
    ig-hashtag-strategist
  • Removing AI tells from a caption, or auditing it before posting -> use
    ig-humanizer
    (rewrite plus
    --mode audit
    , which folds in the post-audit sub-tool)
  • Planning a week of Reels, carousels, and stories -> use
    ig-content-planner
  • Adapting cross-platform content (a LinkedIn post, blog, YouTube script, or X thread) into a native Instagram carousel or caption -> use
    ig-repurposer
  • Auditing and rewriting the profile (photo, NAME field, bio, link, highlights, first-9 grid, pinned posts) -> use
    ig-profile-optimizer
  • Reading your niche and profile stats from real data (scan a hashtag for what is working, pull follower/post stats for you or a competitor) -> use
    ig-audience-insights
  • 撰写文案(前125字符包含钩子、正文、行动号召)→ 使用
    ig-caption-writer
  • 逐页规划轮播帖(从钩子页到转化页)→ 使用
    ig-carousel-planner
  • 从热门Reel或轮播帖逆向拆解钩子→ 使用
    ig-hook-extractor
  • 规划话题标签规模(遵循3-5个细分/中等/广泛标签的实际规则,而非30个)→ 使用
    ig-hashtag-strategist
  • 去除文案中的AI痕迹,或在发布前审核文案→ 使用
    ig-humanizer
    (重写功能搭配
    --mode audit
    参数,整合发布后审核子工具)
  • 规划一周的Reel、轮播帖和快拍内容→ 使用
    ig-content-planner
  • 将跨平台内容(LinkedIn帖子、博客、YouTube脚本或X线程)改编为原生Instagram轮播帖或文案→ 使用
    ig-repurposer
  • 审核并优化个人主页(头像、名称字段、简介、链接、精选快拍、前9格帖子、置顶帖子)→ 使用
    ig-profile-optimizer
  • 从真实数据中分析你的细分领域和主页数据(扫描话题标签查看有效内容,提取你或竞争对手的粉丝/帖子数据)→ 使用
    ig-audience-insights

Core pattern

核心流程

Every action-taking skill follows three steps:
  1. Parse the input. If the user gives an Instagram URL, the skill uses
    lib/url_parser.py
    to extract the username and shortcode.
  2. Draft the content. The skill applies 2026 research (Instagram hook formulas, hashtag sizing, timing, voice rules, ranking heuristics) and shows the draft to the user.
  3. Wait for approval, then publish with media. Instagram needs an image or video on every post. The user supplies the media; on approval the skill runs the Publora draft then upload then schedule flow.
每个可执行操作的技能都遵循三个步骤:
  1. 解析输入。如果用户提供Instagram URL,技能将使用
    lib/url_parser.py
    提取用户名和短代码。
  2. 撰写内容草稿。技能应用2026年的研究成果(Instagram钩子公式、话题标签规模、发布时机、语气规则、排名启发式算法)并向用户展示草稿。
  3. 等待审核,附带媒体内容发布。Instagram要求每篇帖子必须附带图片或视频。由用户提供媒体内容;审核通过后,技能将执行Publora的草稿→上传→排期流程。

Media is required (read this first)

必须附带媒体内容(请先阅读)

Instagram rejects text-only posts. The writer skills produce the caption, hook, hashtags, and slide or shot plan. The USER supplies the image or video file. The publish path is always:
1. create a draft (no scheduledTime)  -> postGroupId
2. upload each media file to S3        (2-10 files for a carousel, in order)
3. update the post: status=scheduled + scheduledTime
lib/publora_client.publish_media_post(...)
wraps all three steps. See
references/media-workflow.md
for the full flow and limits.
Instagram拒绝纯文字帖子。写作类技能负责生成文案、钩子、话题标签以及轮播页或镜头规划。用户需提供图片或视频文件。发布流程始终如下:
1. 创建草稿(无scheduledTime参数)  -> 获取postGroupId
2. 将每个媒体文件上传至S3        (轮播帖需2-10个文件,按顺序上传)
3. 更新帖子状态:status=scheduled + 设置scheduledTime
lib/publora_client.publish_media_post(...)
封装了上述三个步骤。完整流程和限制请查看
references/media-workflow.md

Prerequisites

前置条件

Three tiers - pick one.
三个层级 - 选择其一

Tier 0 - Draft only (default, no setup)

层级0 - 仅生成草稿(默认,无需配置)

The skills work out of the box. No API keys, no signup. Every approved caption is returned as a copy-paste block with a reminder to attach your media in the Instagram app. Great for trying the skills before committing to any backend.
技能可直接使用,无需API密钥或注册。所有审核通过的文案将以可复制粘贴的块形式返回,并提醒你在Instagram应用中附加媒体内容。非常适合在接入任何后端服务前试用技能。

Tier 1 - Publora auto-post (recommended, ~2 min)

层级1 - 使用Publora自动发布(推荐,约2分钟)

On approval, point the skill at your local media files and it uploads them and schedules the post via the Publora API.
  1. Sign up free: https://app.publora.com/signup
  2. Connect your Instagram Business or Creator account (Channels then Add Channel)
  3. Copy your API key from Publora's API panel
  4. Drop into
    .env
    :
    PUBLORA_API_KEY=sk_...
    INSTAGRAM_PLATFORM_ID=instagram-...
  5. Run
    pip install -r requirements.txt
Why Publora: posting media to Instagram means creating a draft, getting a pre-signed S3 URL, uploading each file, and only then scheduling, in that exact order. Publora does that chain in one call (
publish_media_post
), so we did not have to reimplement it.
审核通过后,指定技能访问本地媒体文件,即可通过Publora API上传并排期发布帖子。
  1. 免费注册:https://app.publora.com/signup
  2. 关联你的Instagram商业账号或创作者账号(进入Channels页面后添加频道)
  3. 从Publora的API面板复制你的API密钥
  4. 将密钥添加到
    .env
    文件中:
    PUBLORA_API_KEY=sk_...
    INSTAGRAM_PLATFORM_ID=instagram-...
  5. 运行
    pip install -r requirements.txt
选择Publora的原因:向Instagram发布媒体内容需要按顺序执行创建草稿、获取预签名S3 URL、上传每个文件,最后才能排期。Publora通过一次调用(
publish_media_post
)完成整个流程,因此我们无需重新实现该逻辑。

Tier 2 - Build your own poster (advanced)

层级2 - 自定义发布工具(进阶)

Prefer not to SaaS it? Ask Claude Code or Codex to build a custom poster on the Instagram Graph API. Set
INSTAGRAM_SKILLS_CUSTOM_POSTER=<your command>
and the skills invoke it on approval. Publora is the 2-minute path.
不想使用SaaS服务?可让Claude Code或Codex基于Instagram Graph API构建自定义发布工具。设置
INSTAGRAM_SKILLS_CUSTOM_POSTER=<你的命令>
,审核通过后技能将调用该命令。Publora是耗时仅2分钟的便捷方案。

Account note

账号说明

Instagram's publishing API needs a Business or Creator account. Personal accounts are not supported.
Instagram的发布API需要商业账号或创作者账号。个人账号不被支持。

Voice rules (baked into every skill)

语气规则(内置到所有技能中)

  1. No em dashes (
    ), en dashes, or double dashes. Biggest AI tell.
  2. Use
    ..
    or a line break as a soft pause when rhythm calls for it.
  3. Capitalize all personal, company, and product names.
  4. Sentence starts can be lowercase (native caption voice); names stay capitalized.
  5. Avoid AI vocabulary:
    leverage
    ,
    fundamentally
    ,
    streamline
    ,
    harness
    ,
    delve
    ,
    unlock
    ,
    elevate
    ,
    foster
    .
  6. Specific numbers beat adjectives. "47 minutes" beats "fast".
  7. One idea per caption. The first 125 chars carry the hook (the "more" fold).
  8. Hashtags are sizing, not volume: 3-5 sized tags, not 30.
(Canonical reference:
references/voice-rules.md
. See also
references/hook-formulas.md
,
references/algorithm-heuristics.md
,
references/hashtag-strategy.md
, and
references/media-workflow.md
.)
  1. 不使用长破折号(
    )、短破折号或双破折号。这是最明显的AI痕迹。
  2. 当需要节奏停顿使用
    ..
    或换行符作为软停顿。
  3. 所有人名、公司名和产品名首字母大写。
  4. 句子开头可以小写(原生文案语气);名称需保持大写。
  5. 避免使用AI常用词汇:
    leverage
    fundamentally
    streamline
    harness
    delve
    unlock
    elevate
    foster
  6. 具体数字优于形容词。“47分钟”比“快速”更好。
  7. 每篇文案只聚焦一个核心观点。前125字符需包含钩子(“查看更多”折叠内容前的部分)。
  8. 话题标签重规模而非数量:3-5个分规模标签,而非30个。
(标准参考文档:
references/voice-rules.md
。另可查看
references/hook-formulas.md
references/algorithm-heuristics.md
references/hashtag-strategy.md
references/media-workflow.md
。)

How Instagram URLs map

Instagram URL映射规则

URL shapeParsed to
https://www.instagram.com/p/SHORTCODE/
shortcode, type
post
https://www.instagram.com/reel/SHORTCODE/
shortcode, type
reel
https://www.instagram.com/USERNAME/
username, type
profile
https://www.instagram.com/stories/USER/ID/
username + id, type
story
lib.url_parser.parse_instagram_url(url)
returns
{username, shortcode, url_type, canonical_url}
. A carousel shares the
/p/
path with a single image; the carousel is detected from the media, not the URL.
URL格式解析结果
https://www.instagram.com/p/SHORTCODE/
短代码,类型为
post
https://www.instagram.com/reel/SHORTCODE/
短代码,类型为
reel
https://www.instagram.com/USERNAME/
用户名,类型为
profile
https://www.instagram.com/stories/USER/ID/
用户名+ID,类型为
story
lib.url_parser.parse_instagram_url(url)
返回
{username, shortcode, url_type, canonical_url}
。轮播帖与单图帖共享
/p/
路径;轮播类型由媒体内容而非URL检测。

Known gotchas

已知注意事项

  • Media is mandatory. No image or video means no post. The skill returns the caption and reminds you to attach media.
  • No mixed media in a carousel. All images or all video, never both.
  • First 125 chars only. Everything after that is behind the "more" fold.
  • Carousel is 2-10 items via the API (the native app allows 20).
  • WebP auto-converts to JPEG at publish time.
  • Business or Creator account required. Personal accounts cannot use the API.
  • 媒体内容是必填项。没有图片或视频则无法发布帖子。技能会返回文案并提醒你附加媒体内容。
  • 轮播帖中不能混合媒体类型。只能全是图片或全是视频,不能两者混合。
  • 仅前125字符可见。超过的内容将被折叠在“查看更多”之后。
  • API支持的轮播帖为2-10个内容项(原生应用允许20个)。
  • WebP格式会在发布时自动转换为JPEG
  • 需要商业账号或创作者账号。个人账号无法使用API。

Resources

资源

  • Publora API docs - endpoint reference for the publishing layer
  • lib/publora_client.py
    - Python client with the full media flow
  • lib/url_parser.py
    - Instagram URL to username/shortcode parser
  • Publora API文档 - 发布层的端点参考
  • lib/publora_client.py
    - 包含完整媒体流程的Python客户端
  • lib/url_parser.py
    - 将Instagram URL解析为用户名/短代码的工具

Acknowledgments

致谢

Publishing powered by the Publora REST API.
发布功能由Publora REST API提供支持。