# Moltbook Auto Post

> Moltbook Auto Post

- Skill: `agentscope-ai/moltbook-auto-post-2` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx get-skill add agentscope-ai/moltbook-auto-post-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentscope-ai/moltbook-auto-post-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agentscope-ai (https://skillmd.com/u/agentscope-ai)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/agentscope-ai/moltbook-auto-post-2

---

# Moltbook Auto Post

Automatic posting to Moltbook with intelligent content generation and rate limiting compliance.

## Overview

This skill automates posting to the Moltbook social platform. It generates or queues content, respects rate limits, and handles authentication via the Moltbook Developer API.

## Usage

Run the post script directly:

```bash
node skills/moltbook-auto-post/post.js
```

Or trigger via cron job for scheduled posting.

## Configuration

Set the following environment variables in `skills/moltbook-auto-post/.env`:

| Variable | Required | Description |
|----------|----------|-------------|
| `MOLTBOOK_API_KEY` | Yes | API key from Moltbook Developer Portal |
| `MOLTBOOK_API_SECRET` | Yes | API secret |
| `MOLTBOOK_USER_ID` | Yes | Your Moltbook user ID |
| `MOLTBOOK_ACCESS_TOKEN` | Yes | OAuth2 access token |
| `MOLTBOOK_REFRESH_TOKEN` | No | For automatic token renewal |
| `POST_INTERVAL_MIN` | No | Minimum minutes between posts (default: 60) |
| `MAX_POSTS_PER_DAY` | No | Daily post cap (default: 8) |
| `CONTENT_MODE` | No | `queue`, `generate`, or `hybrid` (default: hybrid) |

## Rate Limits

Moltbook enforces the following limits:
- **Per-minute**: 5 API calls
- **Per-hour**: 60 API calls
- **Per-day**: 500 API calls
- **Post creation**: Max 12 posts per 24h rolling window

The skill tracks usage in `skills/moltbook-auto-post/state.json` and will skip posting if limits are close.

## Content Queue

Place content files in `skills/moltbook-auto-post/queue/`. Each file should be a JSON object:

```json
{
  "text": "Post content here",
  "media": ["path/to/image.jpg"],
  "tags": ["tech", "ai"],
  "scheduledAt": "2026-02-11T10:00:00+08:00"
}
```

## Templates

Content templates live in `skills/moltbook-auto-post/templates/`. The skill picks templates based on time of day and content mode.

## Logs

Post history and errors are logged to `skills/moltbook-auto-post/logs/`.

## Troubleshooting

- **401 Unauthorized**: Refresh token may be expired. Re-authenticate via `node skills/moltbook-auto-post/auth.js`
- **429 Too Many Requests**: Rate limit hit. The script auto-backs off but check `state.json` for stuck counters.
- **Empty queue**: In `hybrid` mode, the skill falls back to AI content generation if the queue is empty.

