Dev Docs
Emoji Intelligence
Emoji Developer Platform

Emoji Intelligence für API, CLI, MCP und agentische Workflows

Die Dev-Plattform hinter dem Emoji-Katalog liefert Resolve-, Search-, Normalize-, Lint-, Suggest-, Fixtures-, Intent-, Export- und Compare-Funktionen über dieselbe Engine. Resolve, Search, Normalize, Fixtures, Intents und Compare sind öffentlich rate-limitiert; Lint, Suggest, Export und Hosted MCP laufen über API-Key-Scopes.

Resolve JSON öffnenZum Emoji-Katalog
EU-Sprachen
24

Einheitliche Locale-Layer für Search, Intents und Fallbacks

API-Oberfläche
6 + 4

Sechs öffentliche Endpunkte mit IP-Limits, vier geschützte Endpunkte per Scope-Key

Paket + MCP
Hosted

Installierbares Paket und gehosteter MCP-Endpunkt sprechen dieselbe Semantik

Resolve + Search

Von `:rocket:` über `U+1F680` bis `Warnung`.

Lint + Normalize

Für CI, Accessibility und konsistente Content-Pipelines.

MCP + Agents

Direkt in agentischen Workflows für Changelogs, PRs und Support.

EU-24 Locales

Eine gemeinsame Semantik über 24 EU-Sprachen hinweg.

Wofür das praktisch ist
Release Notes und PRs

Intents wie deploy, warning, breaking-change oder security liefern passende Emojis plus Fallback-Text.

CI, QA und Linting

Unicode-Kantenfälle, gemischte Formate und fehlende Text-Fallbacks lassen sich automatisiert prüfen.

Content- und CMS-Pipelines

Shortcodes, Glyphen, Entities und Slugs können deterministisch normalisiert und exportiert werden.

Agents und MCP-Clients

Die MCP-Tools sprechen dieselbe Emoji-Semantik wie die Website und die CLI.

Live API

Die öffentliche Emoji-API auf ostheimer.at

Resolve, Search, Normalize, Fixtures, Intents und Compare sind ohne Key verfügbar, aber separat pro IP rate-limitiert. Lint, Suggest, Export und der gehostete MCP-Endpunkt erwarten einen API-Key mit passenden Emoji-Scopes.

Die klickbaren GET-Beispiele öffnen rohe JSON-Antworten in einem neuen Tab.

resolve

Löst Glyphen, Codepoints, Shortcodes oder Slugs auf ein kanonisches Emoji auf.

GETPublic
/api/emojis/resolve?value=%F0%9F%9A%80&lang=deJSON öffnen
search

Sucht über lokalisierte Namen, Keywords, Tags und Intent-Signale.

GETPublic
/api/emojis/search?q=Warnung&lang=de&limit=5JSON öffnen
normalize

Normalisiert Eingaben in Glyph, Unicode-Label und HTML-Entity.

POSTPublic
/api/emojis/normalize
Per JSON-POST ansprechbar.
lint

Prüft Texte auf Formatmischungen, Accessibility-Fallbacks und problematische Kontexte.

POSTAPI Key
/api/emojis/lint
API-Key mit passendem Scope erforderlich.
suggest

Liefert passende Emojis für Query oder Intent inklusive Begründung.

POSTAPI Key
/api/emojis/suggest
API-Key mit passendem Scope erforderlich.
fixtures

Gibt harte Unicode-Fixtures für Parser-, Rendering- und Datenbanktests aus.

GETPublic
/api/emojis/fixtures?set=zwj&lang=deJSON öffnen
intents

Zeigt den dev-zentrierten Intent-Katalog mit lokalisierten Suchbegriffen.

GETPublic
/api/emojis/intents?lang=deJSON öffnen
compare

Vergleicht Plattform-Assets und Metadaten für ein Emoji.

GETPublic
/api/emojis/compare?value=%F0%9F%9A%80&lang=deJSON öffnen
export

Exportiert lokalisierte Such- und Termdaten für weitere Tools.

GETAPI Key
/api/emojis/export?lang=de&format=json
API-Key mit passendem Scope erforderlich.
API Playground

Direkt im Browser testen

