Docs / Packages

Setup

Put it in your Vault, give the Agent a Blotato key, and clear the example data.

Last updated 2026-11-04

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.

Copy to your Agent
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#

ItemRequired or recommendedPriceNotes
Lorevik desktop AppRequiredFreeThe Package opens in it
Blotato account and API keyRequiredTo confirmYour own account; the Package holds no credentials and pays nothing for you
Social media accounts connected in BlotatoRequiredTo confirmFor each platform you post to, connect that account in Blotato; whether this costs extra has not been verified
Your AgentRequiredDepends on your own subscriptionClaude Code, Codex or the Agent in Lorevik

See Blotato's pricing page for current plans and API access.

Install steps#

  1. Put the folder in your Vault#

    Copy the whole blotato-publisher folder into your Vault's living-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.

  2. 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.

  3. Set the environment variable#

    Your part: set this variable in the environment where the Agent starts.

    env
    BLOTATO_API_KEY={{BLOTATO_API_KEY}}

    When the Agent can read it and the GET /v2/users/me call 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.md also 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.

  4. 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 the fixture field. 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.

See also#