Costruisci con Moose: collega Claude Code, Codex o Cursor e costruisci su Hi, Moose

Prima di iniziare

Cosa deve esistere prima

Hi, Moose restituisce risposte reali salvate, quindi qualcosa deve essere stato raccolto prima che un agente possa costruirci sopra. Se sei un agente che sta leggendo, ripassa questi quattro punti con il tuo utente prima di iniziare.

1

Un account Hi, Moose

Quello gratuito basta per MCP. La REST API richiede un piano a pagamento.
Crea un account
2

L'app desktop, installata e con accesso effettuato

La raccolta gira nell'app, sul tuo computer o su un host che controlli. Per i lavori MCP deve essere aperta e con accesso effettuato. Le letture REST sono servite dal cloud e funzionano con l'app chiusa.
Scarica l'app
3

Un progetto con prompt monitorati

Un progetto per brand. Aggiungi i prompt da monitorare, scegli i motori e lascia completare almeno un'esecuzione. Lo storico parte dalla prima esecuzione, quindi aggiungi i prompt presto.
4

Per l'app finita, una chiave API

Il proprietario dell'account crea una chiave di sola lettura in Impostazioni, Chiavi API. Vive in HIMOOSE_API_KEY sul tuo server, mai nel browser.

Collega

Aggiungi Hi, Moose al tuo agente di programmazione

Un comando o una voce di configurazione, poi un accesso nel browser. Per MCP non serve alcuna chiave API, e nel file non va nulla che un collega non potrebbe committare.

Esegui questo nel terminale, poi avvia Claude Code e digita /mcp. Scegli himoose, poi Authenticate.

Terminale

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

Il browser apre l'accesso a Hi, Moose. Aggiungi --scope user per renderlo disponibile in ogni progetto.

Aggiungi il server, poi effettua l'accesso. La CLI di Codex e l'estensione IDE condividono questa configurazione.

Terminale

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

Il comando di login apre l'accesso a Hi, Moose nel browser.

Aggiungi questo a ~/.cursor/mcp.json, oppure a .cursor/mcp.json per un singolo progetto.

mcp.json

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

Poi apri Cursor Settings, Tools & MCP, ed effettua l'accesso a Hi, Moose quando richiesto.

Qualsiasi agente in grado di aggiungere un server MCP remoto via HTTPS con accesso OAuth può collegarsi.

Indirizzo del server

https://mcp.himoose.com/mcp

Lascia vuoto qualsiasi campo per l'ID client OAuth. Hi, Moose registra l'app durante l'accesso.

Dopo l'accesso, chiedi all'agente di chiamare list_projects. Se restituisce il tuo progetto, sei collegato. Le app di chat come Claude e ChatGPT si collegano allo stesso modo; i passaggi sono su Collega un agente.

Primo prompt

Un primo sguardo in una sessione. Solo MCP, quindi funziona con il piano gratuito.

