Setup
Put it in your Vault, give the Agent a Blotato key, and clear the example data.
The Agent reads the data, clears the example and calls the API. You sign up for Blotato, get the API key and connect your social media accounts yourself, in Blotato. The Agent does not enter passwords, card numbers or verification codes. At the steps only you can do, the Agent must stop and send a yellow dot message in the Thread.
Please follow the "Setup" page of the Blotato Publisher guide.1. Read the Package's SKILL.md and "Tools and sources" first.2. Check whether the environment variable BLOTATO_API_KEY is set. If not, stop and tell me how to set it. Do not ask me to paste the key into the Thread.3. Ask me before you clear the example records.4. Each time you finish or get stuck on a step, reply with one line in the Thread: the dot color, the step name, what happened, and what I need to do.Before you start#
| Item | Required or recommended | Price | Notes |
|---|---|---|---|
| Lorevik desktop App | Required | Free | The Package opens in it |
| Blotato account and API key | Required | To confirm | Your own account; the Package holds no credentials and pays nothing for you |
| Social media accounts connected in Blotato | Required | To confirm | For each platform you post to, connect that account in Blotato; whether this costs extra has not been verified |
| Your Agent | Required | Depends on your own subscription | Claude Code, Codex or the Agent in Lorevik |
See Blotato's pricing page for current plans and API access.
Install steps#
Put the folder in your Vault#
Copy the whole
blotato-publisherfolder into your Vault'sliving-surfaces/. When you see it in the Lorevik Sidebar on the left and opening it shows the Page with three columns of example data, this step is done.Generate an API key in Blotato#
Your part: sign in to Blotato, generate an API key in its settings, and confirm the social media accounts you want to use are connected.
The Agent takes no part in this step and does not keep the key for you.
Set the environment variable#
Your part: set this variable in the environment where the Agent starts.
envBLOTATO_API_KEY={{BLOTATO_API_KEY}}When the Agent can read it and the
GET /v2/users/mecall succeeds, this step is done. Without this variable the Package is read-only: you can see existing records, but cannot submit or check anything.To confirm:
SKILL.mdalso describes another path: Lorevik's authorization flow hands the key to the Agent. That path is not built in the App yet; for now the environment variable is the only way.Let the Agent clear the example data#
The Package comes with invented example records (Demo Bakery, with every link on
example.com). Before recording real content for the first time, have the Agent clear the example records and delete thefixturefield. The Agent asks you before it does this.
How to update later#
The Package is not listed on Explore yet, so there are no automatic updates. When you get a new version, replace the whole folder. data.json holds your own records, so back it up before replacing.