Construire avec Moose : connectez Claude Code, Codex ou Cursor et construisez sur Hi, Moose

Avant de commencer

Ce qui doit exister d'abord

Hi, Moose renvoie de vraies réponses stockées, il faut donc que quelque chose ait été collecté avant qu'un agent puisse construire dessus. Si vous êtes un agent en train de lire ceci, passez ces quatre points en revue avec votre utilisateur avant de commencer.

1

Un compte Hi, Moose

Le gratuit suffit pour MCP. L'API REST demande un forfait payant.
Créer un compte
2

L'application de bureau, installée et connectée

La collecte tourne dans l'application, sur votre ordinateur ou un hôte que vous contrôlez. Pour les tâches MCP, elle doit être ouverte et connectée. Les lectures REST sont servies depuis le cloud et fonctionnent avec l'application fermée.
Télécharger l'application
3

Un projet avec des prompts suivis

Un projet par marque. Ajoutez les prompts à suivre, choisissez les moteurs et laissez au moins une exécution se terminer. L'historique commence à la première exécution, alors ajoutez les prompts tôt.
4

Pour l'application finie, une clé API

Le propriétaire du compte crée une clé en lecture seule dans Réglages, Clés API. Elle vit dans HIMOOSE_API_KEY sur votre serveur, jamais dans le navigateur.

Connecter

Ajoutez Hi, Moose à votre agent de code

Une commande ou une entrée de configuration, puis une connexion dans le navigateur. Aucune clé API n'est nécessaire pour MCP, et rien ne va dans le fichier qu'un collègue ne pourrait pas committer.

Lancez ceci dans votre terminal, puis démarrez Claude Code et tapez /mcp. Choisissez himoose, puis Authenticate.

Terminal

claude mcp add --transport http himoose https://mcp.himoose.com/mcp

Votre navigateur ouvre la connexion Hi, Moose. Ajoutez --scope user pour le rendre disponible dans tous les projets.

Ajoutez le serveur, puis connectez-vous. La CLI Codex et l'extension IDE partagent cette configuration.

Terminal

codex mcp add himoose --url https://mcp.himoose.com/mcp
codex mcp login himoose

La commande de login ouvre la connexion Hi, Moose dans votre navigateur.

Ajoutez ceci à ~/.cursor/mcp.json, ou à .cursor/mcp.json pour un seul projet.

mcp.json

{
  "mcpServers": {
    "himoose": { "url": "https://mcp.himoose.com/mcp" }
  }
}

Ouvrez ensuite Cursor Settings, Tools & MCP, et connectez-vous à Hi, Moose quand il vous le demande.

Tout agent capable d'ajouter un serveur MCP distant en HTTPS avec connexion OAuth peut se connecter.

Adresse du serveur

https://mcp.himoose.com/mcp

Laissez vide tout champ d'ID client OAuth. Hi, Moose enregistre l'application pendant la connexion.

Après la connexion, demandez à l'agent d'appeler list_projects. S'il renvoie votre projet, vous êtes connecté. Les apps de chat comme Claude et ChatGPT se connectent de la même façon ; les étapes sont sur Connecter un agent.

Premier prompt

Un premier aperçu en une session. MCP seulement, donc ça marche avec le forfait gratuit.