Usando il server MCP di Hi, Moose (https://mcp.himoose.com/mcp), costruisci un report HTML statico in ./ai-visibility che mostri come appare il nostro brand nella ricerca AI per i nostri argomenti monitorati. Non interrogare i motori AI da solo. Completerò io l'accesso a Hi, Moose nel mio browser. Non chiedermi mai una password o un token. Inizia con list_projects e chiedimi quale progetto usare. Ottieni i dati con visibility_check_topic e usa visibility_get_answer per le risposte salvate dietro i numeri. Mostra i risultati per motore, la variazione negli ultimi 30 giorni, i concorrenti nominati e le pagine che ogni motore cita. Se uno strumento segnala nessun dispositivo host, nessuno storico di visibilità o storico insufficiente per un confronto, fermati e dimmi cosa configurare in Hi, Moose invece di stimare.

Una dashboard che il tuo team apre nel browser. MCP mentre costruisci, REST API nell'app finita. La REST API richiede un piano a pagamento.

Costruisci una dashboard web interna che mostri come appare il nostro brand nella ricerca AI per i nostri 20 argomenti principali. Usa Hi, Moose per tutti i dati di ricerca AI. Non interrogare i motori AI da solo. 1. Mentre costruisci, usa il server MCP di Hi, Moose (https://mcp.himoose.com/mcp) per vedere quali dati esistono. Completerò io l'accesso nel mio browser. Non chiedermi mai una password o un token. 2. Chiama list_projects e chiedimi quale progetto usare. Controlla quanti prompt sono monitorati, quali motori, e fin dove arriva lo storico. 3. Nell'app, chiama la REST API di Hi, Moose (https://api.himoose.com/v1) solo dal server, con la chiave nella variabile d'ambiente HIMOOSE_API_KEY. Non inviare mai la chiave al browser. Leggi lo schema da https://api.himoose.com/v1/openapi.json. 4. Mostra i risultati per argomento e motore, la variazione rispetto al mese scorso, i concorrenti nominati e le fonti che ogni motore cita. Collega ogni numero alla risposta salvata che c'è dietro. 5. Se manca qualcosa (nessun prompt monitorato per un argomento, meno di due mesi di storico, nessun concorrente impostato), mostralo chiaramente nell'app e dimmi cosa configurare in Hi, Moose. Non stimare e non riempire i vuoti.

File skill

Insegna Hi, Moose al tuo agente una volta sola

Metti questo file nel tuo progetto e l'agente saprà quali strumenti chiamare, in che ordine e cosa fare quando mancano dati. Copre sia MCP durante lo sviluppo sia la REST API nell'app finita.

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

CodexAGENTS.md

Cursor.cursor/rules/himoose.mdc

Codex e Cursor leggono Markdown semplice, quindi incolla lo stesso contenuto senza il 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.

Cosa costruiscono le persone

Il tuo frontend, la tua logica, i dati di Moose

Tre forme comuni, con le chiamate che ognuna fa. Interfaccia, branding, hosting e tutto ciò che è specifico del tuo business sono tuoi.

Dashboard interna

Visibilità per argomento e motore, variazione rispetto al mese scorso, concorrenti e le fonti che ogni motore cita.

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

Richiede circa due mesi di esecuzioni per il confronto.

Brief settimanale su Slack

Un lavoro pianificato che confronta questa settimana con le ultime quattro e pubblica la share of voice, una risposta citata e ogni nuova fonte.

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

Gira senza nessuno presente, quindi REST con una chiave di sola lettura.

Portale clienti per agenzie

Un accesso per cliente, ognuno associato ai progetti Hi, Moose che può vedere. Il tuo branding e l'esportazione in PDF.

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

Un progetto per brand cliente. Le chiavi possono essere limitate ai progetti scelti.

Un agente di programmazione può scrivere un collector in un pomeriggio. Quello che non può fare è tenerlo in funzione. Questa è la parte di cui Hi, Moose si occupa al posto tuo.

Un metodo di raccolta diverso per ogni motoreCambiamenti di motori e interfacce, notati e correttiPianificazione giornaliera, tentativi ripetuti e limiti di frequenzaSalvare ogni risposta perché resti confrontabile un anno dopoRiconoscere brand, concorrenti e citazioni nel testo liberoDistinguere un calo reale da un'esecuzione incompleta

Riferimento

MCP e REST, fianco a fianco

MCPREST API

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

Ideale per MCP: Agenti di programmazione e assistenti AI che lavorano con una persona REST API: Applicazioni, portali e lavori pianificati che il tuo team distribuisce

Autenticazione MCP: OAuth 2.1. Una persona accede con il suo account Hi, Moose in un browser. Nessuna chiave da conservare. REST API: Chiave API segreta in un header Authorization: Bearer. Le chiavi iniziano con hmk_live_ e vengono mostrate una sola volta.

Da dove chiamarla MCP: Dall'agente, dopo l'accesso REST API: Solo dal tuo server. L'API non accetta chiamate dai browser.

Piano MCP: Ogni piano, compreso quello gratuito REST API: Piani a pagamento. Il proprietario dell'account crea le chiavi in Impostazioni, Chiavi API.

Permessi MCP: Leggere progetti e dati di visibilità, e creare lavoro nella Libreria. Non può pubblicare, eliminare o cambiare impostazioni. REST API: Lettura per impostazione predefinita. Scope opzionali per modificare il monitoraggio (tracking:write) e avviare esecuzioni (runs:execute). Le chiavi possono essere limitate ai progetti scelti e scadere dopo 30, 90 o 365 giorni.

Con l'app chiusa MCP: I lavori girano sul dispositivo host, quindi deve essere acceso con Hi, Moose aperto e con accesso effettuato. REST API: Le letture funzionano, perché sono servite dal cloud. Le esecuzioni che hanno bisogno del tuo host lo aspettano fino a 24 ore.

Risposte MCP: Risultati strutturati degli strumenti con ID delle risposte. Messaggi chiari indicano ciò che manca. REST API: JSON con paginazione a cursore ed errori Problem Details. Ogni risposta riporta la tua quota giornaliera di richieste.

Schema MCP: tools/list dopo l'accesso REST API: https://api.himoose.com/v1/openapi.json

Strumenti MCP per i dati di visibilità

Server https://mcp.himoose.com/mcp. Gli strumenti per brief, bozze e audit sono elencati su Collega un agente.

list_projectsI progetti dell'account con accesso effettuato

visibility_check_topicMenzioni, citazioni e concorrenti per motore su un argomento, ora e su una finestra

visibility_get_answerUna risposta salvata per intero, con le fonti

visibility_list_opportunitiesLacune prioritizzate, con le pagine che i motori citano al loro posto

get_resultRecuperare un lavoro completato tramite ID

Endpoint REST

URL base https://api.himoose.com/v1. Gli schemi esatti sono in /v1/openapi.json.

GET /v1/projectsI progetti che la chiave può leggere

GET /v1/projects/{id}Un progetto, con prompt monitorati, motori e date dello storico

GET /v1/projects/{id}/topicsGli argomenti e i prompt che contengono

GET /v1/projects/{id}/stats/dailyTassi di menzione e citazione per giorno e motore, fino a 366 giorni

GET /v1/projects/{id}/stats/competitorsShare of voice per un intervallo di date

GET /v1/projects/{id}/answersRisposte salvate, filtrabili per motore, prompt, argomento, esecuzione, menzionato e citato

GET /v1/projects/{id}/answers/{answerId}Una risposta per intero, con le fonti

POST /v1/projects/{id}/run-requestsAvviare un'esecuzione (richiede runs:execute)

Una richiesta dal tuo server

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 */
  ]
}