Resolve, Search und Compare funktionieren oeffentlich. Fuer `lint` und `suggest` kannst du hier jetzt direkt einen API-Key mitsenden; der Key bleibt nur im Browser-State dieser Seite.

Request
GET /api/emojis/resolve?lang=de&value=%F0%9F%9A%80
Antwort
Loest eine Eingabe direkt auf ein kanonisches Emoji auf.
Noch kein Request
Rohes JSON oeffnen
{
  "status": "ready"
}
CLI und MCP

Paket, CLI und Hosted MCP

Das Paket nutzt die Live-API von ostheimer.at. Nach der Installation steht der kurze CLI-Name `emoji` bereit; geschützte Workflows lesen optional `EMOJI_INTELLIGENCE_API_KEY` oder `--api-key`.

Install + CLI
npm install ostheimer-emoji-intelligence
npx emoji resolve "🚀" --lang de --json
npx emoji search "Warnung" --lang de --json
EMOJI_INTELLIGENCE_API_KEY=your_key npx emoji suggest --intent security --lang de --json
npx emoji export --lang de --format json --api-key "$EMOJI_INTELLIGENCE_API_KEY"
Hosted MCP
{
  "mcpServers": {
    "emoji-intelligence": {
      "url": "https://www.ostheimer.at/api/emojis/mcp",
      "headers": {
        "Authorization": "Bearer ${EMOJI_INTELLIGENCE_API_KEY}"
      }
    }
  }
}
Der kurze Befehl `emoji` funktioniert nach `npm install ostheimer-emoji-intelligence`. Alternativ gibt es den Tarball unter https://www.ostheimer.at/downloads/ostheimer-emoji-intelligence-0.1.1.tgz. Für `lint`, `suggest`, `export` und Hosted MCP gibst du einen Key via `EMOJI_INTELLIGENCE_API_KEY` oder `--api-key` mit.
curl
curl -X POST https://www.ostheimer.at/api/emojis/lint \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer $EMOJI_INTELLIGENCE_API_KEY' \
  -d '{"text":"Release 🚀 shipped :rocket:","lang":"de","context":"release"}'
Keys und Scopes

Neue Keys erzeugst du im eingeloggten Dashboard unter /dashboard/settings. Für Emoji-Workflows stehen die Scopes `emoji:read`, `emoji:lint`, `emoji:suggest` und `emoji:mcp` bereit.

Lint prüft Texte und braucht `emoji:lint`.
Suggest braucht `emoji:suggest` für Intent-gestützte Empfehlungen.
Export läuft über `emoji:read`, Hosted MCP über `emoji:mcp`.
/dashboard/settingserstellt neue Public-API-Keys für Emoji-Scopes.
Öffentlich, aber gedrosselt

Resolve, Search, Normalize, Fixtures, Intents und Compare bleiben direkt testbar, setzen aber pro Route eigene IP-Limits und Rate-Limit-Header.

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Locale-Abdeckung

Die Plattform ist auf dieselben 24 EU-Sprachen ausgerichtet, die auch in Search, Resolve und den Intent-Daten genutzt werden.

bgcsdadeelenesetfifrgahrhuitltlvmtnlplptroskslsv
Sofort testbare Beispiele
resolve/api/emojis/resolve?value=%F0%9F%9A%80&lang=desearch/api/emojis/search?q=Warnung&lang=de&limit=5fixtures/api/emojis/fixtures?set=zwj&lang=deintents/api/emojis/intents?lang=decompare/api/emojis/compare?value=%F0%9F%9A%80&lang=de
Bausteine
Gemeinsame TypeScript-Engine für API, CLI, MCP und Skill.
DB-gestützte Suche mit lokalisierten Keywords, Tags und Intents.
Lint-, Fixture- und Compare-Routen für robustere Unicode-Workflows.
Sofort loslegen

Von der Website direkt in deinen Workflow

Wenn du ostheimer.at als Emoji-Backend für interne Tools, Agents oder Content-Pipelines nutzen willst, kannst du heute direkt mit den Live-Routen, dem Paket-Download oder dem gehosteten MCP-Endpunkt starten.

Resolve JSON öffnenZum Emoji-Katalog
Explorer