Bauen Sie Ihre eigenen AI-Sichtbarkeitswerkzeuge. Den Collector müssen Sie nicht bauen.

Hi, Moose fragt die AI-Suchmaschinen jeden Tag, speichert jede Antwort mit ihren Quellen und misst Erwähnungen, Zitate und Wettbewerber. Verbinden Sie Claude Code, Codex oder Cursor über MCP und lassen Sie Ihren Agenten auf diesen Daten aufbauen, oder rufen Sie die REST API aus der App auf, die Sie ausliefern.

Coding-Agenten verbinden API- und Werkzeugreferenz
Bevor Sie starten

Was zuerst vorhanden sein muss

Hi, Moose liefert echte gespeicherte Antworten, also muss etwas gesammelt worden sein, bevor ein Agent darauf aufbauen kann. Wenn Sie ein Agent sind, der das liest, gehen Sie diese vier Punkte mit Ihrem Nutzer durch, bevor Sie anfangen.

  1. 1
    Ein Hi, Moose Konto
    Für MCP reicht der kostenlose Tarif. Die REST API braucht einen bezahlten Tarif.
    Konto erstellen
  2. 2
    Die Desktop-App, installiert und angemeldet
    Die Sammlung läuft in der App, auf Ihrem Rechner oder einem Host unter Ihrer Kontrolle. Für MCP-Aufträge muss sie offen und angemeldet sein. REST-Lesezugriffe kommen aus der Cloud und funktionieren bei geschlossener App.
    App herunterladen
  3. 3
    Ein Projekt mit verfolgten Prompts
    Ein Projekt pro Marke. Fügen Sie die Prompts hinzu, die Sie verfolgen wollen, wählen Sie Engines und lassen Sie mindestens einen Lauf abschließen. Die Historie beginnt mit dem ersten Lauf, also früh Prompts anlegen.
  4. 4
    Für die fertige App ein API-Schlüssel
    Der Kontoinhaber erstellt unter Einstellungen, API-Schlüssel einen Nur-Lese-Schlüssel. Er liegt in HIMOOSE_API_KEY auf Ihrem Server, nie im Browser.
Verbinden

Hi, Moose zu Ihrem Coding-Agenten hinzufügen

Ein Befehl oder ein Konfigurationseintrag, dann eine Anmeldung im Browser. Für MCP ist kein API-Schlüssel nötig, und in die Datei kommt nichts, was ein Teammitglied nicht committen könnte.

Führen Sie das im Terminal aus, starten Sie dann Claude Code und tippen Sie /mcp. Wählen Sie himoose, dann Authenticate.

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

Ihr Browser öffnet die Hi, Moose Anmeldung. Mit --scope user ist der Server in jedem Projekt verfügbar.

Server hinzufügen, dann anmelden. Codex CLI und IDE-Erweiterung teilen sich diese Konfiguration.

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

Der Login-Befehl öffnet die Hi, Moose Anmeldung in Ihrem Browser.

Fügen Sie das in ~/.cursor/mcp.json ein, oder in .cursor/mcp.json für ein einzelnes Projekt.

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

Öffnen Sie dann Cursor Settings, Tools & MCP, und melden Sie sich bei Hi, Moose an, wenn Sie gefragt werden.

Jeder Agent, der einen Remote-MCP-Server über HTTPS mit OAuth-Anmeldung hinzufügen kann, kann sich verbinden.

Serveradresse
https://mcp.himoose.com/mcp

Lassen Sie ein etwaiges Feld für die OAuth-Client-ID leer. Hi, Moose registriert die App bei der Anmeldung.

Bitten Sie den Agenten nach der Anmeldung, list_projects aufzurufen. Liefert es Ihr Projekt, sind Sie verbunden. Chat-Apps wie Claude und ChatGPT verbinden sich auf dieselbe Weise; die Schritte stehen unter Agenten verbinden.
Erster Prompt

Ein erster Blick in einer Sitzung. Nur MCP, funktioniert also im kostenlosen Tarif.

