Skip to main content
Glama

@lotd/word-orb

面向 AI 智能体的语言基础设施。162,251 个单词。47 种语言。24 万个音频文件。边缘计算下的确定性响应。

Orb 平台的一部分 — 为教学 AI 提供字典、课程和评估。

npm License: MIT

什么是 Word Orb?

专为 AI 智能体、教育平台和机器人构建的字典 API。一次 API 调用即可返回:

  • 定义 — 准确、有词源支持,绝无幻觉

  • 47 种语言翻译 — 原生脚本 + 音标发音

  • 适龄内容 — 儿童(5-12 岁)、青少年、成人和老年(65+ 岁)版本

  • IPA 发音 — 每个单词的标准音标符号

  • 24 万个音频文件 — 通过 R2 提供的母语者发音

运行在 Cloudflare Workers + D1 上。边缘交付延迟低于 5ms。相同的输入,每次都有相同的输出。

Related MCP server: Vocab Voyage

安装

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 claude_desktop_config.json 中:

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

涵盖所有三个 Orb 平台产品的 19 个 MCP 工具。适用于 Claude、Cursor、Windsurf 以及任何兼容 MCP 的智能体。

Orb 平台

Word Orb 是三个产品之一:

产品

功能

规模

Word Orb

字典 + 翻译 + 发音

162,251 个单词,47 种语言

Lesson Orb

结构化课程计划

226,725 个课程块,5 个阶段,10 种原型

Quiz Orb

评估问题

21,900 次交互,6 种问题类型

这三个产品共享一个知识图谱,包含 30,288 个连接,将单词 → 课程 → 测验关联起来。

教育套件 (Education Stack) 将三者打包,每月仅需 $179(21% 折扣)。

前往演练场 →

API 参考

new WordOrb(options?)

创建客户端实例。

选项

类型

默认值

描述

apiKey

string

—

你的 wo_ API 密钥(免费获取)

baseUrl

string

https://word-orb-api.nicoletterankin.workers.dev

API 基础 URL


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 调用次数

适用场景

免费

$0

50

原型设计、评估

入门

$49/月

5,000

副业项目、小型应用

增长

$149/月

50,000

生产环境智能体、团队

企业

$499/月

无限制

大规模、SLA、优先支持

获取你的 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 — 带有 Word Orb 词汇的 CrewAI 智能体

  • openai-function.js — OpenAI 函数调用集成

  • mcp-config.json — Claude Desktop MCP 配置

链接

关于

由 Lesson of the Day PBC 构建。为需要精准用词的 AI 智能体提供语言基础设施。

许可证

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Word Orb is a language enrichment MCP server. 50,000+ words with IPA, definitions, etymology, translations in 47 languages with native script, gender equity guidance, and AI identity ethics. 3ms edge response. Tools: word_enrich, word_ethics, agent_speak. URL: https://mcp.wordorb.ai/mcp
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Vocabulary tools for SAT, ISEE, SSAT, GRE, GMAT, LSAT, PSAT prep — Word of the Day, definitions, multiple-choice quizzes, course word lists, and 7-day study plan previews. 13 test-prep courses. Hosted MCP server with MCP Apps UI widgets. No install required. Optional scoped personal tokens.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A vocabulary-bank MCP server that allows users to collect unfamiliar words, organize them into decks, review with spaced repetition, and enrich with definitions and pronunciation, all stored locally.
      2
      MIT