johnnycrypto289/masonclawv4/postiz

Postiz Skill

Post content to social media via Postiz API.

Config

All credentials are loaded from environment variables. Set these in .env.local:

POSTIZ_API_KEY=your_postiz_api_key
POSTIZ_TIKTOK_SNUGLY=your_snugly_integration_id
POSTIZ_TIKTOK_LIPLY=your_liply_integration_id

TikTok Slideshow Workflow

1. Upload Images First

Each image must be uploaded separately before creating the post:

node skills/postiz/upload.js /path/to/image.png

Returns: { "id": "...", "path": "https://..." }

2. Create Slideshow Post

node skills/postiz/post-tiktok.js <app> <caption> <image-ids...>

• app: snugly or liply
• caption: Post caption with hashtags
• image-ids: Space-separated uploaded image IDs

Example:

node skills/postiz/post-tiktok.js snugly "POV: You finally fixed your boring room 🏠 #homedecor #roomtransformation #interiordesign" img1 img2 img3 img4 img5 img6

3. Full Slideshow Script

For convenience, upload all images and create post in one go:

node skills/postiz/slideshow.js <app> "<caption>" /path/to/slide1.png /path/to/slide2.png ...

TikTok Settings

Default settings (drafts for Ollie to add music):

• privacy_level: SELF_ONLY (draft)
• content_posting_method: UPLOAD (manual posting)
• autoAddMusic: no
• video_made_with_ai: true (AI disclosure)
• duet, stitch, comment: true

API Reference

Upload Endpoint

POST https://api.postiz.com/public/v1/upload
Authorization: <api-key>
Content-Type: multipart/form-data
Body: file=@image.png

Post Endpoint

POST https://api.postiz.com/public/v1/posts
Authorization: <api-key>
Content-Type: application/json
Body: { type, date, posts: [...] }

Post Types

• now: Post immediately
• schedule: Post at specified date
• draft: Save as draft