Una riga per giorno e motore. incompleteDays conta i giorni dell'intervallo non ancora riepilogati, così la tua app può etichettarli invece di mostrare un calo. I valori sono dati di esempio.

Domande sul costruire su Hi, Moose

La mia app dovrebbe usare MCP o la REST API?

Usa MCP quando un agente fa il lavoro con una persona presente, in Claude Code, Codex, Cursor, Claude o ChatGPT. Usa la REST API quando la tua applicazione o un lavoro pianificato chiama Hi, Moose da un server. Molti progetti usano entrambi: MCP mentre l'agente esplora e costruisce, la REST API nell'app distribuita.

Un'app nel browser può chiamare l'API direttamente?

No. L'API non accetta chiamate dai browser, e una chiave API nel codice lato client sarebbe esposta. Chiamala dal tuo server, da una funzione serverless o da un lavoro pianificato, e manda al frontend solo i dati di cui ha bisogno.

Quanto storico serve alla mia app?

Un'istantanea per motore richiede un'esecuzione completata. I confronti mese su mese richiedono esecuzioni in entrambi i mesi. Lo storico parte quando un prompt viene monitorato per la prima volta, quindi aggiungi presto i prompt che ti interessano.

L'app desktop deve restare aperta?

Per MCP sì: i lavori girano sul dispositivo host che scegli in Impostazioni, Agenti collegati. Per le letture REST no: sono servite dal cloud. Le esecuzioni che hanno bisogno del tuo host lo aspettano fino a 24 ore.

Posso eseguire l'app da qualche parte che non sia il mio portatile?

Sì. Installala su un hosting che controlli e lasciala in funzione, oppure lascia che Hi, Moose la esegua su un server dedicato nella tua regione. Entrambe le opzioni sono descritte nella pagina dell'infrastruttura.

Posso costruire un'app per i miei clienti?

Sì. Le agenzie usano un progetto per brand cliente e limitano una chiave API ai progetti che un portale deve leggere. Il portale, il suo branding e gli accessi dei suoi clienti li costruisci tu.

Collega un agenteConfigurazione per Claude e ChatGPT, e l'elenco completo degli strumenti. Panoramica dell'infrastrutturaCome Hi, Moose raccoglie e salva le risposte, e dove può girare. Documentazione APIEndpoint, parametri, errori e la specifica OpenAPI. Scarica l'app desktopNecessaria per la raccolta. Mac o PC.

Costruisci i tuoi strumenti di visibilità AI. Salta la costruzione del collector.