pp-wikipedia

Wikipedia — Printing Press CLI

前提条件：CLI をインストールする

このスキルは wikipedia-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使ってインストールします。デフォルトでは、macOS/Linux の場合は $HOME/.local/bin に、Windows の場合は %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

   npx -y @mvanhorn/printing-press-library install wikipedia --cli-only
   

2. 次のコマンドで確認します：wikipedia-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go による直接インストールに切り替えてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/wikipedia/cmd/wikipedia-pp-cli@latest

インストール後に --version が「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用しない場合

作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、メッセージの送信、予約、購入、またはリモートの状態の変更を伴うリクエストには、この CLI を使用しないでください。この印刷用 CLI で使えるのは、閲覧、エクスポート、同期、分析のための読み取り専用コマンドです。

コマンドリファレンス

feed — フィードを管理します

• wikipedia-pp-cli feed <day> — 指定した日に起きた出来事、誕生、死亡、祝日を返します。

page — 記事の内容とメタデータ

• wikipedia-pp-cli page get-html — 記事本文全体をスタイル付き HTML で返します。
• wikipedia-pp-cli page get-media — 記事に関連付けられた画像、動画、その他のメディアファイルを返します。
• wikipedia-pp-cli page get-random — ランダムな Wikipedia 記事の概要を返します。
• wikipedia-pp-cli page get-summary — タイトル、抜粋テキスト、サムネイル、座標を含むページの概要を返します。

適切なコマンドを見つける

何をしたいかはわかっていても、どのコマンドを使うのかわからない場合は、CLI に直接問い合わせてください。

wikipedia-pp-cli which "<capability in your own words>"

which は、自然言語での機能に関する問い合わせを、この CLI の厳選された機能インデックス内で最も適したコマンドに対応付けます。終了コード 0 は少なくとも 1 件の一致があることを示します。終了コード 2 は確度の高い一致がないことを示します。その場合は --help を確認するか、より具体的な問い合わせを使用してください。

認証の設定

認証は不要です。

wikipedia-pp-cli doctor を実行して、セットアップを確認してください。

エージェントモード

任意のコマンドに --agent を追加できます。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドの一部を保持します。ドット区切りのパスはネストされた構造をたどり、配列では各要素を順にたどります。冗長な API でコンテキストを小さく保つために重要です。

  wikipedia-pp-cli feed mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run はリクエストを送信せずに表示します

• オフラインで利用可能 — 同期／検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスのエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読める N results (live) の概要は、stdout がターミナルの場合に限り stderr に出力されます。パイプ／エージェントの利用者には、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

この CLI について気になる点に気付いた場合（エージェントが気付いた場合も含みます）、記録してください。

wikipedia-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
wikipedia-pp-cli feedback --stdin < notes.txt
wikipedia-pp-cli feedback list --json --limit 10

エントリーは ~/.wikipedia-pp-cli/feedback.jsonl にローカル保存されます。WIKIPEDIA_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか WIKIPEDIA_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルにのみ保存されます。

バグ報告ではなく、意外だったことを書いてください。簡潔で具体的に、一行で記録してください。積み重なるのは、そうした気付きです。

出力の配信

すべてのコマンドは --deliver <sink> を受け付けます。出力は、標準出力に加えて（または標準出力の代わりに）指定されたシンクに送られるため、エージェントはコマンドの結果を手動でパイプ処理せずに振り分けられます。次の3種類のシンクに対応しています。

シンク	動作
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイル＋リネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

未対応のスキームは、対応するスキームの一覧を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを標準エラー出力に記録します。

名前付きプロファイル

プロファイルは、保存しておき、複数回の実行で再利用できるフラグ値のセットです。スケジュールされたエージェントが、毎回同じ設定で同じコマンドを呼び出す場合に使用します。HeyGen の「Beacon」パターンに相当します。

wikipedia-pp-cli profile save briefing --json
wikipedia-pp-cli --profile briefing feed mock-value
wikipedia-pp-cli profile list --json
wikipedia-pp-cli profile show briefing
wikipedia-pp-cli profile delete briefing --yes

明示的に指定したフラグは、常にプロファイルの値より優先されます。プロファイルの値は、デフォルト値より優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles に一覧表示するため、実行時に情報を調べるエージェントがプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が正しくありません）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → wikipedia-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の「前提条件」を参照します
3. その他すべて → 直接使用（--agent を指定して CLI コマンドとして実行）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/other/wikipedia-pp-cli/cmd/wikipedia-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add wikipedia-pp-mcp -- wikipedia-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストール済みか確認します：which wikipedia-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある「前提条件」を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを指定して実行します。

   wikipedia-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：wikipedia-pp-cli <command> --help。