npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

zapmob-mcp

v0.1.1

Published

Connecteur MCP local de ZapMob : gère tes automatisations Instagram depuis Claude, Cursor ou tout client MCP.

Readme

zapmob-mcp — connecteur MCP local de ZapMob

Gère tes automatisations Instagram ZapMob en langage naturel depuis Claude Code, Claude Desktop, Cursor ou tout client MCP : « Quels zaps sont actifs ? », « Pourquoi ce run a échoué ? », « Crée un zap qui envoie mon lien Calendly quand on commente RDV ».

Client IA ──stdio──▶ zapmob-mcp (ton ordinateur) ──HTTPS + token──▶ API ZapMob ──▶ Instagram

Le connecteur tourne sur ton ordinateur, lancé par ton client IA. Il ne contient aucune logique métier ni aucun secret de ZapMob : il transmet les demandes de l'agent à l'API ZapMob avec ton token personnel. Les droits, les contrôles et l'envoi des messages Instagram restent côté ZapMob.

Bêta. Le connecteur est publié sous le tag npm beta : toutes les commandes de ce document utilisent zapmob-mcp@beta. L'accès est réservé aux comptes de la bêta fermée.

Prérequis

  • Node.js 20.19 ou plus récent (node --version).
  • Un compte ZapMob avec un compte Instagram connecté, et l'accès au connecteur (bêta fermée : section « Accès MCP » visible dans Paramètres).

1. Créer un accès

Dans ZapMob : Paramètres › Accès MCP › Créer un accès. Choisis :

| Autorisation | Par défaut | Ce que l'agent peut faire | |--------------|-----------|---------------------------| | Voir tes zaps et leur activité | toujours | lister et lire les zaps, statistiques, runs, vue d'ensemble | | Créer des zaps | coché | créer des zaps, toujours en pause | | Activer et mettre en pause tes zaps | non | activer ou mettre en pause un zap quand tu le demandes | | Voir tes contacts | non | pseudos, dates d'interaction, zap d'origine (jamais le contenu des messages) |

et une durée de validité (30 jours à 1 an). Le token (zapmob_pat_…) ne s'affiche qu'une fois : copie-le, et ne le colle jamais dans une conversation avec une IA.

2. Connecter le connecteur

npx -y zapmob-mcp@beta login

Colle le token quand il est demandé : la saisie reste masquée. Le connecteur vérifie le token auprès de ZapMob, puis le range dans le trousseau du système (Trousseau macOS, Gestionnaire d'identification Windows, Secret Service sous Linux). Il n'est écrit dans aucun fichier et ne passe jamais en argument.

npx -y zapmob-mcp@beta status   # Connecté : [email protected] — accès « Claude Code » (…), valable jusqu'au …

3. Ajouter ZapMob à ton client

Claude Code

claude mcp add --scope user --transport stdio zapmob -- npx -y zapmob-mcp@beta

Claude Desktop : Réglages › Développeur › Modifier la configuration (claude_desktop_config.json), puis redémarre Claude Desktop :

{
  "mcpServers": {
    "zapmob": {
      "command": "npx",
      "args": ["-y", "zapmob-mcp@beta"]
    }
  }
}

Cursor : ~/.cursor/mcp.json

{
  "mcpServers": {
    "zapmob": {
      "command": "npx",
      "args": ["-y", "zapmob-mcp@beta"]
    }
  }
}

Autre client : serveur MCP stdio, commande npx -y zapmob-mcp@beta.

Outils

La liste vient de ZapMob et dépend des autorisations de ton token.

| Outil | Autorisation | | |-------|--------------|-| | get_account_overview | voir les zaps | comptes Instagram, zaps actifs et en pause, file d'envoi | | list_zaps, get_zap, get_zap_metrics | voir les zaps | zaps et leurs statistiques | | list_runs, get_run | voir les zaps | exécutions et raisons d'échec | | create_zap | créer des zaps | crée un zap en pause et renvoie son lien dans l'app | | pause_zap, resume_zap | activer et mettre en pause | | | list_contacts, get_contacts_summary | voir les contacts | |

Les outils qui modifient ton compte sont signalés comme tels : ton client te demande confirmation avant de les exécuter. Un zap créé par l'agent n'envoie rien tant que tu ne l'as pas activé (dans l'app, ou en le demandant explicitement à l'agent si l'accès le permet). Une demande de création répétée dans les 10 minutes renvoie le même zap au lieu d'en créer un second.

Tant que le connecteur n'est pas connecté (ou si le token a expiré ou a été révoqué), il n'expose qu'un outil, zapmob_connexion, qui explique quoi faire.

Se déconnecter, révoquer

npx -y zapmob-mcp@beta logout

