Instagram Upload logo

Instagram Upload

CommunityPopular
dreammis
instagram-upload

使用 sau CLI 在 Instagram 独立网页登录、立即发布 Reels/单图/轮播、核验原作品并移至最近删除。

Overview

Publisherdreammis
Repositorysocial-auto-upload
Skill nameinstagram-upload
Stars
15.7K
Forks
2.7K
Bundled files
3
LicenseMIT-0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 3 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by dreammis on GitHub. Read the source before you install it.

Installation

Install the Instagram Upload AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/dreammis/social-auto-upload/tree/main/skills/instagram-upload
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/dreammis/social-auto-upload.git /tmp/social-auto-upload
mkdir -p .claude/skills
cp -r /tmp/social-auto-upload/skills/instagram-upload .claude/skills/instagram-upload
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Instagram Upload in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Instagram Upload on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Instagram Upload is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Instagram 独立网页发布

调用现有 CLI,不自行实现浏览器上传。使用工程 Patchright Chrome 和独立 Instagram 会话,不使用 Business Suite 的绑定入口。默认可见浏览器,未配置代理时按系统网络直连;需要代理时显式使用 --proxy 或设置 SAU_INSTAGRAM_PROXY。传 --proxy "" 可忽略环境变量并直连。

powershell
sau instagram login --account creator
sau instagram check --account creator
sau instagram upload-video --account creator --file videos/demo.mp4 --thumbnail covers/demo.png --title "标题" --desc "正文" --tags 生活,分享 --result .local/instagram-video.json
sau instagram upload-note --account creator --images images/1.jpg images/2.jpg --title "轮播标题" --note "正文" --result .local/instagram-images.json

视频/Reel 可用 --thumbnail 指定 JPG/JPEG/PNG 封面;省略时使用 Instagram 默认封面。指定图片后会检查主预览确实使用该图片,失败则停止提交。封面按当前视频画幅居中裁剪,图片边缘的重要文字应留出安全区域。图文发布不接受此参数。

账号文件保存为 cookies/instagram_creator.json。密码和验证由用户在工程浏览器输入。上传流程会自动跳过首次通知提示、确认 Reels 介绍,没有提示则继续。登录验证仍由用户完成;未知弹窗或提示关闭失败须报告,不能宣称上传成功。

视频支持 MP4/MOV,照片支持 JPG/JPEG/PNG/AVIF/HEIC/HEIF,实际处理取决于平台。多图按输入顺序发布轮播,单图和两图轮播已实测。标题、正文、标签合计最多 2200 字符。当前账号独立网页版的照片/Reels 表单及高级设置没有定时入口,当前 CLI 仅支持立即发布;不能把定时任务转换成立即发布。地点、协作者、AI 标签、替代文字、滤镜、裁剪、声音和评论/点赞设置未接入,沿用页面默认值。

最终结果 published 代表平台确认作品创建,返回作品编号、原作品链接和媒体数。processing 表示已受理且仍在处理,submission_unknown 表示提交后结果未确认;不能当成已发布,也不能直接重发。默认结果位于 .local/instagram-results/,使用 --result 固定记录路径。

powershell
sau instagram verify --account creator --post-url "原作品链接" --expected-text "原作品中的准确文字" --result .local/instagram-verify.json
sau instagram delete --account creator --post-url "原作品链接" --expected-text "原作品中的准确文字" --result .local/instagram-delete.json

结果未知但没有链接时,先在同一账号主页按素材、配文和发布时间找原作品,复制链接再运行 verify;未找到不证明失败,不重复上传。链接支持 /p/编号/、/reel/编号/ 和带作者名的形式。核对登录用户、作者、作品编号和正文后才允许删除。删除返回 deleted,作品进入“最近删除”;批量删除和提前永久清空不在范围内。本地素材不会删除。deletion_unknown 须先查询原作品和“最近删除”,不重复提交删除。

完整参数和能力边界以 sau instagram upload-video --help、upload-note --help、verify --help 和 delete --help 为准。失败时根据结果文件中的错误及本地证据分析;不得把账号状态、截图或页面记录提交到 Git。

示例脚本

scripts/examples/ 下的文件是复制用示例,不是运行时依赖。执行前先查看当前 CLI 的 --help,替换账号、素材和正文;这些命令可能创建真实作品。

  • instagram_commands.ps1:PowerShell
  • instagram_commands.sh:Bash
  • instagram_cli_template.py:Python subprocess

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Instagram Upload AI skill do?

使用 sau CLI 在 Instagram 独立网页登录、立即发布 Reels/单图/轮播、核验原作品并移至最近删除。

Why use Instagram Upload on TypingMind?

Because you install it once and use it with any model. Instagram Upload is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Instagram Upload in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/dreammis/social-auto-upload/tree/main/skills/instagram-upload. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Instagram Upload?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Instagram Upload?

As many as you like. As long as a model supports skills, you can use Instagram Upload with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Instagram Upload AI skill free?

Yes. It is published on GitHub by dreammis under the MIT-0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