@lotd/word-orb

Infraestructura lingüística para agentes de IA. 162.251 palabras. 47 idiomas. 240 mil archivos de audio. Respuestas deterministas en el borde (edge).

Parte de Orb Platform: diccionario, lecciones y evaluaciones para IA que enseña.

¿Qué es Word Orb?

Una API de diccionario creada para agentes de IA, plataformas educativas y robótica. Una llamada a la API devuelve:

• Definiciones: precisas, respaldadas por etimología, no alucinadas

• Traducciones en 47 idiomas: escritura nativa + pronunciación fonética

• Contenido apropiado para la edad: variantes para niños (5-12), adolescentes, adultos y personas mayores (65+)

• Pronunciación IPA: notación fonética estándar para cada palabra

• 240 mil archivos de audio: pronunciaciones de hablantes nativos a través de R2

Se ejecuta en Cloudflare Workers + D1. Entrega en el borde (edge) en menos de 5 ms. Misma entrada, misma salida, siempre.

Instalación

npm install @lotd/word-orb

Inicio rápido

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

Obtén una clave API gratuita

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

Integración MCP (una línea)

Añádelo a tu claude_desktop_config.json de Claude Desktop:

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

19 herramientas MCP en los tres productos de Orb Platform. Funciona con Claude, Cursor, Windsurf y cualquier agente compatible con MCP.

La plataforma Orb

Word Orb es uno de los tres productos:

Los tres comparten un grafo de conocimiento con 30.288 conexiones que vinculan palabras → lecciones → cuestionarios.

Education Stack agrupa los tres por $179/mes (21% de descuento).

Prueba el playground →

Referencia de la API

new WordOrb(options?)

Crea una instancia de cliente.

orb.word(word) → Promise<WordResult>

Busca cualquier palabra. Devuelve la definición, pronunciación (IPA), categoría gramatical, etimología, traducciones en 47 idiomas y contenido apropiado para la edad.

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>

Obtén el listado completo de la biblioteca de palabras.

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

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

Realiza una auditoría de cumplimiento del vocabulario de tu agente. Devuelve un análisis de cobertura, brechas de adecuación a la edad y una calificación de cumplimiento.

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

Envía comentarios sobre el vocabulario.

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

orb.signup(email) → Promise<SignupResult>

Crea una clave API gratuita al instante. 50 búsquedas por día.

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

orb.me() → Promise<KeyStatus>

Verifica el uso de tu clave API, el nivel y las llamadas restantes.

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

orb.health() → Promise<HealthResult>

Verifica el estado del servicio.

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

orb.stats() → Promise<StatsResult>

Obtén estadísticas de la base de datos y de uso.

Precios

Obtén tu clave API →

Manejo de errores

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

Se incluyen definiciones completas de 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');

Ejemplos

Consulta el directorio examples/:

• langchain-tool.js — Usa Word Orb como una herramienta de LangChain

• crewai-agent.py — Agente de CrewAI con vocabulario de Word Orb

• openai-function.js — Integración de llamadas a funciones de OpenAI

• mcp-config.json — Configuración MCP de Claude Desktop

Enlaces

• Playground — Prueba los tres productos en vivo

• Precios y registro

• Documentación de la API

• Servidor MCP — 19 herramientas para marcos de trabajo de agentes

• npm

Acerca de

Creado por Lesson of the Day PBC. Infraestructura lingüística para agentes de IA que necesitan acertar con las palabras.

Licencia

MIT