Baue mit dem Hi, Moose MCP-Server (https://mcp.himoose.com/mcp) einen statischen HTML-Bericht in ./ai-visibility, der zeigt, wie unsere Marke in der AI-Suche zu unseren verfolgten Themen erscheint. Frage AI-Engines nicht selbst ab. Ich schließe die Hi, Moose Anmeldung in meinem Browser ab. Frage mich nie nach einem Passwort oder Token. Beginne mit list_projects und frage mich, welches Projekt verwendet werden soll. Hole die Daten mit visibility_check_topic und nutze visibility_get_answer für die gespeicherten Antworten hinter den Zahlen. Zeige Ergebnisse pro Engine, die Veränderung über die letzten 30 Tage, genannte Wettbewerber und die Seiten, die jede Engine zitiert. Meldet ein Werkzeug kein Host-Gerät, keine Sichtbarkeitshistorie oder zu wenig Historie für einen Vergleich, halte an und sage mir, was ich in Hi, Moose einrichten muss, statt zu schätzen.

Ein Dashboard, das Ihr Team im Browser öffnet. MCP beim Bauen, REST API in der fertigen App. Die REST API braucht einen bezahlten Tarif.

Baue ein internes Web-Dashboard, das zeigt, wie unsere Marke in der AI-Suche zu unseren 20 wichtigsten Themen erscheint. Nutze Hi, Moose für alle AI-Suchdaten. Frage AI-Engines nicht selbst ab. 1. Nutze beim Bauen den Hi, Moose MCP-Server (https://mcp.himoose.com/mcp), um zu sehen, welche Daten vorhanden sind. Ich schließe die Anmeldung in meinem Browser ab. Frage mich nie nach einem Passwort oder Token. 2. Rufe list_projects auf und frage mich, welches Projekt verwendet werden soll. Prüfe, wie viele Prompts verfolgt werden, welche Engines, und wie weit die Historie zurückreicht. 3. Rufe in der App die Hi, Moose REST API (https://api.himoose.com/v1) nur vom Server aus auf, mit dem Schlüssel in der Umgebungsvariable HIMOOSE_API_KEY. Sende den Schlüssel nie an den Browser. Lies das Schema aus https://api.himoose.com/v1/openapi.json. 4. Zeige Ergebnisse nach Thema und Engine, die Veränderung seit letztem Monat, genannte Wettbewerber und die Quellen, die jede Engine zitiert. Verlinke jede Zahl mit der gespeicherten Antwort dahinter. 5. Fehlt etwas (keine verfolgten Prompts für ein Thema, weniger als zwei Monate Historie, keine Wettbewerber festgelegt), zeige das klar in der App und sage mir, was ich in Hi, Moose einrichten muss. Schätze nicht und fülle keine Lücken.
Skill-Datei

Bringen Sie Ihrem Agenten Hi, Moose einmal bei

Legen Sie diese Datei in Ihr Projekt, und der Agent weiß, welche Werkzeuge er in welcher Reihenfolge aufruft und was zu tun ist, wenn Daten fehlen. Sie deckt MCP während der Entwicklung und die REST API in der fertigen App ab.

Claude Code.claude/skills/himoose/SKILL.md
CodexAGENTS.md
Cursor.cursor/rules/himoose.mdc

Codex und Cursor lesen reines Markdown, fügen Sie also denselben Inhalt ohne den Front-Matter-Block ein.

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.
Was gebaut wird

Ihr Frontend, Ihre Logik, die Daten von Moose

Drei typische Formen, mit den Aufrufen, die jede macht. Oberfläche, Branding, Hosting und alles Spezifische für Ihr Geschäft gehören Ihnen.

Internes Dashboard

Sichtbarkeit nach Thema und Engine, Veränderung seit letztem Monat, Wettbewerber und die Quellen, die jede Engine zitiert.

GET /v1/projects/{id}/stats/dailyGET /v1/projects/{id}/stats/competitorsGET /v1/projects/{id}/answers/{answerId}
Braucht etwa zwei Monate Läufe für den Vergleich.

Wöchentliches Slack-Briefing

Ein geplanter Auftrag, der diese Woche mit den letzten vier vergleicht und Share of Voice, eine zitierte Antwort und jede neue Quelle postet.

GET /v1/projects/{id}/stats/competitorsGET /v1/projects/{id}/answers?mentioned=false
Läuft ohne anwesende Person, also REST mit einem Nur-Lese-Schlüssel.

Kundenportal für Agenturen

Ein Login pro Kunde, jeweils den Hi, Moose Projekten zugeordnet, die er sehen darf. Ihr Branding und PDF-Export.

GET /v1/projectsGET /v1/projects/{id}/stats/daily
Ein Projekt pro Kundenmarke. Schlüssel lassen sich auf ausgewählte Projekte beschränken.

Ein Coding-Agent kann an einem Nachmittag einen Collector schreiben. Was er nicht kann, ist ihn am Laufen halten. Diesen Teil nimmt Ihnen Hi, Moose ab.

Eine andere Sammelmethode pro EngineÄnderungen an Engines und Oberflächen, bemerkt und behobenTägliche Planung, Wiederholungen und RatenlimitsJede Antwort so speichern, dass sie ein Jahr später noch vergleichbar istMarken, Wettbewerber und Zitate in Freitext erkennenEinen echten Rückgang von einem unvollständigen Lauf unterscheiden
Referenz

MCP und REST im Vergleich

MCPREST API
Adresse MCP: https://mcp.himoose.com/mcp REST API: https://api.himoose.com/v1
Am besten für MCP: Coding-Agenten und AI-Assistenten, die mit einer Person arbeiten REST API: Anwendungen, Portale und geplante Aufträge, die Ihr Team bereitstellt
Authentifizierung MCP: OAuth 2.1. Eine Person meldet sich im Browser mit ihrem Hi, Moose Konto an. Keine Schlüssel zu speichern. REST API: Geheimer API-Schlüssel in einem Authorization: Bearer Header. Schlüssel beginnen mit hmk_live_ und werden einmal angezeigt.
Von wo aufrufen MCP: Vom Agenten, nach der Anmeldung REST API: Nur von Ihrem Server. Die API nimmt keine Aufrufe aus Browsern an.
Tarif MCP: Jeder Tarif, auch kostenlos REST API: Bezahlte Tarife. Der Kontoinhaber erstellt Schlüssel unter Einstellungen, API-Schlüssel.
Berechtigungen MCP: Projekte und Sichtbarkeitsdaten lesen und Arbeit in der Bibliothek anlegen. Kann nicht veröffentlichen, löschen oder Einstellungen ändern. REST API: Standardmäßig lesen. Optionale Scopes, um die Verfolgung zu ändern (tracking:write) und Läufe zu starten (runs:execute). Schlüssel lassen sich auf ausgewählte Projekte beschränken und nach 30, 90 oder 365 Tagen ablaufen lassen.
Bei geschlossener App MCP: Aufträge laufen auf dem Host-Gerät, es muss also an sein, mit offener und angemeldeter Hi, Moose App. REST API: Lesezugriffe funktionieren, weil sie aus der Cloud bedient werden. Läufe, die Ihren Host brauchen, warten bis zu 24 Stunden darauf.
Antworten MCP: Strukturierte Werkzeugergebnisse mit Antwort-IDs. Klare Meldungen benennen alles, was fehlt. REST API: JSON mit Cursor-Paginierung und Problem-Details-Fehlern. Jede Antwort meldet Ihr tägliches Anfragekontingent.
Schema MCP: tools/list nach der Anmeldung REST API: https://api.himoose.com/v1/openapi.json

MCP-Werkzeuge für Sichtbarkeitsdaten

Server https://mcp.himoose.com/mcp. Werkzeuge für Briefings, Entwürfe und Audits sind unter Agenten verbinden aufgeführt.

list_projectsProjekte des angemeldeten Kontos
visibility_check_topicErwähnungen, Zitate und Wettbewerber pro Engine zu einem Thema, aktuell und über einen Zeitraum
visibility_get_answerEine gespeicherte Antwort vollständig, mit Quellen
visibility_list_opportunitiesPriorisierte Lücken, mit den Seiten, die Engines stattdessen zitieren
get_resultEinen abgeschlossenen Auftrag per ID abholen

REST-Endpunkte

Basis-URL https://api.himoose.com/v1. Die genauen Schemas stehen in /v1/openapi.json.

GET /v1/projectsProjekte, die der Schlüssel lesen darf
GET /v1/projects/{id}Ein Projekt, mit verfolgten Prompts, Engines und Historiendaten
GET /v1/projects/{id}/topicsThemen und die Prompts darin
GET /v1/projects/{id}/stats/dailyErwähnungs- und Zitierraten pro Tag und Engine, bis zu 366 Tage
GET /v1/projects/{id}/stats/competitorsShare of Voice für einen Zeitraum
GET /v1/projects/{id}/answersGespeicherte Antworten, filterbar nach Engine, Prompt, Thema, Lauf, erwähnt und zitiert
GET /v1/projects/{id}/answers/{answerId}Eine Antwort vollständig, mit Quellen
POST /v1/projects/{id}/run-requestsEinen Lauf starten (braucht runs:execute)

Eine Anfrage von Ihrem 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 */
  ]
}

