Hotel Social Automator

---

name: media.hotelmind description: Generate, review, and publish social media content through MCP with AgentAuth and workspace token authentication.

---

media.hotelmind

Calls MCP tools to generate, review, and publish social media content.

---

Prerequisites

Required Environment

| Dependency | Purpose | Required | |------------|---------|----------| | mcporter CLI | Invoke MCP server tools | Yes | | curl | Download images from URLs | Yes | | feishu-send at /usr/local/bin/feishu-send | Send Feishu notifications | No (only if Feishu notifications needed) | | Write access to /root/.openclaw/workspace/ | Store temporary images | Yes |

Note: If feishu-send is not available, the skill will still function but cannot send notifications via Feishu.

Required Configuration

This skill requires dual-token MCP authentication:

Authorization: Bearer hp_sk_*

X-Agent-User-Key: uk_*

Users must:

1. Sign in to AgentAuth and copy a uk_* 2. Sign in to HotelPost and create or copy a workspace hp_sk_* 3. Put both tokens into the installed agent's MCP configuration

Full user onboarding guide:

references/user-onboarding.md

MCP server must be configured in your agent's MCP settings:

{
  "mcpServers": {
    "hotelpost": {
      "type": "streamable-http",
      "url": "https://mcp.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ",
        "X-Agent-User-Key": ""
      }
    }
  }
}

Required credentials:

API Key: Obtain from HotelPost Web admin panel → Settings → API Keys. Format: hp_sk_xxxxxxxx

AgentAuth User Key: Obtain from AgentAuth Dashboard after user login. Format: uk_xxxxxxxx

MCP now requires both tokens together: workspace hp_sk_* plus user uk_*

Credit System

Content generation consumes credits:

Each draft generation (up to 4 candidates) costs 40 credits

Each regeneration costs 10 credits

If credit quota is exceeded, the tool returns AIQuotaExceededError. Ensure sufficient credits before generating content. Credits can be managed in the HotelPost Web admin panel.

Multi-Tenant Isolation

This skill uses the HotelPost API key to resolve the target workspace and uses X-Agent-User-Key to verify the calling user. Both are required, and all operations remain scoped to the workspace bound to the hp_sk_* key.

---

Tool Invocation

Must use mcporter to call MCP server tools — do NOT use exec/curl!

Correct usage:

mcporter call hotelpost. 

Examples:

mcporter call hotelpost.list_scenarios — List marketing scenarios

mcporter call hotelpost.generate_content scenarioId=scenario_demo_001 — Generate content

mcporter call hotelpost.get_drafts draftId=draft_demo_001 — Get draft details

Forbidden: using exec/curl to access MCP API directly. Must use mcporter!

MCP Server Configuration

MCP server name is hotelpost. Server URL and both auth headers must be configured as described above.

For full user-side setup, token acquisition, and troubleshooting:

references/user-onboarding.md

When to Activate

User asks to generate social media posts or publish content

User asks to browse or select marketing scenarios

User asks to manage, view, or modify drafts

User asks to check publishing status or post list

User mentions HotelPost, hotel marketing, or social media publishing

User asks to schedule posts

Keywords: hotel, social media, post, publish, draft, marketing scenario, Instagram, X, Facebook, LinkedIn

Core Flow

list_scenarios → generate_content → get_drafts (polling) → [regenerate_draft] → publish_post / schedule_post

Step-by-Step

1. Select Scenario — Call list_scenarios, display available scenarios, let user choose 2. Generate Content — Call generate_content(scenarioId, language), submit async generation task 3. Poll Drafts — Call get_drafts(scenarioId), wait for status to change from GENERATING to ACTIVE (usually 15-30 seconds) 4. View/Modify — Call get_drafts(draftId) to view full content and images; use regenerate_draft(draftId, feedback) to modify 5. Publish — Call list_connections first to confirm available accounts, then call publish_post or schedule_post 6. Check Status — Call get_post_status(draftId) to confirm publishing result

Tool Reference

| Tool | Purpose | Key Parameters | |------|---------|----------------| | list_scenarios | List marketing scenarios | none | | generate_content | Generate draft based on scenario | scenarioId, language? | | get_drafts | Query draft status/details | scenarioId or draftId | | regenerate_draft | Regenerate with feedback, supports language/platform | draftId, feedback?, language?, platform? | | list_connections | List bound social media accounts | none | | publish_post | Publish immediately | draftId, connectionIds[] | | schedule_post | Schedule for later | draftId, connectionIds[], scheduledAt | | list_posts | List posts | status?, page?, pageSize? | | get_post_status | Get publishing status | postId or draftId |

