dsh-postiz

dsh-postiz

npm: dsh-postiz · source: gitroomhq/postiz-agent

DeepSeek Harness (dsh) plugin for Postiz, the open-source social media scheduler. It connects the agent to the Postiz MCP server so it can list your connected channels, fetch each platform's posting rules, and schedule, draft, or publish posts across 28+ platforms (X, LinkedIn, Instagram, Facebook, Threads, TikTok, YouTube, Reddit, Pinterest, Bluesky, Mastodon, Discord, Slack, Telegram, and more).

Install

From the repository:

dsh plugin --profile web add "github:gitroomhq/postiz-agent#path:/plugins/dsh-postiz"

Or from npm:

dsh plugin --profile web add dsh-postiz

Then give it a Postiz API key. Copy it from Postiz → Settings → Developers → Public API and export it before starting dsh, or put it in $DSH_HOME/.env:

export POSTIZ_API_KEY=your-api-key
dsh web

Restart the profile after installing. Ask the agent *"List my connected social media accounts"* to verify the connection.

What you get

The bundle mounts two rows:

Row · Package · Role postiz · dsh-postiz (this package) · Reads the API key, exposes ctx.postiz (url, headers), and registers the postiz skill that teaches the agent the posting workflow and the HTML content rules. postiz-mcp · @deepseek-ai/dsh-mcp-client (shipped with dsh) · Connects to https://mcp.postiz.com/mcp over streamable HTTP with a Bearer header and registers the server's tools.

The model sees the Postiz MCP tools under the mcp__postiz__ namespace:

Tool · What it does mcp__postiz__integrationList · List connected channels (optionally filtered by group) mcp__postiz__groupList · List customer groups mcp__postiz__integrationSchema · Posting rules, character limits, and required settings for a platform mcp__postiz__triggerTool · Platform helpers (list Discord channels, search subreddits, list LinkedIn pages) mcp__postiz__schedulePostTool · Schedule, draft, or immediately publish posts mcp__postiz__postsListTool · List posts scheduled between two dates mcp__postiz__postSettingsTool · Update settings of an unpublished post mcp__postiz__generateImageTool · Generate an image for a post mcp__postiz__generateVideoOptions / videoFunctionTool / generateVideoTool · Video generation options and generation

The tool list comes from the server at connect time, so new Postiz tools appear without a plugin update. See the Postiz MCP tools reference.

Configuration

Override the postiz row in your profile's cordis.patch.yml ($DSH_HOME/profiles/web/cordis.patch.yml). A bare id: configures the existing row:

- id: postiz
  config:
    apiKeyEnv: POSTIZ_API_KEY          # env var that holds the key (default)
    baseUrl: https://mcp.postiz.com    # self-hosted: https://your-postiz-server.com
    skill: true                        # register the `postiz` workflow skill

Field · Default · Description apiKeyEnv · POSTIZ_API_KEY · Environment variable read at boot for the API key. apiKey · '' · Inline key. Prefer the env var; this exists for patch-level overrides. baseUrl · https://mcp.postiz.com · Postiz host. The MCP endpoint is /mcp. Self-hosted instances point this at their backend. skill · true · Register the postiz skill on ctx.skills.

Without a key the postiz row logs a warning naming the variable to set, and the postiz-mcp row registers no tools. dsh keeps booting.

Self-hosted Postiz

The MCP server is part of the Postiz backend and listens at /mcp (Bearer auth). Point baseUrl at your backend and make sure your reverse proxy forwards /mcp with streaming HTTP enabled. See Reverse Proxies.

Development

cd plugins/dsh-postiz
pnpm install
pnpm test

Link a local checkout into a profile:

dsh plugin --profile web add /absolute/path/to/postiz-agent/plugins/dsh-postiz

Related

• Postiz CLI — the postiz command-line tool and the Claude Code / Cursor / Grok plugins in this repository.
• Postiz MCP docs
• Postiz public API

License

AGPL-3.0, same as the rest of this repository.