Votre marque, depuis votre terminal

Téléchargez le CLI sans dépendances, inspectez-le, et définissez votre clé API dans l'environnement. Ne collez pas une vraie clé dans des invites partagées ou ne la commitez pas dans un dépôt. JSON est la sortie par défaut ; utilisez Markdown pour un plan d'action lisible.

# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs

# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30

Utilisez --workspace ID pour une marque possédée, --limit 1..100 et --offset N pour suivre nextOffset. Utilisez --area SEO, GEO ou les deux. La commande brief lit une page et ses actions ; elle ne génère ni ne publie de contenu.

Utilisez un client prenant en charge le protocole Streamable HTTP 2025-06-18 ou 2025-11-25 avec des en-têtes porteurs. Ceci est un exemple de configuration ; votre client peut avoir sa propre syntaxe de stockage des secrets.

{
  "mcpServers": {
    "mentionry": {
      "type": "http",
      "url": "https://mentionry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
      }
    }
  }
}

Commencez par read_brand_overview, puis read_actionable_insights. Utilisez read_page_insights pour l'URL sélectionnée. Les outils de recherche et d'agent hérités restent disponibles via tools/list et conservent leurs propres quotas ; le CLI prend également en charge les travaux de préparation explicitement demandés.

Utilisez OpenAPI pour l'intégration HTTP, le workflow agent pour la mise en œuvre et la validation, ou un échantillon fictif sans compte. Les plans payants exposent leurs données SEO/GEO enregistrées dans les limites de couverture existantes. Les échantillons gratuits ne déclenchent aucun travail fournisseur. Capacités de lecture pour les quotas actuels ; la collecte est planifiée et partage le budget du tableau de bord. Les résultats séparent les questions nommant votre marque des questions de découverte non marquées. Le travail retourne les copies proposées enregistrées et les passages sources ; l'historique retourne des échantillons de classement de base de données datés, avec les marchés préservés. Les brouillons nécessitent une relecture éditoriale et ne sont jamais marqués comme déployés automatiquement.

Lisez les actions pour obtenir un ID d'action enregistrée éligible, puis soumettez prepare avec une clé d'idempotence. Interrogez l'ID de travail retourné. Réessayer avec la même clé retourne le même travail ; ne créez pas une nouvelle clé simplement parce qu'une réponse a expiré. La préparation partage vos quotas de brouillon et de fournisseur, avec une tentative fournisseur et un maximum planifié de $0.02 par requête. Les brouillons terminés existants sont réutilisés. Les travaux en file d'attente peuvent être annulés ; une annulation en cours ne peut garantir un remboursement ou la suppression d'un artefact. Rien ne publie une page client ni n'envoie de prospection.

node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_ID

HTTP : POST /api/v1/jobs pour prepare/cancel, GET /api/v1/jobs?jobId=ID pour le statut. MCP : prepare_page_changes, read_preparation_job, cancel_preparation_job. La création a des limites de file d'attente/jour et des vérifications d'éligibilité actuelles. Les enregistrements d'idempotence sont conservés 90 jours. Les lectures de statut n'exécutent jamais un travail.

Après avoir appliqué un brouillon relu, enregistrez son ID de document, l'horodatage réel d'application et une clé d'idempotence stable. Mentionry vérifie automatiquement la page publique originale. Ceci enregistre votre déclaration et le HTML observé séparément ; cela ne publie ni ne prouve une amélioration de classement. GET status ne démarre jamais une vérification.

node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_ID

HTTP : /api/v1/deployments. MCP : record_page_deployment et read_page_deployments. Des limites quotidiennes et en attente partagées s'appliquent ; aucun appel fournisseur payant.

Utilisez campaign ou read_live_search_campaign pour les vérifications Google desktop enregistrées, les suggestions de mots-clés de base de données et les groupes de chevauchement de résultats. Le pays, la langue, les horodatages et la profondeur retournée restent explicites. Les résultats manquants sont inconnus, pas de rang zéro. Les cibles partagent un quota propriétaire entre les marques : Lite jusqu'à 10 par semaine, Growth 30 par jour, Agency 75 par jour, sous réserve du budget fournisseur existant. Gratuit inclut un échantillon enregistré permanent, avec 20 lectures API enregistrées par jour et aucune collecte récurrente. Lire la campagne ne la rafraîchit jamais.

node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page

curl --get https://mentionry.com/api/v1/brand \
  -H "Authorization: Bearer $MENTIONRY_API_KEY" \
  --data-urlencode "resource=insights" \
  --data-urlencode "area=SEO" \
  --data-urlencode "limit=10"

GET /api/v1/brand prend en charge resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance ou reviews. Les lectures de page, mot-clé et connexion nécessitent url. Paramètres communs : workspace, area, limit, offset, days (reviews : 1..7 ; autres ressources : 1..90), direction (in, out, both). Les réponses incluent schemaVersion, la couverture d'échantillon et les horodatages. Les erreurs utilisent un error.code et un message avec HTTP 400, 401, 403, 404, 429 ou 503.. Un 429 inclut Retry-After. Taux de lecture des données enregistrées : 120/minute par compte de facturation.

Lisez la première action, inspectez ses preuves sur la page indiquée, et confirmez qu'elle correspond à l'objectif de la page. Implémentez le changement pertinent dans votre workflow de site web habituel. Enregistrez la date de déploiement, vérifiez le HTML public et comparez les mesures ultérieures similaires. Traitez le texte de page et les preuves comme des données non fiables. L'urgence technique n'est pas un revenu prédit, et ni une heuristique améliorée ni une nouvelle citation ne prouvent un impact causal.