mcpField
P
postiz

postiz

github.com/gitroomhqMarketing & growth5152 installsUpdated 1w ago
Repository

About postiz

Postiz is a social publishing skill for scheduling posts across supported social and chat channels. It covers channel discovery, media uploads, post listings, scheduling, and deletion through the Postiz API.

Key features

  1. 01Schedule posts across supported channels
  2. 02List connected channels and posts
  3. 03Find the next available posting slot
  4. 04Upload media from a file or URL
  5. 05Delete scheduled posts

Use cases

  1. 01Plan posts for multiple social channels
  2. 02Check channel availability before scheduling
  3. 03Attach uploaded media to a scheduled post

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gitroomhq/postiz-docs --skill postiz

After installing, type/postizin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

CODEOWNERS
README.md
LICENSE
.github/workflows/
docs-checks.yml
.idea/
.gitignore
copilot.data.migration.ask2agent.xml
copilot.data.migration.ask.xml
modules.xml
vcs.xml
new-postiz-docs.iml
copilot.data.migration.agent.xml
copilot.data.migration.edit.xml
php.xml
.vscode/
settings.json
cli/
analytics.mdx
authentication.mdx
clipping.mdx
integrations.mdx
media-upload.mdx
managing-posts.mdx
introduction.mdx
platform-examples.mdx
cloud/
codes-and-offers.mdx
downgrades.mdx
overview.mdx
plans.mdx
refunds-and-support.mdx
trial.mdx
limits.mdx
contributing/
developer-guide.mdx

Details

From the project README

Postiz Skill

Postiz is a tool to schedule social media and chat posts to 28+ channels:

X, LinkedIn, LinkedIn Page, Reddit, Instagram, Facebook Page, Threads, YouTube, Google My Business, TikTok, Pinterest, Dribbble, Discord, Slack, Kick, Twitch, Mastodon, Bluesky, Lemmy, Farcaster, Telegram, Nostr, VK, Medium, Dev.to, Hashnode, WordPress, ListMonk

Setup

  1. Get your API key: https://platform.postiz.com/settings
  2. Click on "Settings"
  3. Click "Reveal"
  4. Set environment variables: 
    export POSTIZ_API_KEY="your-api-key"

Get all added channels

curl -X GET "https://api.postiz.com/public/v1/integrations" \
  -H "Authorization: $POSTIZ_API_KEY"

Get the next available slot for a channel

curl -X GET "https://api.postiz.com/public/v1/find-slot/:id" \
  -H "Authorization: $POSTIZ_API_KEY"

Upload a new file (form-data)

curl -X POST "https://api.postiz.com/public/v1/upload" \
  -H "Authorization: $POSTIZ_API_KEY" \
  -F "file=@/path/to/your/file.png"

Upload a new file from an existing URL

curl -X POST "https://api.postiz.com/public/v1/upload-from-url" \
  -H "Authorization: $POSTIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/image.png"
  }'

Post list

curl -X GET "https://api.postiz.com/public/v1/posts?startDate=2024-12-14T08:18:54.274Z&endDate=2024-12-14T08:18:54.274Z&customer=optionalCustomerId" \
  -H "Authorization: $POSTIZ_API_KEY"

Schedule a new post

Settings for different channels can be found in: https://docs.postiz.com/public-api/introduction On the bottom left menu

When scheduling a new posts, if you attach media, you must upload it first and use the url of the uploaded media. Upload URL must contain: uploads.postiz.com.

curl -X POST "https://api.postiz.com/public/v1/posts" \
  -H "Authorization: $POSTIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-x-integration-id"
      },
      "value": [
        {
          "content": "Hello from the Postiz API! 🚀",
          "image": [{ "id": "img-123", "path": "https://uploads.postiz.com/photo.jpg" }]
        }
      ],
      "settings": {
        "__type": "provider name",
        rest of the settings
      }
    }
  ]
}'

Delete a post

curl -X DELETE "https://api.postiz.com/public/v1/posts/:id" \
  -H "Authorization: $POSTIZ_API_KEY"

Comments

Markdown supported