mirror of
https://github.com/gitroomhq/postiz-agent.git
synced 2026-09-14 13:46:24 +08:00
Nevo David
b4960beefa
Add plugins/dsh-postiz, an installable DeepSeek Harness bundle (`dsh plugin --profile web add "github:gitroomhq/postiz-agent#path:/plugins/dsh-postiz"`). - cordis.patch.yml mounts a `postiz` provider row plus one @deepseek-ai/dsh-mcp-client row pointed at https://mcp.postiz.com/mcp (streamable HTTP, Bearer auth from POSTIZ_API_KEY; baseUrl overridable for self-hosted instances) - the provider exposes ctx.postiz (url/headers) for the mcp row's !!js config and registers a `postiz` skill covering the integrationList → integrationSchema → schedulePostTool workflow and HTML content rules - node:test unit tests; verified against dsh 0.1.5-rc: the mcp row activates, sends the Bearer header, and retries on auth failure - README / CHANGELOG entries; ignore plugin-local lockfiles Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
89 lines
3.7 KiB
JavaScript
89 lines
3.7 KiB
JavaScript
/**
|
|
* The `postiz` skill body registered on `ctx.skills`.
|
|
*
|
|
* It teaches the agent the order of operations for the Postiz MCP tools that
|
|
* the sibling `postiz-mcp` row exposes as `mcp__postiz__*`. Kept as a plain
|
|
* string so the plugin ships no extra files and needs no filesystem access.
|
|
*/
|
|
|
|
export const SKILL_NAME = 'postiz'
|
|
|
|
export const SKILL_DESCRIPTION =
|
|
'Schedule, draft, or publish social media posts through Postiz (X, LinkedIn, Instagram, Facebook, Threads, TikTok, YouTube, Reddit, Bluesky, Mastodon, Discord, Slack, Telegram and more). Use when the user wants to post to social media, list connected channels, or plan a content calendar.'
|
|
|
|
export const SKILL_CONTENT = `# Postiz
|
|
|
|
Postiz is a social media scheduler. The \`mcp__postiz__*\` tools talk to the
|
|
user's Postiz account. Always follow this order:
|
|
|
|
## 1. Find the channel
|
|
|
|
Call \`mcp__postiz__integrationList\` to get connected accounts. Each entry has
|
|
an \`id\` (the integration ID), a \`name\`, and a \`platform\` such as \`x\`,
|
|
\`linkedin\`, \`instagram\`, \`facebook\`, \`threads\`, \`tiktok\`, \`youtube\`,
|
|
\`reddit\`, \`bluesky\`, \`mastodon\`, \`discord\`, \`slack\`, \`telegram\`.
|
|
If the account has customer groups, \`mcp__postiz__groupList\` lists them and
|
|
\`integrationList\` accepts a \`group\` filter.
|
|
|
|
Never guess an integration ID. If the user names a platform that is not in the
|
|
list, say so and stop.
|
|
|
|
## 2. Learn the platform rules
|
|
|
|
Call \`mcp__postiz__integrationSchema\` with \`{ platform, isPremium }\` before
|
|
composing. It returns \`maxLength\`, \`rules\`, a \`settings\` JSON schema of
|
|
required per-platform settings, and helper \`tools\` (for example: list Discord
|
|
channels, search subreddits, list LinkedIn pages). Run helpers with
|
|
\`mcp__postiz__triggerTool\` when a setting needs an ID you do not have.
|
|
|
|
## 3. Compose the content
|
|
|
|
- Content is HTML. Wrap every line in \`<p>\`. Allowed tags: \`<p>\`, \`<h1>\`,
|
|
\`<h2>\`, \`<h3>\`, \`<strong>\`, \`<u>\`, \`<ul>\`, \`<li>\`. Do not combine
|
|
\`<u>\` and \`<strong>\` in one element.
|
|
- Respect \`maxLength\` from the schema.
|
|
- \`postsAndComments\` is an array. On thread platforms (X, Threads, Bluesky)
|
|
each item is a new post in the thread; on comment platforms (LinkedIn,
|
|
Facebook) the first item is the post and the rest are comments.
|
|
- \`attachments\` are media URLs. To generate media first, use
|
|
\`mcp__postiz__generateImageTool\` or \`mcp__postiz__generateVideoTool\`
|
|
(check \`generateVideoOptions\` and \`videoFunctionTool\` for settings).
|
|
|
|
## 4. Schedule or publish
|
|
|
|
Call \`mcp__postiz__schedulePostTool\` with a \`socialPost\` array. Each item:
|
|
|
|
\`\`\`json
|
|
{
|
|
"integrationId": "<id from integrationList>",
|
|
"isPremium": false,
|
|
"date": "2025-01-15T10:00:00.000Z",
|
|
"shortLink": false,
|
|
"type": "schedule",
|
|
"postsAndComments": [{ "content": "<p>Hello world</p>", "attachments": [] }],
|
|
"settings": [{ "key": "<from integrationSchema>", "value": "..." }]
|
|
}
|
|
\`\`\`
|
|
|
|
- \`type\` is \`draft\`, \`schedule\`, or \`now\`. Use \`draft\` when the user
|
|
wants to review first; use \`now\` only when they explicitly ask to publish
|
|
immediately.
|
|
- \`date\` is UTC ISO-8601. Convert the user's local time; if no time is given,
|
|
ask or pick a sensible one and state it.
|
|
- One item per channel per time slot. Twenty posts across a month is twenty
|
|
items in one call.
|
|
|
|
## 5. Review and adjust
|
|
|
|
\`mcp__postiz__postsListTool\` lists posts between two dates.
|
|
\`mcp__postiz__postSettingsTool\` updates the settings of a post that has not
|
|
been published yet.
|
|
|
|
## Setup
|
|
|
|
The tools are missing when no API key is configured. The key comes from the
|
|
\`POSTIZ_API_KEY\` environment variable (Postiz → Settings → Developers →
|
|
Public API). Self-hosted instances set \`baseUrl\` on the \`postiz\` row in the
|
|
profile's \`cordis.patch.yml\`.
|
|
`
|