Xpersona
U

Upload-Post

CLAWHUB · Unverified

Publish and schedule content to 15 social platforms through one Upload-Post API call: TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Reddit, Discord, Telegram, Mastodon, WordPress and Google Business Profile. Use when posting or scheduling videos, photo carousels, text or documents across several platforms at once, checking upload status, or pulling analytics. Skill: Upload-Post Owner: victorcavero14 Summary: Publish and schedule content to 15 social platforms through one Upload-Post API call: TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Reddit, Discord, Telegram, Mastodon, WordPress and Google Business Profile. Use when posting or scheduling videos, photo carousels, text or documents across several platforms at once, checking upload stat

62
Rank
84
Safety
11k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 11K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s1798fjs761mjqrzp9pq7z44qh884s46:upload-post
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-victorcavero14-upload-post-oad-post-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

46,411 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: upload-post
description: "Publish and schedule content to 15 social platforms through one Upload-Post API call: TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Reddit, Discord, Telegram, Mastodon, WordPress and Google Business Profile. Use when posting or scheduling videos, photo carousels, text or documents across several platforms at once, checking upload status, or pulling analytics."
allowed-tools: Read, Write, Bash(curl:*), Bash(jq:*)
version: "1.2.0"
author: Upload-Post <support@upload-post.com>
license: MIT
compatibility: "Works in Claude Code, OpenClaw and any agent runtime supporting the Agent Skills spec. Requires curl on PATH and the UPLOAD_POST_API_KEY environment variable (optionally UPLOAD_POST_PROFILE). No local media tooling needed — uploads are server-side."
tags:
- social-media
- publishing
- scheduling
- api
- analytics
metadata: {"openclaw":{"emoji":"📤","homepage":"https://upload-post.com","requires":{"bins":["curl"],"env":["UPLOAD_POST_API_KEY"]},"primaryEnv":"UPLOAD_POST_API_KEY"}}
---

# Upload-Post API

Post content to multiple social media platforms with a single API call.

## Overview

One request fans out to every target platform and reports a per-platform result. Accounts are
connected once through OAuth in the Upload-Post dashboard, so this skill never handles
per-platform developer apps, review processes or token refresh — a single API key covers all
15 platforms.

Four content types are supported: video, photo carousels, text-only posts and documents
(LinkedIn). Each can be published immediately, scheduled for a future date, or added to a
posting queue.

## Documentation

- Full API docs: https://docs.upload-post.com
- LLM-friendly: https://docs.upload-post.com/llm.txt

## Setup

