encyport

encyport

encyport は、Wikipedia をスクレイピングする手間を省くために、ユーザーやエージェントに代わって Wikipedia の情報を読み取ります。語句を指定すると一致する記事を検索し、記事名を指定すると、記事の本文、冒頭の要約だけ、セクションの概要、記事からリンクされているページ、または対象について記録された座標を返します。すべて en.wikipedia.org の公開 Wikipedia API を利用するため、登録も API キーも必要ありません。

インストール

npx @reneturcios/encyport search "analytical engine"

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/encyport

コンテナはデフォルトで MCP サーバーを起動します（以下を参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

すべてのコマンドは JSON を出力します。

# Search for articles
encyport search Ada Lovelace
encyport search black holes --limit 5

# Read a page four ways, plus its coordinates
encyport article Ada Lovelace
encyport summary Ada Lovelace
encyport sections Ada Lovelace
encyport links Ada Lovelace
encyport coordinates Eiffel Tower

encyport --version

記事名と検索語には空白を含められます。コマンド名の後のすべての文字列が連結され、1 つの語句として扱われます。終了コード：成功時は 0、検索に失敗した場合（ページが見つからない、またはメッセージに示される上流のエラー）は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

1 つのバイナリで両方の機能を提供します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/encyport mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "encyport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/encyport", "mcp"]
    }
  }
}

ツール

ツール	入力	戻り値
search_wikipedia	query（文字列、必須）、limit（整数、省略可）	一致した記事ごとに、記事名、ページ ID、整形済みのテキスト抜粋、単語数、最終更新日時を返します。
get_article	title（文字列、必須）	記事のプレーンテキスト全文を返します。
get_summary	title（文字列、必須）	記事の冒頭部分をプレーンテキストで返します。つまり、ほとんどの読者が「要約」と呼ぶ部分です。
get_sections	title（文字列、必須）	記事のセクション概要を返します。文書内の順に、セクション番号、見出し、見出しレベル、解析インデックスを示します。
get_links	title（文字列、必須）	この記事からリンクされているページを返します。各ページについて、名前空間とリンク先ページの有無も示します。
get_coordinates	title（文字列、必須）	ページに記録された緯度と経度の組を返します（対象に座標がない場合は空）。主座標にはフラグが付けられます。

記事名がリダイレクトされる場合は転送先をたどるため、一般的な名称や古い記事名でも現在の記事が見つかります。ページに解決できない記事名を指定すると、空の内容ではなくエラーが返されます。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network
npm run dev     # run the CLI from source via tsx

コアには差し替え可能な fetch 関数があり、テストスイートは実際の Wikipedia API レスポンスの形式に合わせた手書きのペイロードだけで動作します。テストでネットワークにアクセスすることはありません。

ライセンス

MIT — LICENSE を参照してください。