{
  "schemaVersion": "1.0",
  "item": {
    "slug": "postavel",
    "name": "Postavel",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/nezaboravi/postavel",
    "canonicalUrl": "https://clawhub.ai/nezaboravi/postavel",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/postavel",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=postavel",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/mcp-tools.md",
      "references/setup-guide.md",
      "scripts/install-mcp.sh",
      "scripts/setup-mcp.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/postavel"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/postavel",
    "agentPageUrl": "https://openagent3.xyz/skills/postavel/agent",
    "manifestUrl": "https://openagent3.xyz/skills/postavel/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/postavel/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "Postavel is a multi-platform social media management tool with native MCP (Model Context Protocol) support. This skill enables AI assistants to connect to Postavel and manage social media content through natural language.\n\nKey Capabilities:\n\nConnect to Postavel via MCP with OAuth authentication\nList workspaces, clients, and brands\nCreate and schedule posts across Facebook, Instagram, and LinkedIn\nManage approval workflows\nView content calendars and post statuses"
      },
      {
        "title": "First Time Setup (2 Steps)",
        "body": "CRITICAL: When this skill triggers, FIRST check if MCP connection works. If not:"
      },
      {
        "title": "Quick Setup",
        "body": "Step 1: Install mcporter:\n\n# macOS with Homebrew:\nbrew install mcporter\n\n# Or with npm (works everywhere):\nnpm install -g mcporter\n\nStep 2: Add Postavel and authenticate:\n\n# Add Postavel to mcporter\nmcporter config add postavel https://postavel.com/mcp/postavel\n\n# Authenticate (browser will open)\nmcporter auth postavel\n\nStep 3: Log in to Postavel in your browser and authorize\n\nStep 4: Come back here and say \"done\""
      },
      {
        "title": "Alternative: Install Script",
        "body": "curl -fsSL https://postavel.com/install-mcp | bash"
      },
      {
        "title": "Troubleshooting",
        "body": "\"mcporter: command not found\"\n\n# Find it:\nwhich mcporter || find ~ /usr/local -name mcporter 2>/dev/null | head -1\n\n# Use full path:\n/path/to/mcporter config add postavel https://postavel.com/mcp/postavel\n/path/to/mcporter auth postavel\n\n\"OAuth timeout\"\n\nThe browser auth worked but mcporter didn't detect it\nTry: mcporter auth postavel again\nOr check if it worked: mcporter list — if you see \"postavel\", you're connected"
      },
      {
        "title": "Once Setup is Complete",
        "body": "The MCP connection URL for Postavel is:\n\nhttps://postavel.com/mcp/postavel\n\nAuthentication Flow:\n\nInstall mcporter (one time)\nRun: mcporter auth https://postavel.com/mcp/postavel\nLog in to Postavel in browser\nAI assistant can now connect"
      },
      {
        "title": "Verify Connection",
        "body": "Once setup is complete, test with:\n\n\"Show me my Postavel workspaces\""
      },
      {
        "title": "Find where mcporter is and run it:",
        "body": "MCPORter=$(which mcporter || find /usr/local /opt ~ -name mcporter 2>/dev/null | head -1)\n\"$MCPORter\" --config ~/.config/mcporter/postavel.json\n\n## Quick Start\n\n### Once Setup is Complete\n\nThe MCP connection URL for Postavel is:\n\nhttps://postavel.com/mcp/postavel\n\n**Authentication Flow:**\n1. mcporter installed and configured (via setup above)\n2. OAuth token generated and bound to user's Postavel account  \n3. AI can only access workspaces/clients/brands the user has permission for\n4. All actions are logged in user's activity history\n\n### Verify Connection\n\nOnce setup is complete, test with:\n\n\"Show me my Postavel workspaces\"\n\n## Core Capabilities\n\n### 1. List Resources\n\n**Workspaces:**\n\n\"Show me my Postavel workspaces\"\n\"List all workspaces I have access to\"\n\n**Clients:**\n\n\"List clients in workspace [workspace-name]\"\n\"What clients does my agency have?\"\n\n**Brands:**\n\n\"Show brands for client [client-name]\"\n\"What brands can I manage?\"\n\n**Connected Platforms:**\n\n\"Which social accounts are connected for brand [brand-name]?\"\n\"Show me available platforms\"\n\n### 2. Create Posts\n\n**Basic Post Creation:**\n\n\"Create a Facebook post for [brand] saying: [content]\"\n\"Draft an Instagram post about [topic]\"\n\n**Multi-Platform Posts:**\n\n\"Create a post for Facebook and LinkedIn about [topic]\"\n\"Post to all platforms: [content]\"\n\n**With Media:**\n\n\"Create an Instagram post with this image: [URL] and caption: [text]\"\n\"Add this video to a Facebook post: [URL]\"\n\n**Available Platforms:**\n- `facebook` - Facebook pages\n- `instagram` - Instagram business accounts\n- `linkedin` - LinkedIn organizations (company pages)\n\n### 3. Schedule Posts\n\n**Schedule for Later:**\n\n\"Schedule a post for tomorrow at 2pm about [topic]\"\n\"Create a post for next Monday at 9am\"\n\"Schedule this for [date] at [time] CET\"\n\n**With Auto-Approval (Admin/Owner only):**\n\n\"Schedule a post for [time] and auto-approve it\"\n\"Create and publish a post now\"\n\n### 4. Approval Workflow\n\n**View Pending Posts:**\n\n\"Show me pending posts for [brand]\"\n\"What posts need approval?\"\n\n**Approve Posts:**\n\n\"Approve post ID [number]\"\n\"Approve all pending posts for [brand]\"\n\n## Role-Based Permissions\n\nThe AI assistant respects Postavel's permission system:\n\n| Role | Can Create | Can Approve | Can Auto-Approve |\n|------|-----------|-------------|------------------|\n| **Owner** | ✅ | ✅ | ✅ |\n| **Admin** | ✅ | ✅ | ✅ |\n| **Member** | ✅ (assigned brands only) | ❌ | ❌ |\n\n**Important:** If user is a Member, their posts will be created as \"pending\" and require Admin/Owner approval before publishing.\n\n## Language Support\n\nPostavel MCP works with prompts in multiple languages:\n\n**English:**\n\n\"Create a Facebook and LinkedIn post about our summer sale\"\n\"Schedule this for tomorrow at 2pm and auto-approve\"\n\n**Serbian/Croatian:**\n\n\"Kreiraj post za Facebook i LinkedIn o letnjoj rasprodaji\"\n\"Zakaži za sutra u 14h i odmah odobri\"\n\n**German:**\n\n\"Erstelle einen Facebook- und LinkedIn-Post über unseren Sommerschlussverkauf\"\n\"Plane dies für morgen um 14 Uhr und genehmige sofort\"\n\n## Common Workflows\n\n### Workflow 1: Create and Schedule a Campaign Post\n\n1. User: \"Create a post for Facebook and Instagram about our Black Friday sale, 30% off everything\"\n2. AI: Creates the post (status: draft)\n3. User: \"Schedule it for November 29th at 9am and approve it\"\n4. AI: Schedules the post and approves it (if user has permissions)\n\n### Workflow 2: Multi-Brand Management\n\n1. User: \"Show me all brands in workspace 'My Agency'\"\n2. AI: Lists brands\n3. User: \"Create a draft post for brand 'Coffee Shop' about new menu items\"\n4. AI: Creates draft post\n5. User: \"Now approve that post\"\n6. AI: Approves the post\n\n### Workflow 3: Content Calendar Review\n\n1. User: \"What posts are scheduled for this week?\"\n2. AI: Lists scheduled posts\n3. User: \"Approve all pending posts for brand 'Tech Startup'\"\n4. AI: Approves all pending posts for that brand\n\n## Troubleshooting\n\n### \"I can't see certain clients or brands\"\n- User may be a **Member** with limited access\n- They only see clients where they have assigned brands\n- Suggest: \"Ask your workspace admin to assign you to the needed brands\"\n\n### \"Auto-approve didn't work\"\n- Only **Admins** and **Owners** can auto-approve\n- If user is a Member, post is created but remains pending\n- Suggest: \"Your post was created but needs admin approval to publish\"\n\n### \"Wrong timezone on scheduled posts\"\n- Postavel uses the workspace's timezone settings\n- User can specify timezone explicitly: \"Schedule for 2pm CET\" or \"14:00 Belgrade time\"\n\n### \"Post not published even though scheduled\"\n- Check if post is **approved** — only approved posts are published\n- Check if scheduled time has passed\n- User can ask: \"What's the status of post ID [number]?\"\n\n## MCP Resources\n\n- **[references/mcp-tools.md](references/mcp-tools.md)** — Complete list of available MCP tools and their parameters\n- **[references/setup-guide.md](references/setup-guide.md)** — Detailed setup instructions for mcporter and OAuth\n- **[scripts/setup-mcp.sh](scripts/setup-mcp.sh)** — Automated setup script (optional)\n\n## Security & Privacy\n\n- OAuth tokens are session-specific and expire automatically\n- AI can only access data the user has permission to access\n- All actions are logged in user's activity history\n- User can revoke AI access at any time from Postavel settings"
      }
    ],
    "body": "Postavel\nOverview\n\nPostavel is a multi-platform social media management tool with native MCP (Model Context Protocol) support. This skill enables AI assistants to connect to Postavel and manage social media content through natural language.\n\nKey Capabilities:\n\nConnect to Postavel via MCP with OAuth authentication\nList workspaces, clients, and brands\nCreate and schedule posts across Facebook, Instagram, and LinkedIn\nManage approval workflows\nView content calendars and post statuses\nFirst Time Setup (2 Steps)\n\nCRITICAL: When this skill triggers, FIRST check if MCP connection works. If not:\n\nQuick Setup\n\nStep 1: Install mcporter:\n\n# macOS with Homebrew:\nbrew install mcporter\n\n# Or with npm (works everywhere):\nnpm install -g mcporter\n\n\nStep 2: Add Postavel and authenticate:\n\n# Add Postavel to mcporter\nmcporter config add postavel https://postavel.com/mcp/postavel\n\n# Authenticate (browser will open)\nmcporter auth postavel\n\n\nStep 3: Log in to Postavel in your browser and authorize\n\nStep 4: Come back here and say \"done\"\n\nAlternative: Install Script\ncurl -fsSL https://postavel.com/install-mcp | bash\n\nTroubleshooting\n\n\"mcporter: command not found\"\n\n# Find it:\nwhich mcporter || find ~ /usr/local -name mcporter 2>/dev/null | head -1\n\n# Use full path:\n/path/to/mcporter config add postavel https://postavel.com/mcp/postavel\n/path/to/mcporter auth postavel\n\n\n\"OAuth timeout\"\n\nThe browser auth worked but mcporter didn't detect it\nTry: mcporter auth postavel again\nOr check if it worked: mcporter list — if you see \"postavel\", you're connected\nQuick Start\nOnce Setup is Complete\n\nThe MCP connection URL for Postavel is:\n\nhttps://postavel.com/mcp/postavel\n\n\nAuthentication Flow:\n\nInstall mcporter (one time)\nRun: mcporter auth https://postavel.com/mcp/postavel\nLog in to Postavel in browser\nAI assistant can now connect\nVerify Connection\n\nOnce setup is complete, test with:\n\n\"Show me my Postavel workspaces\"\n\nFind where mcporter is and run it:\n\nMCPORter=$(which mcporter || find /usr/local /opt ~ -name mcporter 2>/dev/null | head -1) \"$MCPORter\" --config ~/.config/mcporter/postavel.json\n\n\n## Quick Start\n\n### Once Setup is Complete\n\nThe MCP connection URL for Postavel is:\n\n\nhttps://postavel.com/mcp/postavel\n\n\n**Authentication Flow:**\n1. mcporter installed and configured (via setup above)\n2. OAuth token generated and bound to user's Postavel account  \n3. AI can only access workspaces/clients/brands the user has permission for\n4. All actions are logged in user's activity history\n\n### Verify Connection\n\nOnce setup is complete, test with:\n\n\n\"Show me my Postavel workspaces\"\n\n\n## Core Capabilities\n\n### 1. List Resources\n\n**Workspaces:**\n\n\n\"Show me my Postavel workspaces\" \"List all workspaces I have access to\"\n\n\n**Clients:**\n\n\n\"List clients in workspace [workspace-name]\" \"What clients does my agency have?\"\n\n\n**Brands:**\n\n\n\"Show brands for client [client-name]\" \"What brands can I manage?\"\n\n\n**Connected Platforms:**\n\n\n\"Which social accounts are connected for brand [brand-name]?\" \"Show me available platforms\"\n\n\n### 2. Create Posts\n\n**Basic Post Creation:**\n\n\n\"Create a Facebook post for [brand] saying: [content]\" \"Draft an Instagram post about [topic]\"\n\n\n**Multi-Platform Posts:**\n\n\n\"Create a post for Facebook and LinkedIn about [topic]\" \"Post to all platforms: [content]\"\n\n\n**With Media:**\n\n\n\"Create an Instagram post with this image: [URL] and caption: [text]\" \"Add this video to a Facebook post: [URL]\"\n\n\n**Available Platforms:**\n- `facebook` - Facebook pages\n- `instagram` - Instagram business accounts\n- `linkedin` - LinkedIn organizations (company pages)\n\n### 3. Schedule Posts\n\n**Schedule for Later:**\n\n\n\"Schedule a post for tomorrow at 2pm about [topic]\" \"Create a post for next Monday at 9am\" \"Schedule this for [date] at [time] CET\"\n\n\n**With Auto-Approval (Admin/Owner only):**\n\n\n\"Schedule a post for [time] and auto-approve it\" \"Create and publish a post now\"\n\n\n### 4. Approval Workflow\n\n**View Pending Posts:**\n\n\n\"Show me pending posts for [brand]\" \"What posts need approval?\"\n\n\n**Approve Posts:**\n\n\n\"Approve post ID [number]\" \"Approve all pending posts for [brand]\"\n\n\n## Role-Based Permissions\n\nThe AI assistant respects Postavel's permission system:\n\n| Role | Can Create | Can Approve | Can Auto-Approve |\n|------|-----------|-------------|------------------|\n| **Owner** | ✅ | ✅ | ✅ |\n| **Admin** | ✅ | ✅ | ✅ |\n| **Member** | ✅ (assigned brands only) | ❌ | ❌ |\n\n**Important:** If user is a Member, their posts will be created as \"pending\" and require Admin/Owner approval before publishing.\n\n## Language Support\n\nPostavel MCP works with prompts in multiple languages:\n\n**English:**\n\n\n\"Create a Facebook and LinkedIn post about our summer sale\" \"Schedule this for tomorrow at 2pm and auto-approve\"\n\n\n**Serbian/Croatian:**\n\n\n\"Kreiraj post za Facebook i LinkedIn o letnjoj rasprodaji\" \"Zakaži za sutra u 14h i odmah odobri\"\n\n\n**German:**\n\n\n\"Erstelle einen Facebook- und LinkedIn-Post über unseren Sommerschlussverkauf\" \"Plane dies für morgen um 14 Uhr und genehmige sofort\"\n\n\n## Common Workflows\n\n### Workflow 1: Create and Schedule a Campaign Post\n\n1. User: \"Create a post for Facebook and Instagram about our Black Friday sale, 30% off everything\"\n2. AI: Creates the post (status: draft)\n3. User: \"Schedule it for November 29th at 9am and approve it\"\n4. AI: Schedules the post and approves it (if user has permissions)\n\n### Workflow 2: Multi-Brand Management\n\n1. User: \"Show me all brands in workspace 'My Agency'\"\n2. AI: Lists brands\n3. User: \"Create a draft post for brand 'Coffee Shop' about new menu items\"\n4. AI: Creates draft post\n5. User: \"Now approve that post\"\n6. AI: Approves the post\n\n### Workflow 3: Content Calendar Review\n\n1. User: \"What posts are scheduled for this week?\"\n2. AI: Lists scheduled posts\n3. User: \"Approve all pending posts for brand 'Tech Startup'\"\n4. AI: Approves all pending posts for that brand\n\n## Troubleshooting\n\n### \"I can't see certain clients or brands\"\n- User may be a **Member** with limited access\n- They only see clients where they have assigned brands\n- Suggest: \"Ask your workspace admin to assign you to the needed brands\"\n\n### \"Auto-approve didn't work\"\n- Only **Admins** and **Owners** can auto-approve\n- If user is a Member, post is created but remains pending\n- Suggest: \"Your post was created but needs admin approval to publish\"\n\n### \"Wrong timezone on scheduled posts\"\n- Postavel uses the workspace's timezone settings\n- User can specify timezone explicitly: \"Schedule for 2pm CET\" or \"14:00 Belgrade time\"\n\n### \"Post not published even though scheduled\"\n- Check if post is **approved** — only approved posts are published\n- Check if scheduled time has passed\n- User can ask: \"What's the status of post ID [number]?\"\n\n## MCP Resources\n\n- **[references/mcp-tools.md](references/mcp-tools.md)** — Complete list of available MCP tools and their parameters\n- **[references/setup-guide.md](references/setup-guide.md)** — Detailed setup instructions for mcporter and OAuth\n- **[scripts/setup-mcp.sh](scripts/setup-mcp.sh)** — Automated setup script (optional)\n\n## Security & Privacy\n\n- OAuth tokens are session-specific and expire automatically\n- AI can only access data the user has permission to access\n- All actions are logged in user's activity history\n- User can revoke AI access at any time from Postavel settings"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/nezaboravi/postavel",
    "publisherUrl": "https://clawhub.ai/nezaboravi/postavel",
    "owner": "nezaboravi",
    "version": "1.5.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/postavel",
    "downloadUrl": "https://openagent3.xyz/downloads/postavel",
    "agentUrl": "https://openagent3.xyz/skills/postavel/agent",
    "manifestUrl": "https://openagent3.xyz/skills/postavel/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/postavel/agent.md"
  }
}