@lotd/word-orb

Языковая инфраструктура для ИИ-агентов. 162 251 слово. 47 языков. 240 тыс. аудиофайлов. Детерминированные ответы на границе сети (edge).

Часть Orb Platform — словари, уроки и оценки для обучающего ИИ.

Что такое Word Orb?

API словаря, созданный для ИИ-агентов, образовательных платформ и робототехники. Один вызов API возвращает:

• Определения — точные, основанные на этимологии, без галлюцинаций

• Переводы на 47 языков — нативная письменность + фонетическая транскрипция

• Контент, соответствующий возрасту — варианты для детей (5-12 лет), подростков, взрослых и пожилых людей (65+)

• Произношение в формате IPA — стандартная фонетическая нотация для каждого слова

• 240 тыс. аудиофайлов — произношение носителями языка через R2

Работает на Cloudflare Workers + D1. Доставка на границе сети менее чем за 5 мс. Одинаковый ввод, одинаковый вывод — всегда.

Установка

npm install @lotd/word-orb

Быстрый старт

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

Получите бесплатный API-ключ

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

Интеграция MCP (одной строкой)

Добавьте в файл claude_desktop_config.json для Claude Desktop:

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

19 инструментов MCP для всех трех продуктов Orb Platform. Работает с Claude, Cursor, Windsurf и любым агентом, поддерживающим MCP.

Платформа Orb

Word Orb — один из трех продуктов:

Все три продукта используют общий граф знаний с 30 288 связями, объединяющими слова → уроки → тесты.

Education Stack объединяет все три продукта за $179/мес (скидка 21%).

Попробовать в песочнице →

Справочник API

new WordOrb(options?)

Создание экземпляра клиента.

orb.word(word) → Promise<WordResult>

Поиск любого слова. Возвращает определение, произношение (IPA), часть речи, этимологию, переводы на 47 языков и контент, соответствующий возрасту.

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>

Получение полного списка слов библиотеки.

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

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

Проведение аудита соответствия словарного запаса вашего агента. Возвращает анализ покрытия, пробелы в соответствии возрасту и оценку соответствия.

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 }>

Отправка отзыва о словарной статье.

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

orb.signup(email) → Promise<SignupResult>

Мгновенное создание бесплатного API-ключа. 50 запросов в день.

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

orb.me() → Promise<KeyStatus>

Проверка использования вашего API-ключа, тарифного плана и оставшихся запросов.

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

orb.health() → Promise<HealthResult>

Проверка работоспособности сервиса.

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

orb.stats() → Promise<StatsResult>

Получение статистики базы данных и использования.

Тарифы

Получить API-ключ →

Обработка ошибок

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

Полные определения TypeScript включены:

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

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

Примеры

См. каталог examples/:

• langchain-tool.js — использование Word Orb как инструмента LangChain

• crewai-agent.py — агент CrewAI со словарным запасом Word Orb

• openai-function.js — интеграция вызова функций OpenAI

• mcp-config.json — конфигурация MCP для Claude Desktop

Ссылки

• Песочница — попробуйте все три продукта вживую

• Тарифы и регистрация

• Документация API

• MCP-сервер — 19 инструментов для агентских фреймворков

• npm

О нас

Создано Lesson of the Day PBC. Языковая инфраструктура для ИИ-агентов, которым нужно правильно использовать слова.

Лицензия

MIT