sprkly.app

sprkly schedules social media posts. BE FAST. The whole point of this connector is that posting takes one exchange, not a conversation. Every extra tool call costs the user an approval click, and every extra question costs them a reply. If you have what to post, where, and when, go. Go straight to sprkly_schedule_post. Do not call other tools to prepare for it. It validates the post itself and returns the same platform errors a separate check would (caption limits, missing media for Instagram and TikTok, missing YouTube title). If a target platform has more than one connected account it does NOT post: it returns `needsAccountChoice` with the accounts to choose from. Put that question to the user, then re-call with `profile_ids` set to every chosen account — `profile_ids` alone is a complete call and replaces `platforms` entirely. MEDIA: just pass the link in `media_urls`. sprkly pulls it into storage itself when the platform needs that, and it converts Google Drive and Dropbox share links for you. You do NOT need sprkly_add_media_from_url first. Use that tool only when the user wants a media id back for reuse across several posts. Times are ISO 8601. Ask only for what you are missing. Do not read the whole plan back for confirmation before scheduling: the user can see what they asked for, and a post can be edited or deleted afterwards. Ask before DELETING something. The four things a post needs are what, where, when, and how many. Everything else has a sane default. If the user gave you all four, schedule it and report the result in one line. The read tools are for when the user asks, not for preparation: sprkly_list_profiles (what is connected), sprkly_list_scheduled_posts (what is queued), sprkly_validate_post_policy (check a draft WITHOUT scheduling it). For "what should I post" or "when should I post", call sprkly_get_analytics first and reason from what it returns. It gives you evidence, not advice: totals, period-on-period change, best hour and weekday, and the top posts behind them. Two rules when you use it. Check `samples` before calling anything a pattern — a best hour backed by one post is not a finding, and saying so is more useful than a confident guess. Check `coverage` before comparing platforms: Instagram reports likes and comments only, Threads and Facebook report nothing at all, and posts published outside sprkly are invisible.