regenerate_draft Language Options

zh — Chinese (default)

en — English

th — Thai

ms — Malay

ja — Japanese

regenerate_draft Platform Options

x — X (Twitter)

facebook — Facebook

instagram — Instagram

linkedin — LinkedIn

list_posts Status Options

SCHEDULED — Scheduled posts

PUBLISHING — Currently publishing

PUBLISHED — Successfully published

PARTIAL_SUCCESS — Partially succeeded

FAILED — Failed

Important Rules

Information Display

Do NOT expose internal info to users: Cards should NOT contain draft IDs, internal numbers, etc. Only show content and images the user needs to see.

Performance Optimization

Image URL optimization: The first get_drafts(scenarioId) response includes image URLs in the draft list. Do NOT call get_drafts(draftId) again to fetch URLs — use the URLs directly from the first call to save time.

Parallel processing:

- Download images in parallel with & (curl -o "1.png" url1 & curl -o "2.png" url2 & wait) - Send multiple images in parallel (with rate limiting, 3-5 at a time recommended) - Avoid serial operations; parallelize whenever possible

Send Order

Send content first, wait, then send images. Do not send all content at once followed by images — users cannot correlate them.

General Rules

Must select a scenario before generating. Do NOT skip list_scenarios.

Generation is async. After generate_content returns, you MUST poll get_drafts at 10-15 second intervals, up to 3 times.

Drafts include image assets. No need for users to provide images.

Before publishing, must confirm account by calling list_connections to get connectionId.

If user says "post to Instagram", find INSTAGRAM platform ID from connections.

language defaults to zh (Chinese). Pass en when user requests English.

If user is not satisfied with draft, use regenerate_draft with feedback.

regenerate_draft supports specifying language (zh/en/th/ms/ja) and platform (x/facebook/instagram/linkedin). If not specified, regenerates for all platforms.

Image Handling

1. Ensure /root/.openclaw/workspace/ directory exists before downloading 2. Download images with random filenames like hotelpost_xxx.png - Do NOT save to /tmp/ — some platforms don't support it 3. Image URLs must include full signature parameters! Truncated URLs will be inaccessible. 4. Clean up temporary files after sending.

Workspace Directory

Before downloading images, ensure the workspace directory exists:

mkdir -p /root/.openclaw/workspace/

Platform Publishing

After publishing, send notifications via the appropriate IM platform. See the platform-specific guide in references/:

feishu-guide.md — Feishu platform sending guide (card/image format, ID selection rules)

Note: Feishu notification is optional. The skill functions without it, but users won't receive push notifications.

Conversation Examples

See references/conversation-examples.md

Error Handling

See references/error-handling.md

Required Environment

| Dependency | Purpose | Required | |------------|---------|----------| | mcporter CLI | Invoke MCP server tools | Yes | | curl | Download images from URLs | Yes | | feishu-send at /usr/local/bin/feishu-send | Send Feishu notifications | No (only if Feishu notifications needed) | | Write access to /root/.openclaw/workspace/ | Store temporary images | Yes |

Note: If feishu-send is not available, the skill will still function but cannot send notifications via Feishu.

Required Configuration

This skill requires dual-token MCP authentication:

Authorization: Bearer hp_sk_*

X-Agent-User-Key: uk_*

Users must:

1. Sign in to AgentAuth and copy a uk_* 2. Sign in to HotelPost and create or copy a workspace hp_sk_* 3. Put both tokens into the installed agent's MCP configuration

Full user onboarding guide:

references/user-onboarding.md

MCP server must be configured in your agent's MCP settings:

{
  "mcpServers": {
    "hotelpost": {
      "type": "streamable-http",
      "url": "https://mcp.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ",
        "X-Agent-User-Key": ""
      }
    }
  }
}

Required credentials:

API Key: Obtain from HotelPost Web admin panel → Settings → API Keys. Format: hp_sk_xxxxxxxx

AgentAuth User Key: Obtain from AgentAuth Dashboard after user login. Format: uk_xxxxxxxx

MCP now requires both tokens together: workspace hp_sk_* plus user uk_*

Credit System

Content generation consumes credits:

Each draft generation (up to 4 candidates) costs 40 credits

Each regeneration costs 10 credits

If credit quota is exceeded, the tool returns AIQuotaExceededError. Ensure sufficient credits before generating content. Credits can be managed in the HotelPost Web admin panel.

Multi-Tenant Isolation

This skill uses the HotelPost API key to resolve the target workspace and uses X-Agent-User-Key to verify the calling user. Both are required, and all operations remain scoped to the workspace bound to the hp_sk_* key.

---