PosteAhora is a tool to schedule and publish social media posts to Instagram, TikTok, YouTube, X (Twitter), Facebook, LinkedIn, Threads, Bluesky and Discord — from your own code, terminal, CI, or an AI agent, via a CLI, an MCP server, or a REST API.

PosteAhora

Schedule and publish social media posts across every major network from the command line, powered by PosteAhora. Use this skill to create, schedule, publish and manage social content, organize a content-idea backlog, upload media, and read analytics on the user's behalf.

Install PosteAhora CLI if it doesn't exist

Check whether the CLI is available:

posteahora --version

If it isn't installed:

npm install -g @posteahora/cli
# or
pnpm install -g @posteahora/cli

The installed command is posteahora. It can also run via npx @posteahora/cli.

Official resources

• Website: https://posteahora.com
• Docs: https://posteahora.com/docs
• API reference: https://posteahora.com/docs/api
• CLI on npm: https://www.npmjs.com/package/@posteahora/cli
• CLI on GitHub: https://github.com/posteahora/cli
• MCP server: https://github.com/posteahora/mcp

⚠️ Authentication Required

You MUST authenticate before running any other command. Every command fails without a valid key.

Check status first:

posteahora auth

If not authenticated, the user creates an API key in the app under Settings → API & integrations (it looks like pah_live_…), then:

posteahora auth --key pah_live_xxxxxxxx

The key is validated and stored in ~/.posteahora/config.json. It can also be supplied via the POSTEAHORA_API_KEY environment variable (useful in CI). Never print, log, or echo the key.

Core workflow

Follow this order for any publishing task:

1. Authenticate — posteahora auth
2. Discover accounts — posteahora accounts to get the account ID for each platform. You cannot post without an explicit account ID.
3. Upload media (optional) — posteahora upload → returns a public URL to pass to --media.
4. Create / schedule / publish — posteahora post …
5. Verify — posteahora posts (or --json) to confirm status.
6. Analyze (optional) — posteahora analytics.

Command reference

Authentication

posteahora auth --key pah_live_xxxx   # save & validate a key
posteahora auth                       # show current status
posteahora logout                     # remove the saved key

Accounts

posteahora accounts          # human-readable table
posteahora accounts --json   # machine-readable

Each row includes platform, username, the account id, and connection status. Use the id in --to platform:accountId.

Create a post

# Publish now to one or more channels
posteahora post "Launch day 🚀" --to twitter:a1b2 --to linkedin:c3d4

# Schedule for a future time (ISO 8601)
posteahora post "Morning tip" --to instagram:e5f6 --at 2026-07-20T09:00:00Z

# Draft only (nothing goes live)
posteahora post "Draft idea" --to twitter:a1b2 --draft

# With uploaded media
posteahora upload ./reel.mp4
posteahora post "New reel" --to instagram:e5f6 --media https://cdn.posteahora.com/… --at 2026-07-20T09:00:00Z

post options

• --to platform:accountId — target channel (repeatable or comma-separated) (required)
• --media — attach media (repeatable; from upload)
• --at — schedule for a future time (else publish now)
• --draft — create a draft instead of publishing
• --title, --hashtags a,b, --media-type image|video, --post-type post|reel|story
• --json — machine-readable output

Manage & analyze

posteahora posts --status scheduled          # list posts by status
posteahora ideas add "5 hooks" --tags launch # add a backlog idea
posteahora ideas list
posteahora analytics --period 30d            # performance across platforms
posteahora upload ./photo.jpg                # upload media → public URL

Handling account IDs

The user will describe channels by name ("post to my Instagram and X"). Map each name to a real account ID by running posteahora accounts and matching the platform/username. Never guess an ID, and never fall back to "the first account" — if a requested platform has no connected account, tell the user and skip it.

Guardrails

• Publishing is outward-facing and hard to undo. Before running posteahora post WITHOUT --draft, confirm the caption, channels, and time with the user. When unsure, create a --draft and ask.
• Scheduled times must be in the future and ISO 8601.
• Never invent media URLs, analytics numbers, or claims in captions.
• Respect each platform's limits (e.g. X character count) — offer a per-platform caption instead of silently truncating.
• If a command fails, report the exact error message and stop; do not retry blindly.
• Never print or store the API key.

Errors

• "No API key…" — run posteahora auth --key pah_live_… (or set POSTEAHORA_API_KEY).
• --at must be in the future — the scheduled time is in the past; pick a future ISO 8601 timestamp.
• Invalid --to … — the value isn't platform:accountId; run posteahora accounts and use a real ID.
• HTTP 401 / 403 — key invalid or lacking scope; re-auth with a full-access key.
• HTTP 429 — rate limited; wait and retry.

See also

• QUICK_START.md — the fastest path to a published post.
• FEATURES.md — full capability list.
• PLATFORMS.md — per-platform support.
• PUBLISHING.md — how publishing & scheduling work.
• SUPPORTED_FILE_TYPES.md — accepted media formats.
• examples/ — ready-to-run command examples.