Intégrations & automatisations

Tu peux générer, auditer et publier des articles sans ouvrir le dashboard depuis :

• Claude Desktop / Claude Code / Cursor via notre serveur MCP (Model Context Protocol)
• n8n via notre node communautaire officiel
• Zapier / Make / GitHub Actions / scripts maison via l'API REST

Les trois utilisent le même token btb_xxx (Account → API keys) et consomment les mêmes quotas que le dashboard.

Comparatif rapide

1. MCP server (Claude Desktop, Cursor, etc.)

Model Context Protocol est le standard ouvert d'Anthropic pour donner des outils à un LLM. Notre serveur MCP expose 10 tools :

Installation Claude Desktop

Édite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

{
  "mcpServers": {
    "gridar": {
      "command": "npx",
      "args": ["-y", "@gridar/mcp-server"],
      "env": {
        "BLOG_DASHBOARD_TOKEN": "btb_ton_token_ici"
      }
    }
  }
}

Redémarre Claude Desktop. Demande lui : "liste mes sites Gridar" → tu vois gridar_list_sites se déclencher.

Installation Claude Code

claude mcp add gridar \
  --env BLOG_DASHBOARD_TOKEN=btb_ton_token \
  -- npx -y @gridar/mcp-server

Installation Cursor

Édite ~/.cursor/mcp.json avec la même config que Claude Desktop ci-dessus.

Exemple de conversation

Toi : Génère un article guide sur "meilleur CRM pour PME québécoises" pour le site 12, en français, 1500 mots, avec une FAQ.

Claude : (appelle gridar_get_brief pour récupérer un plan, puis gridar_generate_article)

Article généré ! Score SEO : 87/100. Quota restant ce mois : 47/60.

Code source + détails : github.com/TokDar2410621/blog-dashboard/tree/main/mcp-server.

2. n8n node communautaire

Pour les workflows visuels récurrents (planification, branchements, multi-étapes).

Installation

n8n self-hosted → Settings → Community Nodes → Install :

n8n-nodes-gridar

Ou via npm :

cd ~/.n8n/custom
npm install n8n-nodes-gridar

Redémarre n8n.

n8n Cloud ne supporte pas encore les nodes communautaires. Utilise le node HTTP Request avec notre API REST en attendant.

Configuration credentials

1. Dans Gridar : Account → API keys → crée un token.
2. Dans n8n : Credentials → New → Gridar API → colle le token. Le bouton "Test" hit /me/ pour valider.

Ressources et opérations

Workflow type : article hebdomadaire automatique

Schedule (lundi 8h)
  ↓
Gridar (Article: Generate)
  site_id: 12
  topic: "Tendances SEO Québec {{ $now.format('MMMM yyyy') }}"
  type: news
  length: medium
  language: fr
  ↓
Slack (notifie l'équipe avec l'URL retournée)

Workflow type : audit à la volée

Webhook (POST /audit-incoming)
  ↓
Gridar (Audit: Run)
  title: {{ $json.title }}
  content: {{ $json.content }}
  ↓
IF (score < 70)
  → Email "Article à revoir avant publication"

Workflow type : tracking quotidien des positions

Schedule (tous les jours 6h)
  ↓
Gridar (Keyword: Snapshot)
  site_id: 12
  ↓
Gridar (Keyword: List)
  site_id: 12
  ↓
Google Sheets (append rows : keyword, position, date)

Code source + détails : github.com/TokDar2410621/blog-dashboard/tree/main/n8n-node.

3. API REST directe

Pour tout le reste (Zapier, Make, scripts Python/Node, GitHub Actions, etc.) : voir API REST publique.

Quotas

Les trois intégrations consomment ton plan normal. generate = 1 article du quota mensuel (ou 1 crédit si quota épuisé). Les autres endpoints sont gratuits côté quota mais limités par le rate-limit horaire :

Free et Solo n'ont pas accès aux intégrations (créer un token nécessite Pro+).

Sécurité

• Le token est privé, traite-le comme un mot de passe.
• Ne le commit jamais dans Git. Utilise les secrets de n8n / GitHub Actions / ton hébergeur.
• Tu peux révoquer un token à tout moment depuis Account → API keys sans affecter les autres.
• Génère un token par intégration (n8n-prod, claude-desktop-laptop, gh-actions-blog) pour pouvoir révoquer chirurgicalement.

Support

• Bug ou question : GitHub Issues
• Suggestions de tools/ops à ajouter : ouvre une issue, on est preneurs