Docs / Packages

Blotato Publisher

Schedule social posts with your Agent and Blotato; results kept per platform.

Last updated 2026-11-04

Blotato Publisher is a Workflow Package (a Package that hands a fixed process to the Agent). You give your own Agent an article, a video link or some copy, and the Agent follows this Package's Skill to call Blotato (a service for scheduling social media posts): it submits the source, waits for the content to be extracted, writes a draft for you to confirm, submits a schedule for each platform separately, then checks each platform's result and records it.

The Page shows the Package data in three columns: sources and extraction jobs, drafts, and one record per platform (account, scheduled time, submission ID, current status, public link).

Note: This Package is still a draft. It has only been checked with invented data and is not listed on Explore yet. The Blotato API behavior below comes from public documentation and has not been verified with a real account; see Tools and sources.

Who it is for#

  • You: a small business owner who already uses Blotato and wants your own Agent to post for you. You bring your own Blotato account and API key, and every step is recorded on your own computer. Read How to use and Setup.
  • Your Agent: Claude Code, Codex or the Agent in Lorevik. The Agent should read the Package's SKILL.md first, then Tools and sources, and call Blotato with the addresses and rules written there.

The three rules it keeps#

  • Accepted is not published. When Blotato accepts a submission, the record says "accepted" until Blotato confirms it is published and gives a public link.
  • Each platform succeeds or fails on its own. One draft sent to three platforms is three submissions, each with its own result. One platform failing says nothing about another.
  • When it cannot connect, it only says "could not confirm right now", never failed. When Blotato cannot be reached, the last confirmed status is kept and marked as unconfirmed.

Quick start#

  1. Put the blotato-publisher folder in your Vault's living-surfaces/ and open it in Lorevik.
  2. Set the environment variable BLOTATO_API_KEY; see Setup. Without a key, the Package is read-only.
  3. In the Thread on the right, give the Agent a link or some copy. The Agent writes a draft and lists the accounts and scheduled times, and submits only when you say "go ahead and post".

Reading order#

  1. Start (this page): what it is, who it is for, how to begin. File docs/start.en.md
  2. How to use: every step from source to published post, and how to read the statuses on the Page. File docs/how-to.en.md
  3. Tools and sources: the source and version of the Blotato API, your Agent and the Package itself. File docs/tools.en.md
  4. Setup: put it in your Vault, give the Agent a key, clear the example data. File docs/setup.en.md
  5. Changelog: what changed in each version. File docs/changelog.en.md

See also#