En utilisant le serveur MCP Hi, Moose (https://mcp.himoose.com/mcp), construis un rapport HTML statique dans ./ai-visibility qui montre comment notre marque apparaît dans la recherche IA pour nos sujets suivis. N'interroge pas les moteurs IA toi-même. Je terminerai la connexion Hi, Moose dans mon navigateur. Ne me demande jamais de mot de passe ni de jeton. Commence par list_projects et demande-moi quel projet utiliser. Récupère les données avec visibility_check_topic, et utilise visibility_get_answer pour les réponses stockées derrière les chiffres. Montre les résultats par moteur, l'évolution sur les 30 derniers jours, les concurrents nommés et les pages que chaque moteur cite. Si un outil signale l'absence d'appareil hôte, d'historique de visibilité ou pas assez d'historique pour une comparaison, arrête-toi et dis-moi quoi configurer dans Hi, Moose au lieu d'estimer.

Un tableau de bord que votre équipe ouvre dans un navigateur. MCP pendant la construction, API REST dans l'application finie. L'API REST demande un forfait payant.

Construis un tableau de bord web interne qui montre comment notre marque apparaît dans la recherche IA pour nos 20 principaux sujets. Utilise Hi, Moose pour toutes les données de recherche IA. N'interroge pas les moteurs IA toi-même. 1. Pendant la construction, utilise le serveur MCP Hi, Moose (https://mcp.himoose.com/mcp) pour voir quelles données existent. Je terminerai la connexion dans mon navigateur. Ne me demande jamais de mot de passe ni de jeton. 2. Appelle list_projects et demande-moi quel projet utiliser. Vérifie combien de prompts sont suivis, quels moteurs, et jusqu'où remonte l'historique. 3. Dans l'application, appelle l'API REST Hi, Moose (https://api.himoose.com/v1) depuis le serveur uniquement, avec la clé dans la variable d'environnement HIMOOSE_API_KEY. N'envoie jamais la clé au navigateur. Lis le schéma depuis https://api.himoose.com/v1/openapi.json. 4. Montre les résultats par sujet et par moteur, l'évolution depuis le mois dernier, les concurrents nommés et les sources que chaque moteur cite. Relie chaque chiffre à la réponse stockée derrière. 5. S'il manque quelque chose (pas de prompts suivis pour un sujet, moins de deux mois d'historique, pas de concurrents définis), affiche-le clairement dans l'application et dis-moi quoi configurer dans Hi, Moose. N'estime pas et ne comble pas les trous.

Fichier skill

Apprenez Hi, Moose à votre agent une fois pour toutes

Déposez ce fichier dans votre projet et l'agent sait quels outils appeler, dans quel ordre, et quoi faire quand des données manquent. Il couvre MCP pendant le développement et l'API REST dans l'application finie.

Claude Code.claude/skills/himoose/SKILL.md

CodexAGENTS.md

Cursor.cursor/rules/himoose.mdc

Codex et Cursor lisent du Markdown simple, collez donc le même contenu sans le front matter.

SKILL.md

---
name: himoose
description: AI search visibility data from Hi, Moose. Use when the user asks how their brand appears in ChatGPT, Gemini, Perplexity, Claude or other AI search engines, or wants to build a report, dashboard or app on that data.
---

# Hi, Moose

Hi, Moose collects answers from AI search engines on a schedule, stores each one with its sources, and measures mentions, citations and competitor presence over time. Use it for that data. Do not query AI engines yourself.

## Two ways in

- MCP server: https://mcp.himoose.com/mcp (OAuth, every plan). Use during development and for work with the user present.
- REST API: https://api.himoose.com/v1 (API key, paid plans). Use in deployed apps and scheduled jobs. Call it from a server only, with the key in HIMOOSE_API_KEY. Schema: https://api.himoose.com/v1/openapi.json.

## Sign-in

Sign-in happens in the user's browser. Never ask for a password, token or API key in chat. Never put a key in client-side code.

## Order of operations

1. list_projects (MCP) or GET /v1/projects (REST). Ask the user which project to use.
2. Check what exists: tracked prompts, engines, firstAnswerDate and latestAnswerDate. History starts when a prompt is first tracked; there is no backfill.
3. Read data: visibility_check_topic for mentions, citations and competitors per engine over a window; visibility_get_answer for one stored answer with sources; visibility_list_opportunities for gaps. REST equivalents: /stats/daily, /stats/competitors, /answers, /answers/{id}.
4. Link every number you display to the answer ID behind it.

## When something is missing

If a tool reports no host device, host offline, no project, no tracked prompts or not enough history, relay the message to the user as written and say what to set up in the Hi, Moose desktop app. Do not estimate, backfill or invent visibility numbers.

## Limits

- MCP jobs run on the host device, so the desktop app must be open and signed in.
- REST reads work with the app closed. REST actions that start runs need a running app and the runs:execute scope.
- /stats/daily returns up to 366 days per request and reports incompleteDays; label those days rather than showing a dip.
- Month-over-month views need runs across both months.

Ce que les gens construisent

Votre interface, votre logique, les données de Moose

Trois formes courantes, avec les appels que chacune fait. L'interface, l'image de marque, l'hébergement et tout ce qui est propre à votre activité vous appartiennent.