1. Create account at [upload-post.com](https://upload-post.com)
2. Connect your social media accounts
3. Create a **Profile** (e.g., "mybrand") - this links your connected accounts
4. Generate an **API Key** from dashboard
5. Use the profile name as `user` parameter in API calls

## Configuration

The skill reads two environment variables. Nothing else needs to be installed or wired up:
the OAuth for every platform already happened in the dashboard.

| Variable | Required | Purpose |
|----------|----------|---------|
| `UPLOAD_POST_API_KEY` | yes | API key from the dashboard. Sent as `Authorization: Apikey $UPLOAD_POST_API_KEY`. |
| `UPLOAD_POST_PROFILE` | no | Default profile name for the `user` parameter, so it is not repeated on every request. |

Export them in the shell that runs the agent:

```bash
export UPLOAD_POST_API_KEY="..."
export UPLOAD_POST_PROFILE="mybrand"
```

On **OpenClaw / ClawHub** the skill is gated on `UPLOAD_POST_API_KEY`: until the key is set it
shows as ineligible in `openclaw skills list`. Put it in `~/.openclaw/openclaw.json` so it is
injected only for this skill (`apiKey` maps to `UPLOAD_POST_API_KEY`):

```json5
{
  skills: {
    entries: {
      "upload-post": {
     

README.md

# Upload-Post Skill for Claude Code / AI Agents

A skill for AI agents (Claude Code, Clawdbot, etc.) to upload content to social media platforms via the Upload-Post API.

## Supported Platforms

| Platform | Videos | Photos | Text | Documents |
|----------|--------|--------|------|-----------|
| TikTok | ✓ | ✓ | - | - |
| Instagram | ✓ | ✓ | - | - |
| YouTube | ✓ | - | - | - |
| LinkedIn | ✓ | ✓ | ✓ | ✓ |
| Facebook | ✓ | ✓ | ✓ | - |
| X (Twitter) | ✓ | ✓ | ✓ | - |
| Threads | ✓ | ✓ | ✓ | - |
| Pinterest | ✓ | ✓ | - | - |
| Reddit | - | ✓ | ✓ | - |
| Bluesky | ✓ | ✓ | ✓ | - |

## Features

- Upload videos, photos, carousels, text posts, and documents
- Schedule posts for later
- Cross-post to multiple platforms simultaneously
- FFmpeg media processing (resize, transcode, etc.)
- Analytics retrieval
- Upload history tracking

## Installation

### For Claude Code / skills.sh
```bash
npx skills add Upload-Post/upload-post-skill
```

### For OpenClaw / ClawHub
```bash
openclaw skills install upload-post
```

### Manual Installation
Copy `SKILL.md` and `references/` to your agent's skills directory.

## Setup

1. Create account at [upload-post.com](https://upload-post.com)
2. Connect your social media accounts
3. Create a **Profile** (links your connected accounts)
4. Generate an **API Key** from dashboard
5. Expose the key to the agent as `UPLOAD_POST_API_KEY` (and optionally the profile name as
   `UPLOAD_POST_PROFILE`). On OpenClaw, set them in `~/.openclaw/openclaw.json` under
   `skills.entries.upload-post` (`apiKey` + `env`) — the skill stays ineligible until the key
   is present. See the *Configuration* section of `SKILL.md`.

## Usage

The skill provides comprehensive API documentation in `SKILL.md`. Your AI agent can:

```bash
# Upload a video
curl -X POST "https://api.upload-post.com/api/upload" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F "user=profile_name" \
  -F "platform[]=instagram" \
  -F "platform[]=tiktok" \
  -F "video=@video.mp4" \
  -F "title=My caption"

# Upload photos
curl -X POST "https://api.upload-post.com/api/upload_photos" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F "user=profile_name" \
  -F "platform[]=instagram" \
  -F "photos[]=@photo1.jpg" \
  -F "title=My caption"

# Check upload status
curl "https://api.upload-post.com/api/uploadposts/status?request_id=XXX" \
  -H "Authorization: Apikey YOUR_KEY"
```

## Documentation

- Full API docs: https://docs.upload-post.com
- LLM-friendly: https://docs.upload-post.com/llm.txt

## License

MIT

_meta.json

{
  "ownerId": "kn7besm0rhvgwxgng386k0xf0h7zx61p",
  "slug": "upload-post",
  "version": "1.2.0",
  "publishedAt": 1788280215585
}

references/platforms.md

# Platform-Specific Parameters

## TikTok

| Parameter | Type | Description |
|-----------|------|-------------|
| `tiktok_title` | String | Override title for TikTok |
| `post_mode` | String | `DIRECT_POST` (default) or `MEDIA_UPLOAD` (draft) |
| `privacy_level` | String | `PUBLIC_TO_EVERYONE`, `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR`, `SELF_ONLY` |
| `auto_add_music` | Boolean | Add background music to photos |
| `disable_comment` | Boolean | Disable comments |
| `brand_content_toggle` | Boolean | Paid partnership content |
| `photo_cover_index` | Integer | Cover photo index (0-based) |

## Instagram

| Parameter | Type | Description |
|-----------|------|-------------|
| `instagram_title` | String | Override title |
| `media_type` | String | `IMAGE`, `STORIES`, `REELS` |
| `collaborators` | String | Comma-separated usernames |
| `user_tags` | String | Comma-separated users to tag |
| `location_id` | String | Instagram location ID |

## YouTube

| Parameter | Type | Description |
|-----------|------|-------------|
| `youtube_title` | String | Video title |
| `youtube_description` | String | Video description |
| `privacy_status` | String | `public`, `private`, `unlisted` |
| `category_id` | String | YouTube category ID |
| `tags` | Array | Video tags |
| `made_for_kids` | Boolean | COPPA compliance |
| `playlist_id` | String | Add to playlist |

## LinkedIn

| Parameter | Type | Description |
|-----------|------|-------------|
| `linkedin_title` | String | Override title |
| `visibility` | String | `PUBLIC`, `CONNECTIONS`, `LOGGED_IN` |
| `target_linkedin_page_id` | String | Organization/page URN |

Get page IDs: `GET /api/uploadposts/linkedin/pages`

## Facebook

| Parameter | Type | Description |
|-----------|------|-------------|
| `facebook_title` | String | Override title |
| `facebook_page_id` | String | Page ID (required for pages) |
| `facebook_media_type` | String | `POSTS` or `STORIES` |

Get page IDs: `GET /api/uploadposts/facebook/pages`

Note: Personal profiles not supported by Meta API - only Pages.

## X (Twitter)

| Parameter | Type | Description |
|-----------|------|-------------|
| `x_title` | String | Override title |
| `x_long_text_as_post` | Boolean | Post long text as single post (default: thread) |
| `reply_settings` | String | `following`, `mentionedUsers`, `subscribers`, `verified` |
| `reply_to_id` | String | Tweet ID to reply to |
| `community_id` | String | Post to community |
| `tagged_user_ids` | Array | Users to tag in photos (max 10) |

Thread behavior: Long text auto-splits at 280 chars. Media attaches to first tweet only.

## Threads

| Parameter | Type | Description |
|-----------|------|-------------|
| `threads_title` | String | Override title |

Supports mixed carousels (photos + videos).

## Pinterest

| Parameter | Type | Description |
|-----------|------|-------------|
| `pinterest_title` | String | Pin title |
| `pinterest_board_id` | String | Target board ID (required) |
| `pinterest_link` | Str

references/requirements.md

# Media Requirements by Platform

## Photo Requirements

### Instagram
- Formats: JPEG, PNG, GIF
- Aspect ratio: 4:5 to 1.91:1
- Recommended: 1080x1350px (4:5)

### TikTok
- Formats: JPG, JPEG, WEBP only
- Use for photo slideshows with `auto_add_music`

### Facebook
- Formats: JPEG, PNG, GIF, WebP
- Max size: 10MB recommended

### X (Twitter)
- Formats: JPEG, PNG, GIF
- Max size: 5MB (images), 15MB (GIFs)
- Max 4 images per tweet

### LinkedIn
- Formats: JPEG, PNG, GIF
- Recommended: 1200x627px

### Threads
- Formats: JPEG, PNG
- Max size: 8MB
- Aspect ratio: 10:1 to 1:10
- Width: 320px min, 1440px max
- Color space: sRGB (auto-converted)

### Pinterest
- Formats: BMP, JPEG, PNG, TIFF, GIF, WebP
- Max size: 20MB
- Recommended: 1000x1500px (2:3)
- Min: 600x900px, Max: 2000x3000px
- Carousel: up to 5 images, same dimensions

### Reddit
- Formats: JPG, PNG, GIF, WEBP
- Max size: 10MB

### Bluesky
- Formats: JPEG, PNG, GIF, WebP
- Max size: 1MB per image
- Max 4 images per post
- Daily limit: 50 uploads (photos + videos)

## Video Requirements

### TikTok
- Formats: MP4, MOV, WebM
- Duration: 3s to 10min
- Max size: 4GB
- Recommended: 1080x1920 (9:16)
- Codec: H.264

### Instagram
- Formats: MP4, MOV
- Reels: 0-90s, 9:16 aspect
- Feed: up to 60s
- Max size: 4GB
- Codec: H.264, AAC audio

### YouTube
- Formats: MP4, MOV, AVI, WMV, FLV, WebM
- Max size: 256GB
- Max duration: 12 hours
- Recommended: 1920x1080 or 3840x2160

### LinkedIn
- Formats: MP4
- Duration: 3s to 10min
- Max size: 5GB
- Aspect: 1:2.4 to 2.4:1

### Facebook
- Formats: MP4, MOV
- Max size: 10GB
- Max duration: 240min
- Recommended: H.264, AAC

### X (Twitter)
- Formats: MP4, MOV
- Max size: 512MB
- Max duration: 140s (2min 20s)
- Codec: H.264

### Threads
- Formats: MP4, MOV
- Max duration: 5min
- Aspect: 9:16 recommended

### Pinterest
- Formats: MP4, MOV, M4V
- Duration: 4s to 15min
- Max size: 2GB
- Aspect: 1:2 to 1.91:1

### Bluesky
- Formats: MP4
- Max size: 50MB
- Max duration: 60s
- Daily limit: 50 uploads

## Document Requirements (LinkedIn only)

- Formats: PDF, PPT, PPTX, DOC, DOCX
- Max size: 100MB
- Max pages: 300

## FFmpeg Re-encoding

If videos fail platform validation, use the FFmpeg endpoint:

```bash
# Convert to H.264 MP4
ffmpeg -y -i {input} -c:v libx264 -preset medium -crf 23 -c:a aac -b:a 128k {output}

# Resize to 1080p
ffmpeg -y -i {input} -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -crf 23 {output}

# Convert to 9:16 vertical
ffmpeg -y -i {input} -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -crf 23 {output}
```

Sponsored

Ads related to Upload-Post and adjacent AI workflows.