List available local images in the content directory.

Safely locate a local content file and return basic metadata.

Manage Instagram content stored in the content folder.

Actions:

• list: Show all available content with metadata

• delete: Permanently delete selected content

• archive: Move selected content to archive folder

Manage metadata for Instagram content (captions, hashtags, scheduling).

Actions:

• update: Update caption and/or hashtags

• view: View current metadata

• clear: Clear caption and hashtags

Test the Instagram Graph API connection and report the exact status.

Use this first whenever posting fails, to determine whether the problem is:

• Expired/revoked token (code 190 or 200, type OAuthException)

• Missing permissions (code 10)

• Rate limiting (code 4 or 32)

• API version deprecated (code 100)

Inspect the configured Instagram access token via Meta's debug_token endpoint.

Reports the token's type, expiry date, and granted scopes. Use this to determine whether the token is expired, about to expire, or lacks the required permissions (instagram_basic, instagram_content_publish).

Post content to Instagram using Instagram Graph API.

Prerequisites:

• Set INSTAGRAM_ACCESS_TOKEN environment variable

• Set INSTAGRAM_BUSINESS_ACCOUNT_ID environment variable

• Instagram access token must have appropriate permissions

Upload a local image to Cloudinary without posting to Instagram.

Delete a temporary Cloudinary asset manually.

Publish a local image to Instagram using a Cloudinary-hosted HTTPS image URL.

Convert a PDF file to individual PNG images.

Each page becomes a separate image. Images are stored in the content folder with the PDF name as prefix.

Example: document.pdf -> document_page_001.png, document_page_002.png, etc.

Create carousel batches from selected images or PDF pages.

Parameters:

• content_ids: Comma-separated list of content IDs (e.g., "image1,image2,image3,image4,image5,image6,image7,image8,image9,image10")

• batch_name: Optional name for this batch (e.g., "Q1_Report" or "pdf_name")

• images_per_post: How many images per carousel post (default: 5, max: 10 for Instagram)

Example: 10 images with images_per_post=5 creates 2 carousel batches

Post a carousel batch to Instagram.

Uploads all images in the batch to Cloudinary, creates a CAROUSEL media container via the Instagram Graph API, publishes it, then deletes the local images and Cloudinary temporary assets.

Requires 2-10 images per carousel (Instagram limit).

List all carousel batches and their status.

Shows each batch ID, posted status, image count, and batch progression.