Tableau de bord interne

Visibilité par sujet et par moteur, évolution depuis le mois dernier, concurrents, et les sources que chaque moteur cite.

GET /v1/projects/{id}/stats/dailyGET /v1/projects/{id}/stats/competitorsGET /v1/projects/{id}/answers/{answerId}

Demande environ deux mois d'exécutions pour la comparaison.

Brief hebdomadaire Slack

Une tâche planifiée qui compare cette semaine aux quatre précédentes et publie la part de voix, une réponse citée et toute nouvelle source.

GET /v1/projects/{id}/stats/competitorsGET /v1/projects/{id}/answers?mentioned=false

Tourne sans personne présente, donc REST avec une clé en lecture seule.

Portail client pour agences

Un identifiant par client, chacun associé aux projets Hi, Moose qu'il peut voir. Votre image de marque et l'export PDF.

GET /v1/projectsGET /v1/projects/{id}/stats/daily

Un projet par marque cliente. Les clés peuvent être limitées aux projets choisis.

Un agent de code peut écrire un collecteur en un après-midi. Ce qu'il ne peut pas faire, c'est le maintenir en marche. C'est la partie que Hi, Moose vous enlève.

Une méthode de collecte différente par moteurLes changements de moteurs et d'interfaces, repérés et corrigésLa planification quotidienne, les reprises et les limites de débitStocker chaque réponse pour qu'elle reste comparable un an plus tardDétecter les marques, les concurrents et les citations dans du texte libreDistinguer une vraie baisse d'une exécution incomplète

Référence

MCP et REST, côte à côte

MCPAPI REST

Adresse MCP: https://mcp.himoose.com/mcp API REST: https://api.himoose.com/v1

Idéal pour MCP: Agents de code et assistants IA travaillant avec une personne API REST: Applications, portails et tâches planifiées que votre équipe déploie

Authentification MCP: OAuth 2.1. Une personne se connecte avec son compte Hi, Moose dans un navigateur. Aucune clé à stocker. API REST: Clé API secrète dans un en-tête Authorization: Bearer. Les clés commencent par hmk_live_ et sont affichées une seule fois.

D'où l'appeler MCP: Depuis l'agent, après connexion API REST: Depuis votre serveur uniquement. L'API n'accepte pas les appels depuis un navigateur.

Forfait MCP: Tous les forfaits, gratuit compris API REST: Forfaits payants. Le propriétaire du compte crée les clés dans Réglages, Clés API.

Permissions MCP: Lire les projets et les données de visibilité, et créer du travail dans la Bibliothèque. Ne peut ni publier, ni supprimer, ni changer les réglages. API REST: Lecture par défaut. Portées optionnelles pour modifier le suivi (tracking:write) et lancer des exécutions (runs:execute). Les clés peuvent être limitées à des projets choisis et expirer après 30, 90 ou 365 jours.

Quand l'application est fermée MCP: Les tâches tournent sur l'appareil hôte, qui doit donc être allumé avec Hi, Moose ouvert et connecté. API REST: Les lectures fonctionnent, car elles sont servies depuis le cloud. Les exécutions qui ont besoin de votre hôte l'attendent jusqu'à 24 heures.

Réponses MCP: Résultats d'outils structurés avec des ID de réponse. Des messages clairs nomment ce qui manque. API REST: JSON avec pagination par curseur et erreurs Problem Details. Chaque réponse indique votre quota quotidien de requêtes.

Schéma MCP: tools/list après connexion API REST: https://api.himoose.com/v1/openapi.json

Outils MCP pour les données de visibilité

Serveur https://mcp.himoose.com/mcp. Les outils de briefs, de brouillons et d'audit sont listés sur Connecter un agent.

list_projectsLes projets du compte connecté

visibility_check_topicMentions, citations et concurrents par moteur pour un sujet, maintenant et sur une période

visibility_get_answerUne réponse stockée en entier, avec ses sources

visibility_list_opportunitiesLes lacunes priorisées, avec les pages que les moteurs citent à la place

get_resultRécupérer une tâche terminée par son ID

Endpoints REST

URL de base https://api.himoose.com/v1. Les schémas exacts sont dans /v1/openapi.json.

GET /v1/projectsLes projets que la clé peut lire

