Instagram Post Scheduler (Cron Job Description)

This document outlines the conceptual setup for a daily cron job that would automate the scheduling and posting of Instagram content (Carousels and Stories) for the Financial Calculator Hub.

Objective:

To ensure a consistent daily presence on Instagram, promoting new financial simulators and their associated SEO articles, driving traffic back to the website.

Cron Job Configuration (Conceptual):

Frequency: Daily, at a pre-defined optimal posting time (e.g., 10:00 AM UTC). Command: `@daily /usr/local/bin/python3 /path/to/instagram_automation_script.py --company financial-calculator-hub --content-dir ~/.sovereign/company/companies/financial-calculator-hub/projects/ --log-file /var/log/instagram_auto_post.log`

`instagram_automation_script.py` (Conceptual Script Logic):

• Initialize:

* Load Instagram API credentials securely.

* Connect to the company's content directory.

• Content Selection Logic:

* Maintain a database or manifest file of available Instagram content (carousels, stories) linked to simulators and articles, noting their `post_status` (e.g., `pending`, `posted`, `archived`).

* Prioritize `pending` content that has not yet been posted.

* Implement a rotation strategy to ensure all new content gets promoted and older evergreen content is re-shared periodically.

• Content Preparation:

* For the selected content, retrieve post text, image/video assets, and relevant hashtags.

* Ensure images/videos meet Instagram's specifications (aspect ratio, resolution, file size).

• Instagram API Interaction:

* For Carousels:

* Upload multiple images/videos for the carousel slides.

* Create the carousel post with the generated caption and hashtags.

* For Stories:

* Upload the image/video asset.

* Add interactive elements (polls, questions, link stickers) as defined in the content.

* Post the story.

• Status Update & Logging:

* Update the `post_status` of the posted content to `posted` in the content manifest.

* Log the outcome of the posting attempt (success/failure, post ID, errors) to the log file.

• Error Handling & Retry (Conceptual):

* Implement retry mechanisms for transient API errors.

* Alert administrator (G-Sama) via email or notification if critical failures occur (e.g., repeated authentication issues, out of content).

Content Manifest (`content_manifest.json` Conceptual):

[
{
"content_id": "sim-retirement-carousel-001",
"type": "carousel",
"simulator_id": "retirement_planner",
"article_id": "retirement_planning_with_inflation",
"images": ["path/to/img1.jpg", "path/to/img2.jpg"],
"caption": "Worried about retirement? 😩 Link in Bio to our FREE calculator! #FinancialPlanning #Retirement",
"hashtags": "#FinancialPlanning #RetirementGoals",
"post_status": "pending",
"last_posted_date": null
},
{
"content_id": "sim-mortgage-story-001",
"type": "story",
"simulator_id": "mortgage_calculator",
"article_id": "mortgage_repayment_strategies",
"image": "path/to/img_story1.jpg",
"interactive_elements": {"poll": {"question": "High interest rates scary?", "options": ["Yes", "No"]}},
"link_sticker_url": "[URL to Mortgage Simulator]",
"post_status": "pending",
"last_posted_date": null
}
]

Note:

This is a conceptual outline. Full implementation would require a dedicated Instagram automation library or API access, and robust error handling.