Instagram 发布流水线

端到端 Instagram 自动化流水线。自动生成专业宣传图片，并自动发布至任意 Instagram 商务账号——无需依赖第三方自动化工具。

能力范围

• 生成宣传图片（含文字 + 品牌元素叠加，尺寸 1080×1350）
• 将图片上传至 Cloudinary 实现公有托管
• 通过 Meta Graph API 发布至 Instagram
• 可选：从公开网站 URL 中提取企业信息

不在范围内：爬取私有/内网资源、外部存储凭证、向第三方共享数据。

模型安装

指令驱动型能力 —— 所有脚本均已打包在该组件中。除 Python 3.8+ 和 Pillow 外，不依赖任何外部二进制文件、安装程序或运行时依赖。请将 scripts/ 文件夹与该能力并置，并通过配置环境变量启用。

流水线流程

企业信息（名称、详情、网站 URL）
    → scrape_business.py（可选 —— 从网站自动提取）
    → generate_course_promo.py
    → upload_cloudinary.py
    → post_to_instagram.py
    → Instagram 发布链接

数据提取（可选）

scrape_business.py 向用户提供的公开 URL发起请求，提取企业信息（如名称、标语、服务内容、联系方式），用于自动生成宣传内容。

其功能包括：

• 向指定 URL 发起出站 HTTP(S) 请求
• 使用 Python 内置的 html.parser 解析 HTML 响应
• 提取页面标题、meta description、H1 标签、段落文本及联系方式模式（如邮箱、电话格式）
• 返回结构化数据，用于填充图片生成提示词（prompt）
• 若联系方式在网页中公开可见，则可能提取邮箱和电话号码

其不执行以下操作：

• 不跟随重定向至第三方域名（所有 3xx 响应均被拦截）
• 不访问内网或私有网络资源
• 不存储或重新传输所爬取的数据

请勿提供内网/私有 URL（例如 localhost、192.168.x.x、10.x.x.x）。已启用 SSRF 防护机制：DNS 解析校验 + 私有 IP 地址拦截（通过 ipaddress 模块）、SSL 证书验证、协议/主机名白名单，且所有重定向均显式禁用（不处理任何 3xx 响应的跳转目标）。

环境配置

使用前，请设置以下环境变量：

# Meta Graph API（必需）
export IG_ACCESS_TOKEN="your_page_access_token"
export IG_BUSINESS_ACCOUNT_ID="your_ig_business_account_id"
export IG_DEFAULT_CAPTION="Your default caption"

# Cloudinary（必需 —— 请自行注册免费账户）
# 不使用默认凭据 —— 您必须自行配置
export CLOUDINARY_CLOUD_NAME="your_cloud_name"
export CLOUDINARY_UPLOAD_PRESET="your_unsigned_preset"
export CLOUDINARY_FOLDER="mybusiness"

# 图片输出路径（可选）
export IG_PIPELINE_OUTPUT_DIR="./output"

安全与凭证管理

您的凭证完全由您掌控。

• 令牌（tokens）由用户在运行时提供（通过环境变量）
• 令牌永不对外存储，也不会发送至任何第三方服务
• 令牌仅在执行期间使用，不会持久化保存
• 所有出站请求均强制启用 SSL/TLS 校验
• 评估阶段请使用最小权限账号及测试账号
• 切勿记录令牌 —— 仅记录非敏感元数据

Cloudinary 安全加固建议： 推荐使用签名上传预设（signed upload presets），或在 Cloudinary 控制台中按文件夹/来源限制非签名预设（unsigned presets）的使用范围。

获取凭证方式

访问令牌（Access Token）：

1. 访问 https://developers.facebook.com/tools/explorer/
2. 选择您的 Facebook App（需具备 instagram_content_publish 和 pages_read_engagement 权限）
3. 为您的 Page 生成访问令牌
4. 授予 pages_read_engagement 与 instagram_content_publish 权限

Instagram 商务账号 ID（IG Business Account ID）：

• 可在 Meta Business Suite → Instagram 设置 → 账号 ID 中找到

分步使用说明

步骤 1：生成图片

from generate_course_promo import generate_course_promo

path = generate_course_promo(
    course_name="Diploma in Artificial Intelligence",
    institution="CADDESK Centre",
    duration="90 Weeks",
    bullets=[
        "Machine Learning & Data Science",
        "Building Intelligent Systems",
        "Algorithm Development",
        "Real-World AI Projects",
    ],
    hook_lines=["Your Future in AI", "Starts Here."],
    cta_text="Ready to shape the future with AI?",
    handle="@caddeskcentre",
    output_filename="course_promo.png"
)

命令行方式：

python scripts/generate_course_promo.py

步骤 2：上传至 Cloudinary

python scripts/upload_cloudinary.py  [folder]

返回类似 https://res.cloudinary.com/image/upload/xyz.png 的公开 URL

步骤 3：发布至 Instagram

python scripts/post_to_instagram.py  

或以编程方式调用：

from post_to_instagram import post_to_instagram

success, post_id, ig_url = post_to_instagram(
    image_url="https://res.cloudinary.com/image/upload/xyz.png",
    caption="Your caption with #hashtags"
)

文案结构规范

[钩子（HOOK）—— 加粗主张或提问，1–2 行]
[价值点（VALUE）—— 用户将学到/达成什么]
[行动号召（CTA）—— “链接见主页简介” / “私信报名” / “访问官网”]
[8–15 个话题标签（hashtags）—— 广泛类 + 垂直类混合]

故障排查

多账号支持

如需切换不同 Instagram 账号，请在每次发布前更新环境变量：

export IG_ACCESS_TOKEN="token_for_account_a"
export IG_BUSINESS_ACCOUNT_ID="ig_id_account_a"
python scripts/post_to_instagram.py