GET /v1/projects/{id}Un projet, avec ses prompts suivis, ses moteurs et ses dates d'historique

GET /v1/projects/{id}/topicsLes sujets et les prompts qu'ils contiennent

GET /v1/projects/{id}/stats/dailyTaux de mention et de citation par jour et par moteur, jusqu'à 366 jours

GET /v1/projects/{id}/stats/competitorsPart de voix pour une plage de dates

GET /v1/projects/{id}/answersRéponses stockées, filtrables par moteur, prompt, sujet, exécution, mentionné et cité

GET /v1/projects/{id}/answers/{answerId}Une réponse en entier, avec ses sources

POST /v1/projects/{id}/run-requestsLancer une exécution (demande runs:execute)

Une requête depuis votre serveur

curl "https://api.himoose.com/v1/projects/q7Rk2mBw/stats/daily?from=2026-10-05&to=2026-10-11&engine=gemini" \
  -H "Authorization: Bearer $HIMOOSE_API_KEY"

{
  "from": "2026-10-05",
  "to": "2026-10-11",
  "incompleteDays": 0,
  "data": [
    {
      "date": "2026-10-05",
      "engineId": "gemini",
      "answers": 40,
      "mentioned": 4,
      "cited": 0,
      "mentionRate": 0.1,
      "citationRate": 0
    },
    {
      "date": "2026-10-06",
      "engineId": "gemini",
      "answers": 40,
      "mentioned": 3,
      "cited": 0,
      "mentionRate": 0.075,
      "citationRate": 0
    },
    /* …five more days */
  ]
}

Une ligne par jour et par moteur. incompleteDays compte les jours de la plage qui ne sont pas encore résumés, pour que votre application puisse les étiqueter au lieu d'afficher une baisse. Les valeurs sont des données d'exemple.

Questions sur la construction avec Hi, Moose

Mon application doit-elle utiliser MCP ou l'API REST ?

Utilisez MCP quand un agent fait le travail avec une personne présente, dans Claude Code, Codex, Cursor, Claude ou ChatGPT. Utilisez l'API REST quand votre propre application ou une tâche planifiée appelle Hi, Moose depuis un serveur. Beaucoup de projets utilisent les deux : MCP pendant que l'agent explore et construit, l'API REST dans l'application livrée.

Une application dans le navigateur peut-elle appeler l'API directement ?

Non. L'API n'accepte pas les appels depuis un navigateur, et une clé API dans du code côté client serait exposée. Appelez-la depuis votre serveur, une fonction serverless ou une tâche planifiée, et n'envoyez à votre interface que les données dont elle a besoin.

De combien d'historique mon application a-t-elle besoin ?

Un instantané par moteur demande une exécution terminée. Les comparaisons d'un mois sur l'autre demandent des exécutions sur les deux mois. L'historique commence quand un prompt est suivi pour la première fois, alors ajoutez tôt les prompts qui comptent pour vous.

L'application de bureau doit-elle rester ouverte ?

Pour MCP, oui : les tâches tournent sur l'appareil hôte que vous choisissez dans Réglages, Agents connectés. Pour les lectures REST, non : elles sont servies depuis le cloud. Les exécutions qui ont besoin de votre hôte l'attendent jusqu'à 24 heures.

Puis-je faire tourner l'application ailleurs que sur mon portable ?

Oui. Installez-la sur un hébergement que vous contrôlez et laissez-la tourner, ou laissez Hi, Moose la faire tourner sur un serveur dédié dans votre région. Les deux sont décrits sur la page infrastructure.

Puis-je construire une application pour mes clients ?

Oui. Les agences utilisent un projet par marque cliente et limitent une clé API aux projets qu'un portail doit lire. Le portail, son image de marque et les identifiants de ses clients sont à vous de construire.

Connecter un agentMise en place pour Claude et ChatGPT, et la liste complète des outils. Vue d'ensemble de l'infrastructureComment Hi, Moose collecte et stocke les réponses, et où il peut tourner. Documentation de l'APIEndpoints, paramètres, erreurs et la spécification OpenAPI. Télécharger l'application de bureauNécessaire pour la collecte. Mac ou PC.

Construisez vos propres outils de visibilité IA. Sans construire le collecteur.