Word Orb — English vocabulary for reader glossaries

Word Orb

为阅读器词汇表和词汇工具提供存储的英语词汇记录。Word Orb 以 JSON 格式提供约 162K 条经 AI 辅助整理的英语词汇记录。可选翻译涵盖 47 个语言代码下约 14K 个英语词头；字段覆盖范围和质量各不相同。内容未经独立人工核验。

评估你自己的词表 · API 文档 · 套餐和 API 密钥

根据存储的记录创建词汇表

批量词汇表示例会规范化并去重英语单词，读取现有记录，保留缺失的单词和错误，并且只显示 API 返回的字段。它绝不会回退到生成或其他服务。

请使用 Node.js 18 或更高版本，以及现有的 Word Orb API 密钥。无需安装软件包。请在环境中安全地设置 WORDORB_API_KEY，然后运行：

node examples/batch-glossary.mjs courage wisdom resilience

默认批次大小为 10 个单词，适用于免费套餐。付费套餐支持最多 50 个单词的批次；如果你的套餐支持，请设置 WORDORB_BATCH_SIZE=50。输出为 JSON，可供检查或集成到你的应用程序中。只有在评估结果是否适合你的使用场景后，才向用户展示。

POST https://wordorb.ai/api/words/batch 接受带有 Authorization: Bearer ... 标头的 {"words":["courage","wisdom"]}。批量查询只读取存储的记录。未知单词仍会缺失；存储的响应不保证事实准确。翻译、发音和其他字段可能缺失。

现有 JavaScript 客户端

此代码库包含以 @lotd/word-orb 发布的 CommonJS 客户端。目前它不提供批量方法；如需仅查询存储记录，请使用上面的直接 HTTP 示例。

const { WordOrb } = require('@lotd/word-orb');
const orb = new WordOrb({
  apiKey: process.env.WORDORB_API_KEY,
  baseUrl: 'https://wordorb.ai',
});
const usage = await orb.me();
console.log({ tier: usage.tier, callsToday: usage.calls_today });

客户端的 word() 方法使用单词查询端点，其行为与仅查询存储记录的批量查询不同。使用前请查看当前 API 文档。此代码库中的旧示例介绍的是早期集成方式，并非仅查询存储记录的词汇表流程。

套餐

免费 API 密钥每天允许调用 10,000 次，每分钟最多 10 个请求，且每批最多 10 个单词。Starter 套餐每月收费 $9，包含每个 UTC 日历月 150,000 次调用，之后每次额外调用收费 $0.0006；此外支持每批最多 50 个单词，并包含 TextOrb。包含的调用额度会在每个 UTC 日历月的第一天重置，与订阅续订时间分开计算。Starter 套餐启用按量计费后，显示的每日 5,000 次调用基准额度不会限制额外调用。Pro 套餐每月收费 $49，每天允许调用 50,000 次；Scale 套餐每月收费 $149。完整限额和条款请参阅当前定价页面。

集成前，请先使用词表评估器检查实际覆盖范围和字段可用性。不要假设有 47 部完整词典、经过编辑核验的内容或完整的音频覆盖。

MCP

规范的远程端点为 https://wordorb.ai/mcp，使用 Streamable HTTP。现有的 MCP Registry 标识仍为 io.github.nicoletterankin/orb-platform；server.json 描述了该标识下的版本 6.3.1。

仅查询已存储词条的词汇表查询

使用 lookup_words 工具和一个英文词头数组：

{"words":["courage","wisdom","resilience"]}

该工具读取现有记录，并明确保留缺失的词条和不可用的字段。它不会生成缺失内容。免费版每批最多可查询 10 个词；付费套餐每批最多可查询 50 个词。记录由 AI 辅助生成，且内容不完整；升级不会提高其准确性，也不会补全缺失的译文。

此工具要求在请求标头中提供 Word Orb API 密钥，Authorization: Bearer wo_YOUR_KEY。连接远程 MCP 服务时，请使用支持自定义标头的客户端；按照该客户端的说明，在本地将实际密钥保存为机密。请勿将密钥粘贴到工具参数、URL、聊天消息或已提交的配置文件中。下面的占位符不是可用的密钥。

{
  "mcpServers": {
    "word-orb": {
      "url": "https://wordorb.ai/mcp",
      "headers": {
        "Authorization": "Bearer wo_YOUR_KEY"
      }
    }
  }
}

客户端配置格式各不相同。此集成不提供 OAuth 登录流程，也不是适用于所有 MCP 客户端的通用一键配置。每日单词工具是公开的；需要身份验证的工具使用账户现有的限额。其他工具（包括单词查询工具）的行为可能与仅查询已存储词条的 lookup_words 不同；使用前请查看其说明。

请从词表评估器和免费密钥开始，然后查阅最新的 Word Orb 文档。仅在付费套餐的容量或功能符合应用需求时再选择该套餐。

数据使用和软件许可证

本仓库的客户端软件采用 MIT 许可证。该许可证不授予 API 内容的再分发权。本仓库不提供离线词典或语料再分发许可证；有关 API 数据的使用，请参阅服务条款。

由 Lesson of the Day PBC 构建。