Word Orb — English vocabulary for reader glossaries

Word Orb

リーダー向けの用語集や語彙ツールで使える、保存済みの英語語彙レコードです。Word Orb は、AI の支援で作成された約 162K 件の英語レコードを JSON 形式で提供します。任意の翻訳は、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 キーでは、1 日あたり 10,000 回の呼び出しが可能で、1 分あたり 10 リクエスト、バッチは最大 10 語に制限されています。Starter は月額 $9 で、UTC の暦月ごとに 150,000 回の呼び出しが含まれ、それを超える呼び出しは 1 回あたり $0.0006 です。また、最大 50 語のバッチと TextOrb に対応しています。含まれる呼び出し回数は、サブスクリプションの更新とは別に、UTC の各暦月の初日にリセットされます。Starter の従量課金が有効な場合、表示される 1 日あたり 5,000 回という基準値によって追加の呼び出しがブロックされることはありません。Pro は月額 $49 で 1 日あたり 50,000 回、Scale は月額 $149 です。制限と利用規約の詳細は、現在の料金ページをご覧ください。

統合する前に、単語リスト評価ツールで実際の収録状況と利用可能なフィールドを確認してください。47 種類の辞書がすべて完全にそろっていること、編集者による検証が行われていること、または音声が完全に収録されていることを前提にしないでください。

MCP

正規のリモートエンドポイントは、Streamable HTTP を使用する https://wordorb.ai/mcp です。既存の MCP Registry 識別子は io.github.nicoletterankin/orb-platform のままです。server.json では、この識別子の下にあるバージョン 6.3.1 について説明しています。

保存済みデータのみを使った用語集の検索

英語の見出し語の配列を指定して、lookup_words ツールを使用します。

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

このツールは既存のレコードを読み込み、見つからない単語や利用できない項目を明示します。不足している内容を生成することはありません。無料プランでは1回につき最大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 が開発しました。