@lotd/word-orb

Sprachinfrastruktur für KI-Agenten. 162.251 Wörter. 47 Sprachen. 240.000 Audiodateien. Deterministische Antworten am Edge.

Teil der Orb Platform — Wörterbuch, Lektionen und Bewertungen für KI, die lehrt.

Was ist Word Orb?

Eine Wörterbuch-API für KI-Agenten, Bildungsplattformen und Robotik. Ein API-Aufruf liefert:

• Definitionen — präzise, etymologisch fundiert, keine Halluzinationen

• Übersetzungen in 47 Sprachen — in der jeweiligen Landessprache + phonetische Aussprache

• Altersgerechte Inhalte — Varianten für Kinder (5-12), Jugendliche, Erwachsene und Senioren (65+)

• IPA-Aussprache — Standard-Lautschrift für jedes Wort

• 240.000 Audiodateien — Aussprachen von Muttersprachlern via R2

Läuft auf Cloudflare Workers + D1. Unter 5ms Edge-Bereitstellung. Gleicher Input, gleicher Output, jedes Mal.

Installation

npm install @lotd/word-orb

Schnellstart

const { WordOrb } = require('@lotd/word-orb');

const orb = new WordOrb({ apiKey: 'wo_your_api_key' });

// Look up any word
const result = await orb.word('serendipity');
console.log(result.def);    // Full definition
console.log(result.ipa);    // /ˌsɛɹ.ən.ˈdɪp.ɪ.ti/
console.log(result.etym);   // Etymology
console.log(result.langs);  // 47-language translations

Kostenlosen API-Schlüssel erhalten

const { key } = await orb.signup('you@example.com');
// Returns: wo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
// 50 free lookups per day, upgrade anytime

MCP-Integration (eine Zeile)

Fügen Sie dies zu Ihrer claude_desktop_config.json in Claude Desktop hinzu:

{
  "mcpServers": {
    "word-orb": {
      "url": "https://mcp.thedailylesson.com/mcp"
    }
  }
}

19 MCP-Tools für alle drei Produkte der Orb Platform. Funktioniert mit Claude, Cursor, Windsurf und jedem MCP-kompatiblen Agenten.

Die Orb Platform

Word Orb ist eines von drei Produkten:

Alle drei teilen sich einen Wissensgraphen mit 30.288 Verbindungen, die Wörter → Lektionen → Quizze verknüpfen.

Das Education Stack bündelt alle drei für 179 $/Monat (21 % Rabatt).

Zum Playground →

API-Referenz

new WordOrb(options?)

Erstellt eine Client-Instanz.

orb.word(word) → Promise<WordResult>

Schlagen Sie ein beliebiges Wort nach. Gibt Definition, Aussprache (IPA), Wortart, Etymologie, Übersetzungen in 47 Sprachen und altersgerechte Inhalte zurück.

const data = await orb.word('courage');
// {
//   word: 'courage',
//   ipa: '/ˈkɜːrɪdʒ/',
//   pos: 'noun',
//   def: 'Courage is the ability to face fear, danger, or difficulty...',
//   etym: 'From Old French "corage," meaning "heart, spirit"...',
//   langs: { es: 'coraje', fr: 'courage', de: 'Mut', zh: '勇气', ... },
//   tones: { child: '...', teen: '...', adult: '...' }
// }

orb.words() → Promise<WordListResult>

Ruft die vollständige Wortlisten-Bibliothek ab.

const { count, words } = await orb.words();
console.log(`${count} words available`);

orb.audit(email, words) → Promise<AuditResult>

Führen Sie ein Compliance-Audit für den Wortschatz Ihres Agenten durch. Gibt eine Abdeckungsanalyse, Lücken bei der Altersgerechtigkeit und eine Compliance-Bewertung zurück.

const report = await orb.audit('cto@company.com', [
  'understand', 'help', 'teach', 'learn', 'discover'
]);
console.log(report.grade);            // 'A-'
console.log(report.compliance_score); // 91

orb.feedback(word, vote, correction?) → Promise<{ ok: boolean }>

Senden Sie Feedback zum Wortschatz.

await orb.feedback('serendipity', 1);                    // upvote
await orb.feedback('irregardless', -1, 'Not a word!');   // downvote + correction

orb.signup(email) → Promise<SignupResult>

Erstellen Sie sofort einen kostenlosen API-Schlüssel. 50 Abfragen pro Tag.

const { key, tier, daily_limit } = await orb.signup('dev@company.com');

orb.me() → Promise<KeyStatus>

Überprüfen Sie die Nutzung Ihres API-Schlüssels, Ihren Tarif und die verbleibenden Aufrufe.

const status = await orb.me();
console.log(status.tier);            // 'starter'
console.log(status.remaining_today); // 4873

orb.health() → Promise<HealthResult>

Überprüfen Sie den Dienststatus.

const health = await orb.health();
// { status: 'healthy', checks: { kv: 'ok', d1: 'ok (162250 words)', ... } }

orb.stats() → Promise<StatsResult>

Erhalten Sie Datenbank- und Nutzungsstatistiken.

Preise

API-Schlüssel erhalten →

Fehlerbehandlung

try {
  const result = await orb.word('nonexistent');
} catch (err) {
  if (err.status === 401) console.error('Invalid API key');
  else if (err.status === 429) console.error('Rate limit reached');
  else if (err.status === 404) console.error('Word not found');
  else console.error('API error:', err.message);
}

TypeScript

Vollständige TypeScript-Definitionen enthalten:

import { WordOrb, WordResult } from '@lotd/word-orb';

const orb = new WordOrb({ apiKey: process.env.WORD_ORB_KEY });
const result: WordResult = await orb.word('ephemeral');

Beispiele

Siehe das Verzeichnis examples/:

• langchain-tool.js — Word Orb als LangChain-Tool verwenden

• crewai-agent.py — CrewAI-Agent mit Word Orb-Wortschatz

• openai-function.js — Integration von OpenAI-Funktionsaufrufen

• mcp-config.json — Claude Desktop MCP-Konfiguration

Links

• Playground — Alle drei Produkte live testen

• Preise & Anmeldung

• API-Dokumentation

• MCP-Server — 19 Tools für Agenten-Frameworks

• npm

Über

Entwickelt von Lesson of the Day PBC. Sprachinfrastruktur für KI-Agenten, die Wörter richtig verwenden müssen.

Lizenz

MIT