AI Instagram Auto Poster

env: IG_ACCESS_TOKEN: "Required — Page Access Token with instagram_content_publish and pages_read_engagement permissions" IG_BUSINESS_ACCOUNT_ID: "Required — Instagram Business Account ID (numeric)" CLOUDINARY_CLOUD_NAME: "Required — Cloud name from your Cloudinary dashboard" CLOUDINARY_UPLOAD_PRESET: "Required — Unsigned upload preset from Cloudinary dashboard" CLOUDINARY_FOLDER: "Optional — Target folder name for uploads"

Instagram Posting Pipeline

End-to-end Instagram automation pipeline. Generate professional promotional images and publish them automatically to any Instagram Business account — no third-party automation tools needed.

Skill Scope

Not in scope: scraping private/internal networks, storing credentials externally, third-party data sharing.

Install Model

Instruction-driven skill — all scripts are bundled in the package. No external binaries, installers, or runtime dependencies beyond Python 3.8+ and Pillow. Place the scripts/ folder alongside the skill and configure env vars to use.

Pipeline Flow

Business info (name, details, website URL)
    → scrape_business.py (optional — auto-extract from website)
    → generate_course_promo.py
    → upload_cloudinary.py
    → post_to_instagram.py
    → Instagram post URL

Data Extraction (Optional)

scrape_business.py fetches a user-provided public URL to extract business info — name, tagline, services, contact — for auto-generating content.

What it does:

What it does NOT do:

> Do not provide internal/private URLs (e.g. localhost, 192.168.x.x, 10.x.x.x). SSRF protections enforced: DNS resolution + private-IP blocking (via ipaddress module), SSL certificate verification, scheme/hostname allowlist, and all redirects are explicitly blocked (no following 3xx responses to any destination).

Environment Setup

Before using, set these environment variables:

# Meta Graph API (required)
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 (required — create your own free account)
No default credentials are used — you must set up your own
export CLOUDINARY_CLOUD_NAME="your_cloud_name"
export CLOUDINARY_UPLOAD_PRESET="your_unsigned_preset"
export CLOUDINARY_FOLDER="mybusiness"
Image output (optional)
export IG_PIPELINE_OUTPUT_DIR="./output"

Security & Credentials

Your credentials stay yours.

Cloudinary hardening recommendation: Prefer signed upload presets, or restrict unsigned presets by folder/origin in your Cloudinary dashboard.

Getting Credentials

Access Token: 1. Go to https://developers.facebook.com/tools/explorer/ 2. Select your Facebook App (must have instagram_content_publish and pages_read_engagement permissions) 3. Generate token for your Page 4. Grant pages_read_engagement, instagram_content_publish

IG Business Account ID:

Step-by-Step Usage

Step 1: Generate Image

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"
)

CLI:

python scripts/generate_course_promo.py

Step 2: Upload to Cloudinary

python scripts/upload_cloudinary.py  [folder]

Returns a public URL like https://res.cloudinary.com/image/upload/xyz.png

Step 3: Post to Instagram

python scripts/post_to_instagram.py  

Or programmatically:

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"
)

Caption Structure

[HOOK - bold claim or question, 1-2 lines]
[VALUE - what they'll learn/achieve]
[CTA - link in bio / DM to enroll / visit website]
[8-15 hashtags - mix of broad + niche]

Troubleshooting

| Error | Fix | |-------|-----| | 401 Invalid OAuth | Token expired — regenerate at Graph API Explorer | | IG token format error | Use Page Access Token, not IG-only token | | image_url required | Image not publicly accessible — upload to Cloudinary first | | 403 Forbidden | App not in Live mode or instagram_content_publish permission not approved | | Cloudinary 400 | Image too large (>10MB), unsupported format, or credentials not configured | | IG account not found | Account not set as Business/Creator mode in Meta | | Scrape returns None | Website uses JS rendering — provide details manually |

Multiple Accounts

To switch between IG accounts, update environment variables before each post:

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

| Error | Fix | |-------|-----| | 401 Invalid OAuth | Token expired — regenerate at Graph API Explorer | | IG token format error | Use Page Access Token, not IG-only token | | image_url required | Image not publicly accessible — upload to Cloudinary first | | 403 Forbidden | App not in Live mode or instagram_content_publish permission not approved | | Cloudinary 400 | Image too large (>10MB), unsupported format, or credentials not configured | | IG account not found | Account not set as Business/Creator mode in Meta | | Scrape returns None | Website uses JS rendering — provide details manually |