Eine Zeile pro Tag und Engine. incompleteDays zählt die Tage im Zeitraum, die noch nicht zusammengefasst sind, damit Ihre App sie kennzeichnen kann, statt einen Einbruch zu zeigen. Die Werte sind Beispieldaten.

Fragen zum Bauen auf Hi, Moose

Sollte meine App MCP oder die REST API nutzen?

Nutzen Sie MCP, wenn ein Agent die Arbeit mit einer anwesenden Person erledigt, in Claude Code, Codex, Cursor, Claude oder ChatGPT. Nutzen Sie die REST API, wenn Ihre eigene Anwendung oder ein geplanter Auftrag Hi, Moose von einem Server aus aufruft. Viele Projekte nutzen beides: MCP, während der Agent erkundet und baut, die REST API in der ausgelieferten App.

Kann eine Browser-App die API direkt aufrufen?

Nein. Die API nimmt keine Aufrufe aus Browsern an, und ein API-Schlüssel in clientseitigem Code wäre offengelegt. Rufen Sie sie von Ihrem Server, einer Serverless-Funktion oder einem geplanten Auftrag auf und schicken Sie Ihrem Frontend nur die Daten, die es braucht.

Wie viel Historie braucht meine App?

Eine Momentaufnahme pro Engine braucht einen abgeschlossenen Lauf. Monatsvergleiche brauchen Läufe in beiden Monaten. Die Historie beginnt, wenn ein Prompt zum ersten Mal verfolgt wird, also legen Sie die wichtigen Prompts früh an.

