# @start-win/social-mcp

Serveur [MCP](https://modelcontextprotocol.io) pour publier et programmer des posts via [Social by Start-Win](https://social.start-win.fr).

## Prérequis

1. Compte Social by Start-Win avec réseaux connectés
2. Clé API (`sw_live_…`) depuis **Intégrations API**
3. Node.js 18+

## Installation

```bash
git clone git@github.com:RobinCouet/social-mcp.git
cd social-mcp
npm install
```

Ou via npm (une fois publié) :

```bash
npx -y @start-win/social-mcp
```

## Configuration Cursor / Claude Desktop

```json
{
  "mcpServers": {
    "social-start-win": {
      "command": "npx",
      "args": ["-y", "@start-win/social-mcp"],
      "env": {
        "SOCIAL_API_KEY": "sw_live_votre_cle",
        "SOCIAL_API_BASE": "https://social.start-win.fr"
      }
    }
  }
}
```

En local (clone du dépôt) :

```json
{
  "mcpServers": {
    "social-start-win": {
      "command": "node",
      "args": ["/chemin/vers/social-mcp/src/index.js"],
      "env": {
        "SOCIAL_API_KEY": "sw_live_votre_cle",
        "SOCIAL_API_BASE": "https://social.start-win.fr"
      }
    }
  }
}
```

## Outils disponibles

- `list_connected_networks`
- `publish_post`
- `schedule_post`
- `upload_media`
- `list_scheduled_posts` / `get_scheduled_post` / `cancel_scheduled_post`
- `get_post_history`
- `suggest_optimal_slots`

Documentation API : https://social.start-win.fr/api-docs