social-post_skill

Overview

This skill posts to multiple social media platforms through a unified social posting API with automatic provider fallback. It supports Twitter/X, LinkedIn, Instagram, Facebook, TikTok, Threads, Bluesky and more, handling media, scheduling, and provider selection. Use it to publish, schedule, or cross-post content from a single interface.

How this skill works

The skill uses a SocialPostingClient that talks to primary and fallback providers (PostForMe and LATE) via API keys in an environment file. It inspects connected accounts, filters requested platforms to those actually linked, and submits posts with optional media and scheduled timestamps. Results return success status, provider used, and post identifiers; failures include error messages and fallback attempts.

When to use it

• You want to cross-post the same message to multiple networks in one call.
• You need to include images or video and ensure platform-specific requirements are met.
• You want scheduled publishing to a mix of professional and consumer platforms.
• You need automatic fallback if the primary posting provider is unavailable.
• You want a quick check of which social accounts are currently connected.

Best practices

• Store API keys in a .env file and load them before instantiating the client.
• Always call get_accounts() first and filter requested platforms against connected accounts.
• Respect per-platform rules (e.g., Twitter 280-char limit; Instagram requires media).
• Provide absolute media URLs that are publicly accessible for uploads.
• Use scheduled_for in UTC for predictable timing across time zones.

Example use cases

• Publish a launch announcement to Twitter/X and LinkedIn with one API call.
• Post an Instagram carousel by supplying multiple image URLs and targeting only Instagram.
• Schedule a LinkedIn post for a future conference announcement using scheduled_for.
• Automatically fall back to the alternate provider if the primary provider returns an error.
• List connected accounts to show available platforms before prompting a user to post.