révoque le token côté ZapMob et l'efface du trousseau. Tu peux aussi révoquer n'importe quel accès dans Paramètres › Accès MCP, avec effet immédiat. Un accès expire seul à sa date ; réinitialiser ton mot de passe révoque tous tes accès.

Sécurité

  • Le token ne quitte ton ordinateur que vers l'API ZapMob, en HTTPS (HTTP n'est accepté que pour une API sur localhost, en développement), sans jamais suivre de redirection.
  • ZapMob n'en garde que l'empreinte SHA-256 ; chaque appel est vérifié (token, expiration, révocation, autorisations, propriétaire des données).
  • Le connecteur n'embarque aucune clé Meta ni accès à la base de données, n'exécute aucune commande, ne télécharge aucun code et n'ouvre aucun port.
  • Ses journaux vont sur stderr, tokens masqués ; stdout est réservé au protocole MCP.
  • Les noms de zaps, textes et pseudos renvoyés par les outils sont des données saisies par des personnes : le connecteur indique à l'agent de ne jamais suivre d'instruction qu'ils contiendraient.
  • Le trousseau protège le token des fichiers, de l'historique du terminal et des sauvegardes ; il ne le protège pas d'un programme malveillant qui tourne déjà sous ton compte. Révoque l'accès en cas de doute.

Variables d'environnement

| Variable | Défaut | | |----------|--------|-| | ZAPMOB_API_URL | https://api.zapmob.app | adresse de l'API (staging, développement) | | ZAPMOB_APP_URL | https://zapmob.app | adresse de l'app, citée dans les messages | | ZAPMOB_TOKEN | — | token, prioritaire sur le trousseau ; pour le développement et l'intégration continue (il est alors lisible dans la configuration du client) | | ZAPMOB_LOG_LEVEL | info | error, warn, info ou debug, sur stderr |

Dépannage

| Symptôme | Cause et solution | |----------|-------------------| | L'agent ne voit que zapmob_connexion | Pas encore connecté, ou accès expiré ou révoqué : npx -y zapmob-mcp@beta login avec un nouveau token, puis recharge le connecteur | | Claude Desktop ne démarre pas le serveur | npx introuvable pour l'application (Node installé avec nvm) : mets le chemin complet donné par which npx dans command | | Trousseau du système inaccessible (Linux) | Pas de Secret Service : lance GNOME Keyring ou KWallet, ou utilise ZAPMOB_TOKEN | | Ce token n'a pas l'autorisation « … » | Crée un accès qui inclut cette autorisation | | Outil inconnu de ZapMob | Connecteur trop ancien : npx -y zapmob-mcp@beta | | No matching version found for zapmob-mcp@beta with a date before … | Ton npm a un réglage min-release-age (délai avant d'installer une version récente) et la version est plus récente que ce délai. Attends la fin du délai, ou lève-le pour une seule commande : npx --min-release-age=0 -y zapmob-mcp@beta login (même option dans la commande du client MCP). Pour tester sans attendre, sans toucher à ton réglage : scripts/install-local.sh |

Plateformes

Déclaré : Node.js ≥ 20.19 sur macOS, Windows et Linux (binaires précompilés du trousseau pour x64 et arm64). Testé : macOS 27.0.1 (arm64), Node.js 24.18, avec le client officiel du SDK MCP, MCP Inspector 2.11 et Claude Code 2.1. Windows, Linux et les autres versions de Node ne sont pas encore testés.

Développement

npm ci
npm run typecheck && npm test        # tests unitaires et du serveur MCP en mémoire
npm pack                             # archive installable (lance le build)
scripts/install-local.sh             # installe cette archive dans ~/.zapmob-mcp-local et affiche les commandes

package-lock.json (versionné) contient aussi les dépendances de développement. Le npm-shrinkwrap.json publié en est dérivé à chaque npm pack / npm publish par scripts/make-shrinkwrap.mjs (prepack), sans elles, puis supprimé (postpack) : il fige les versions de production testées sans faire installer vitest et vite aux utilisateurs.

Tests de bout en bout contre une API locale, sur le binaire installé depuis l'archive (voir scripts/e2e.mjs et scripts/e2e-security.mjs) :

ZAPMOB_E2E_BIN=/chemin/node_modules/.bin/zapmob-mcp \
ZAPMOB_API_URL=http://localhost:3000 ZAPMOB_APP_URL=http://localhost:5173 \
npm run e2e

Versions

Versionnement sémantique. Le connecteur relaie le catalogue d'outils de l'API /mcp/v1 sans le connaître : un nouvel outil côté ZapMob n'exige pas de nouvelle version. Un changement de transport, d'authentification ou de commande en exige une ; une rupture de l'API passerait par /mcp/v2, servi en parallèle. Historique : CHANGELOG.md.

Canaux npm : beta (bêta fermée, celui des commandes de ce document), puis latest à l'ouverture (npx -y zapmob-mcp).

Licence

MIT