---

name: instagram description: 通过 Graph API 完整集成 Instagram。发布、分析、评论、私信、话题标签、定时发布、模板和 Business/Creator 账户管理。 risk: critical source: community date_added: '2026-03-06' author: renat tags:

• social-media
• instagram
• graph-api
• content tools:
• claude-code
• antigravity
• cursor
• gemini-cli
• codex-cli

---

技能：Instagram 集成

概述

通过 Graph API 完整集成 Instagram。发布、分析、评论、私信、话题标签、定时发布、模板和 Business/Creator 账户管理。

何时使用此技能

• 当用户提到 "instagram" 或相关话题时
• 当用户提到 "ig" 或相关话题时
• 当用户提到 "发布 instagram" 或相关话题时
• 当用户提到 "发帖 instagram" 或相关话题时
• 当用户提到 "reels instagram" 或相关话题时
• 当用户提到 "stories instagram" 或相关话题时

不要在以下情况使用此技能

• 任务与 instagram 无关
• 更简单、更具体的工具可以处理请求
• 用户需要通用帮助而不需要领域专业知识

工作原理

通过 Graph API 完全控制 Instagram 账户。发布、社区互动、分析、私信、话题标签、模板和仪表板——所有操作都通过治理机制管理（速率限制、审计日志、公开操作前的确认）。

快速摘要

| 领域 | 脚本 | 功能 | |------|------|------| | 设置 | account_setup.py, auth.py | 配置账户、OAuth、令牌 | | 发布 | publish.py, schedule.py | 发布照片/视频/Reel/Story/轮播图、定时发布 | | 社区 | comments.py, messages.py | 评论、私信、提及 | | 分析 | insights.py, analyze.py | 指标、最佳发布时间、热门帖子 | | 话题标签 | hashtags.py | 搜索和追踪 | | 智能 | templates.py, analyze.py | 内容模板、趋势 | | 基础设施 | export.py, serve_api.py, run_all.py | 导出、仪表板、同步 | | 读取 | profile.py, media.py | 个人资料、列出媒体 |

文件位置

C:\Users\renat\skills\instagram\
├── SKILL.md
├── scripts/
│   ├── requirements.txt
│   │  # ── 核心 ──
│   ├── config.py                     # 路径、常量、媒体规格
│   ├── db.py                         # SQLite：账户、帖子、评论、洞察
│   ├── auth.py                       # OAuth 2.0、令牌存储/刷新
│   ├── api_client.py                 # Instagram Graph API 封装 + 重试
│   ├── governance.py                 # 速率限制、审计日志、确认
│   │  # ── 功能 ──
│   ├── account_setup.py              # 账户检测、迁移、验证
│   ├── publish.py                    # 发布 + 通过 Imgur 上传本地文件
│   ├── schedule.py                   # 编排器：已批准 → 已发布
│   ├── comments.py                   # 读取/回复/删除评论
│   ├── messages.py                   # 私信（发送/接收/列表）
│   ├── insights.py                   # 获取 + 存储指标
│   ├── hashtags.py                   # 搜索 + 追踪
│   ├── profile.py                    # 查看/更新个人资料
│   ├── media.py                      # 列出媒体、详情
│   │  # ── 智能 ──
│   ├── templates.py                  # 文案/话题标签模板
│   ├── analyze.py                    # 最佳发布时间、热门帖子
│   │  # ── 基础设施 ──
│   ├── export.py                     # 导出 JSON/CSV/JSONL
│   ├── serve_api.py                  # FastAPI + 仪表板
│   └── run_all.py                    # 完整同步
├── references/
│   ├── graph_api.md                  # 端点和参数
│   ├── permissions.md                # 按功能划分的 OAuth 权限范围
│   ├── rate_limits.md                # 2025 年限制
│   ├── account_types.md              # Business vs Creator
│   ├── publishing_guide.md           # 媒体规格
│   ├── setup_walkthrough.md          # Meta App 指南
│   └── schema.md                     # ER 图
├── static/
│   └── dashboard.html                # Dashboard Chart.js
└── data/

安装（一次性）

pip install -r C:\Users\renat\skills\instagram\scripts\requirements.txt

初始配置

## 1. 检查 Instagram 账户类型

python C:\Users\renat\skills\instagram\scripts\account_setup.py --check

## 2. 配置 OAuth（打开浏览器进行授权）

python C:\Users\renat\skills\instagram\scripts\auth.py --setup

## 3. 验证一切是否正常工作

python C:\Users\renat\skills\instagram\scripts\profile.py --view

如果是个人账户，account_setup.py --guide 脚本会提供迁移到 Business 或 Creator 的说明。

照片（接受本地文件——通过 Imgur 自动上传）

python C:\Users\renat\skills\instagram\scripts\publish.py --type photo --image caminho/foto.jpg --caption "帖子文本"

视频

python C:\Users\renat\skills\instagram\scripts\pub