# Socialclaw

> Schedule and publish social media posts across X, LinkedIn, Instagram, Facebook Pages, TikTok, YouTube, Reddit, Pinterest, WordPress, Discord, and Telegram. Use when the user wants to post, schedule, or publish to social media, or check post status and analytics.

- **Type:** Skill
- **Install:** `agentstack add skill-ndesv21-socialclaw-hermes`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ndesv21](https://agentstack.voostack.com/s/ndesv21)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ndesv21](https://github.com/ndesv21)
- **Source:** https://github.com/ndesv21/socialclaw/tree/main/skills/hermes
- **Website:** https://getsocialclaw.com

## Install

```sh
agentstack add skill-ndesv21-socialclaw-hermes
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SocialClaw

Schedule and publish social media posts through connected accounts using the hosted SocialClaw API. SocialClaw handles each network's OAuth, media rules, and publish logic, so this skill only needs a workspace API key.

## When to Use
- The user wants to post or schedule content to social media
- The user wants to publish the same message to multiple platforms at once
- The user wants to check whether a scheduled post succeeded
- The user asks for post analytics

## Supported Networks
X, LinkedIn (profile + page), Instagram (business + standalone), Facebook Pages, TikTok, YouTube, Reddit, Pinterest, WordPress, Discord, and Telegram.

## Authentication
All requests go to `https://getsocialclaw.com` and send the workspace key:

```
Authorization: Bearer $SOCIALCLAW_API_KEY
```

Never hardcode the key — read it from the `SOCIALCLAW_API_KEY` environment variable.

## Procedure
1. **List connected accounts** to get an account id: `GET /v1/accounts`
2. *(optional)* **Check capabilities** (media/text limits): `GET /v1/accounts/{accountId}/capabilities`
3. *(optional)* **Upload media**: `POST /v1/assets/upload` with `{ filename, contentType, contentBase64 }` → returns a hosted URL to use as `media_link`
4. **Validate before publishing** (always): `POST /v1/posts/validate` with `{ schedule }`
5. **Schedule or publish**: `POST /v1/posts/apply` with `{ schedule }`. Omit `publish_at` to publish immediately.
6. **Check status**: `GET /v1/posts/{postId}/attempts`

### Schedule document shape
```json
{
  "timezone": "UTC",
  "posts": [
    {
      "account": "",
      "name": "launch post",
      "description": "",
      "publish_at": "2026-06-16T09:00:00Z",
      "media_link": ""
    }
  ]
}
```

## Examples

List connected accounts:
```bash
curl -s https://getsocialclaw.com/v1/accounts \
  -H "Authorization: Bearer $SOCIALCLAW_API_KEY"
```

Validate, then schedule a post:
```bash
PAYLOAD='{"schedule":{"timezone":"UTC","posts":[{"account":"ACCOUNT_ID","name":"launch","description":"Hello from Hermes 🦅","publish_at":"2026-06-16T09:00:00Z"}]}}'

curl -s -X POST https://getsocialclaw.com/v1/posts/validate \
  -H "Authorization: Bearer $SOCIALCLAW_API_KEY" -H "Content-Type: application/json" -d "$PAYLOAD"

curl -s -X POST https://getsocialclaw.com/v1/posts/apply \
  -H "Authorization: Bearer $SOCIALCLAW_API_KEY" -H "Content-Type: application/json" -d "$PAYLOAD"
```

## Alternative: hosted MCP or CLI
SocialClaw also exposes the same capabilities as tools:
- **MCP**: connect to the hosted streamable-HTTP server at `https://getsocialclaw.com/mcp` with `Authorization: Bearer $SOCIALCLAW_API_KEY`.
- **CLI**: `npx -y socialclaw mcp` (stdio MCP), or the `socialclaw` CLI after `socialclaw login`.

## Network Calls
- `https://getsocialclaw.com` — SocialClaw REST API and hosted MCP. This is the only host contacted.

## Notes & Limitations
- Always run `validate` before `apply` to catch provider-rule and media issues early.
- Each network has its own media type, text length, and account-model rules; the capabilities endpoint reports them.
- Publishing requires an active SocialClaw plan; listing tools/accounts works on a trial key.
- Accounts are connected once in the SocialClaw dashboard; this skill does not perform per-network OAuth.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ndesv21](https://github.com/ndesv21)
- **Source:** [ndesv21/socialclaw](https://github.com/ndesv21/socialclaw)
- **License:** MIT
- **Homepage:** https://getsocialclaw.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ndesv21-socialclaw-hermes
- Seller: https://agentstack.voostack.com/s/ndesv21
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.