Muss die Desktop-App offen bleiben?

Für MCP ja: Aufträge laufen auf dem Host-Gerät, das Sie unter Einstellungen, Verbundene Agenten wählen. Für REST-Lesezugriffe nein: sie werden aus der Cloud bedient. Läufe, die Ihren Host brauchen, warten bis zu 24 Stunden darauf.

Kann ich die App woanders als auf meinem Laptop betreiben?

Ja. Installieren Sie sie auf Hosting unter Ihrer Kontrolle und lassen Sie sie laufen, oder lassen Sie Hi, Moose sie auf einem dedizierten Server in Ihrer Region betreiben. Beides ist auf der Infrastrukturseite beschrieben.

Kann ich eine App für meine Kunden bauen?

Ja. Agenturen nutzen ein Projekt pro Kundenmarke und beschränken einen API-Schlüssel auf die Projekte, die ein Portal lesen soll. Das Portal, sein Branding und seine Kunden-Logins bauen Sie selbst.

Agenten verbindenEinrichtung für Claude und ChatGPT und die vollständige Werkzeugliste. Überblick über die InfrastrukturWie Hi, Moose Antworten sammelt und speichert, und wo es laufen kann. API-DokumentationEndpunkte, Parameter, Fehler und die OpenAPI-Spezifikation. Desktop-App herunterladenNötig für die Sammlung. Mac oder PC.