Wipo Pearl

@pipeworx/wipo-pearl

科学、技術、知的財産法務に関する用語を検索すると、信頼性評価、定義の文脈、使用上の注意、出典が付いた、10言語で検証済みの対応語を取得できます。プラットフォームキーを使用し、小規模なキー不要のフォールバックも備えています。

Pipeworx の一部です。Pipeworx は、AI エージェントを1843以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとは提携、承認、公開のいずれも行っていません。

ツール

• pearl_search_terms(term, source_language?, target_languages?, subject_field?, abbreviation?, exact_search?, limit?) — 用語を検索し、一致する概念レコード（概念 ID、一致した用語のテキスト、分野）を返します。
• pearl_concept(concept_id, lang_code?) — 1つの概念 ID（pearl_search_terms から取得）の完全なデータベースレコードを返します。各言語の対応語と、それぞれの信頼性評価、定義の文脈、使用上の注意、出典が含まれます。
• pearl_subject_fields() — 他の2つのツールが受け付ける29の分野コードと10の言語コードのリファレンス一覧を返します。引数はありません。

認証

プラットフォームキー（PLATFORM_WIPO_KEY）を使用し、_apiKey で独自のキーを指定できます。ほとんどのプラットフォームキーとは異なり、保存される値は単独のトークンではなく、JSON 文字列の {"client_id":"...","client_secret":"..."} です。これは、WIPO Business Partner Portal が単一のキーではなく、client_id と client_secret のペアとしてアプリケーションを発行するためです。呼び出しごとに JSON として解析し、OAuth2 の client_credentials を使用してペアを有効期間の短い Bearer JWT と交換します。トークンは呼び出し間でキャッシュされません。

有効化には1つではなく2つの段階があります。アプリケーションの登録は、API を呼び出せる状態になることと同じではありません。 Business Partner Portal（b2b.wipo.int）では登録後すぐに client_id と client_secret が発行されますが、アプリケーションを「WIPO Pearl API」製品／プランに登録する必要もあります。この登録は WIPO による審査と承認を経て初めて利用可能になるため、即時に完了するわけではなく、必ず承認される保証もありません。OAuth2 トークンエンドポイントで問題なく認証できる認証情報でも、登録がまだ承認されていなければ、Pearl API 自体から403が返されることがあります。このパッケージのエラーメッセージでは、単なる「アクセス拒否」ではなく、その状況を明確に伝えるため、こちら側の障害と誤解されません。プラットフォームキーも独自のキーも設定されていない場合、呼び出しは WIPO 自身が提供する少量のキー不要枠にフォールバックします。WIPO のポータルでは、登録が必要になるまで「1日あたり5リクエスト」と説明されています。これは一度限りの簡易テストにしか役立たず、共有ゲートウェイ経由の本番トラフィックには適しません。

データソース

• 世界知的所有権機関（WIPO）、WIPO Pearl 用語データベース — 29の分野にわたる、アラビア語、中国語、英語、フランス語、ドイツ語、日本語、韓国語、ポルトガル語、ロシア語、スペイン語の検証済み用語を25万件以上収録しています。

次の担当者への注意事項

• 2 つのツールは、認証情報がなくても同じようにアクセスできるわけではありません。 pearl_search_terms の基盤となる検索ルートは、認証情報なしのリクエストにも実際に 200 を返します（上記の「1 日あたり 5 件」の上限が適用されます）。 pearl_concept の基盤となる詳細ルートは、このパックの作成中に試した認証情報なしのリクエストすべてに対し、一律で 500 Internal Server Error を返しました。OAuth2 認証情報が必要と思われますが、認証情報がない場合に明確な 401/403 を返すのではなく、上流がエラーを返します。機能する認証情報なしで呼び出すと、このルートだけが「ダウン」しているように見える可能性があります。実際にはダウンしているのではなく、もう一方のルートとは異なる方法でアクセスが制限されています。
• 認証情報なしでの利用上限は、全体で共通の枠ではなく、呼び出し元の IP ごとに適用されます。 あるネットワーク経路から上限に達した際に 429（「Rate limit exceeded! You reached the limit of 5 requests per 1440 minutes」）が返る一方、別の送信元経路からの同一リクエストには 200 が返ることを確認しました。一方の経路が上限に達していても、API 全体がダウンしていると判断しないでください。
• 製品ページは Gravitee の開発者ポータル SPA であり、レンダリングされた HTML 内にエンドポイントはありません。 ライブエントリーポイント、OAuth2 トークンエンドポイント、完全なリクエスト／レスポンス仕様、subject フィールドと使用言語の各テーブルはすべて、ポータル独自のバックエンド REST API とドキュメントページ（assets/config.json、/apis/<id>、/apis/<id>/pages、およびポータル全体の FAQ ページ）から取得しました。具体的なページについては、src/index.ts のファイルヘッダーを参照してください。subject フィールドや使用言語専用のエンドポイントはありません。この 2 つのテーブルは、API 呼び出しではなく製品独自の「Data Models」ドキュメントページに掲載されているため、pearl_subject_fields はプロキシではなく静的データです。
• 認証済みの /records/{id} 呼び出しに対するレスポンス形式は、実際に確認したものではなく、製品の OpenAPI 仕様から推定しています。 このパックの作成時には、テストに使える認証情報がありませんでした。実際のレスポンスがドキュメントに記載された形式と一致しない場合、pearl_concept は成功したように見せかけて空の結果を返すのではなく、URL と本文の長さを示す明確な upstream_parse エラーを発生させます。そのため、形式の不一致は見過ごされず、最初の実際の呼び出し時に明らかになります。
• 検索レスポンスの hits／count は、仕様では整数とされていますが、JSON の文字列（"70" であり 70 ではありません）です。 Number() で解析しています。
• テストでは、上流独自の limit／count クエリパラメーターが安定して機能しませんでした。 どちらも指定しないリクエストで、仕様に記載されたデフォルトの 5 件ではなく、検索結果全件（45～70 件以上）が返りました。このパックでは両方を指定していますが、クライアント側でも結果を切り詰めるため、上流がどちらのパラメーターを適用するかにかかわらず、レスポンスサイズは制限されます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "wipo-pearl": {
      "url": "https://gateway.pipeworx.io/wipo-pearl/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/wipo-pearl/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx の共有メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で共通のツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共有ツールがおよそ30個表示されます。接続時の initialize 応答に正確な範囲が示されており、その日の状況を確認するうえで最も信頼できる情報です。

これは意図的なものであり、偶然多重化されているわけではありません。メタツールを使うと、このパックで扱っていない質問にも対応できます。ask_pipeworx がカタログ全体にルーティングするため、2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ1,843以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

MCP クライアントがなくても、HTTP で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/pearl_search_terms \
  -H 'Content-Type: application/json' \
  -d '{"term":"satellite","limit":5}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/pearl_search_terms を使用します。ツールを探すには、POST https://gateway.pipeworx.io/v1/tools/search_packs に {"query":"..."} を指定します。

単体での実行（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "wipo-pearl": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-wipo-pearl"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-wipo-pearl

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは、上記のパックエンドポイントでもフルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Wipo Pearl data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT