pp-pokeapi

PokéAPI — Printing Press CLI

前提条件：CLI のインストール

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

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

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

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

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

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

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

この CLI を使用する場面

完全にローカルで、あらゆる情報を照会できるポケモン図鑑が必要な場合に、この CLI を使用してください。ライブ API の呼び出しを消費せずにポケモンに関する質問に答えるエージェント、タイプ計算と習得技の絞り込みを組み合わせるバトル計画のワークフロー、そしてライブ REST API では標準で対応していない逆引き検索（技、特性、フォルム、条件を探す）に最適です。別のツールでスプライト表示に対応できるなど、画像だけを扱うワークフローでは使用しないでください。

この CLI を使用しない場面

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

独自の機能

この API に関する他のツールでは、これらの機能を利用できません。

ローカルストアの価値を高めるコマンド

• pokemon by-ability — 指定した特性を持つすべてのポケモンを検索します。ライブ API には逆引きインデックスがないため、ローカルストアに対する単一の SQL クエリで実行します。

  エージェントが何千回も API を呼び出さずに、特性でポケモンを列挙する必要がある場合に使用します。

  pokeapi-pp-cli pokemon by-ability levitate --json --select name,types
  

• move find — 状態異常、ダメージ分類、タイプ、または対象でわざを検索します。たとえば、はがねタイプをまひさせるすべてのわざを検索できます。

  わざの名前ではなく、効果を基準にしたバトル計画の質問に使用します。

  pokeapi-pp-cli move find --effect paralyze --type-target steel --json
  

• team suggest — 作成中のチームを指定すると、チームのタイプ相性の穴をどれだけ補えるかに基づいて、残りのすべてのポケモンを評価し、有力候補を返します。

  感覚に基づくおすすめではなく、チームの穴を補う効果の客観的な評価が必要なチーム構築エージェントに最適です。

  pokeapi-pp-cli team suggest pikachu,charizard --slots 6 --json --select name,types,score
  

• pokemon diff-learnset — 2 匹のポケモン（リージョンフォームやメガシンカの比較など）の習得わざを比較し、一方だけが習得できるわざを提示します。

  具体的なわざの根拠をもとに「なぜ Y ではなく X のフォルムを選ぶのか」を説明する必要がある場合に便利です。

  pokeapi-pp-cli pokemon diff-learnset charizard charizard-mega-x --json
  

• pokemon history — ポケモンが世代ごとにどう変化したかを表示します。タイプ、ステータス、特性の変更と、登場した世代を確認できます。

  ポケモンの歴史に関する質問（「ピッピは昔からフェアリータイプだったのか？」など）に答える場合に使用します。

  pokeapi-pp-cli pokemon history clefairy --json
  

• pokemon forms — ある種族のすべてのフォルム（ロコンとアローラロコンなど）を、タイプ、ステータス、特性の差分とともに一覧表示します。

  単一フォルムのデータではなく、種族全体についての回答が必要な場合に使用します。

  pokeapi-pp-cli pokemon forms vulpix --json
  

• evolve into — 進化先のポケモンを指定すると、そこへ進化するために必要なポケモンと条件（どうぐ、レベル、なつき度、時間帯）を提示します。

  ユーザーが進化先を知っていて、逆引きではなくそこに至る方法を知りたい場合に選択します。

  pokeapi-pp-cli evolve into umbreon --json
  

• team gaps — 作成中のチームが、防御面で耐性を持たず、攻撃面でも効果抜群にならない 18 タイプを一覧表示します。

  「このチーム編成の弱点として、相手チームに最も突かれそうなのは何か？」という質問に答える場合に使用します。

  pokeapi-pp-cli team gaps pikachu,charizard,blastoise --json
  

• encounters by-region — ロケーション、エリア、出現情報、種族を結合した地方単位の出現テーブルを表示します。たとえば、カントーで見つかるすべてのポケモンを確認できます。

  ポケモンごとではなく、地方に関する質問（「カントーではどんなポケモンを捕まえられる？」など）に使用します。

  pokeapi-pp-cli encounters by-region kanto --version red --json
  

エージェント向けの基盤機能

• search — ポケモン、わざ、特性、どうぐ、ロケーションを対象に、名前とフレーバーテキストを全文検索し、関連度順に表示します。

  名前が部分的、または曖昧な場合のエージェントのフォールバックとして使用します。複数の一覧取得と grep を置き換えます。

  pokeapi-pp-cli search "flame" --type move --limit 10 --json
  

• sql — ローカルストアに対する読み取り専用の SQL アクセスを提供します。上級ユーザーやエージェントは、CLI で直接実行できない結合を組み合わせられます。

  一度限りの質問に対応する専用サブコマンドがない場合に使用します。

  pokeapi-pp-cli sql "SELECT id FROM resources WHERE resource_type='pokemon' ORDER BY id LIMIT 10" --json
  

バトル計算

• damage — STAB、タイプ相性、レベル、種族値を考慮して、あるポケモンから別のポケモンへのわざの予想ダメージ範囲を計算します。

  「一撃で倒せるか？」や「X の Y に対するダメージはどれくらいか？」という形式のバトル計画の質問には、必ず使用します。

  pokeapi-pp-cli damage charizard blastoise hydro-pump --level1 50 --level2 50 --json
  

• pokemon top — ポケモンを種族値（こうげき、とくこう、すばやさ、HP など）で順位付けします。タイプによる絞り込みも可能で、上位 N 件を返します。

  環境を調べる場合や、チームの役割を担うポケモンを探す場合に、「Y の役割で最強の X タイプは？」という質問に使用します。

  pokeapi-pp-cli pokemon top --by special-attack --type ghost --limit 10 --json
  

コマンドリファレンス

ability — 特性を管理します

• pokeapi-pp-cli ability list — 特性は、バトル中やフィールド上でポケモンにパッシブ効果を与えます。ポケモンは複数の候補を持つ場合があります...
• pokeapi-pp-cli ability retrieve — 特性は、バトル中やフィールド上でポケモンにパッシブ効果を与えます。ポケモンは複数の候補を持つ場合があります...

berry — きのみを管理します

• pokeapi-pp-cli berry list — きのみは小さな果実で、HPや状態異常の回復、能力の強化、さらにはダメージを与える効果があります…
• pokeapi-pp-cli berry retrieve — きのみは小さな果実で、HPや状態異常の回復、能力の強化、さらにはダメージを与える効果があります…

berry-firmness — きのみの硬さを管理

• pokeapi-pp-cli berry-firmness list — きのみには柔らかいものや硬いものがあります。[Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Category:Berries_by_firmne...
• pokeapi-pp-cli berry-firmness retrieve — きのみには柔らかいものや硬いものがあります。[Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Category:Berries_by_firmne...

berry-flavor — きのみの味を管理

• pokeapi-pp-cli berry-flavor list — 味は、ポケモンの性格に基づいて、きのみを食べたときにポケモンが恩恵を受けるか、悪影響を受けるかを決定します。詳細はこちら…
• pokeapi-pp-cli berry-flavor retrieve — 味は、ポケモンの性格に基づいて、きのみを食べたときにポケモンが恩恵を受けるか、悪影響を受けるかを決定します。詳細はこちら…

characteristic — 特性を管理

• pokeapi-pp-cli characteristic list — 性格は、ポケモンの個体値が最も高い能力を示します。ポケモンの性格は…
• pokeapi-pp-cli characteristic retrieve — 性格は、ポケモンの個体値が最も高い能力を示します。ポケモンの性格は…

contest-effect — コンテスト効果を管理

• pokeapi-pp-cli contest-effect list — コンテスト効果は、コンテストで技を使用したときの効果を指します。
• pokeapi-pp-cli contest-effect retrieve — コンテスト効果は、コンテストで技を使用したときの効果を指します。

contest-type — コンテストの種類を管理

• pokeapi-pp-cli contest-type list — コンテストの種類は、ポケモンコンテストで審査員がポケモンのコンディションを評価する際に使うカテゴリーです。詳細はこちら…
• pokeapi-pp-cli contest-type retrieve — コンテストの種類は、ポケモンコンテストで審査員がポケモンのコンディションを評価する際に使うカテゴリーです。詳細はこちら…

egg-group — タマゴグループを管理

• pokeapi-pp-cli egg-group list — タマゴグループは、どのポケモン同士がタマゴを作れるかを決めるカテゴリーです。ポケモンは1つまたは…
• pokeapi-pp-cli egg-group retrieve — タマゴグループは、どのポケモン同士がタマゴを作れるかを決めるカテゴリーです。ポケモンは1つまたは…

encounter-condition — 遭遇条件を管理

• pokeapi-pp-cli encounter-condition list — 野生で出現するポケモンに影響する条件です。たとえば、昼か夜かなどです。
• pokeapi-pp-cli encounter-condition retrieve — 野生で出現するポケモンに影響する条件です。たとえば、昼か夜かなどです。

encounter-condition-value — 遭遇条件の値を管理

• pokeapi-pp-cli encounter-condition-value list — 遭遇条件の値は、遭遇条件が取りうるさまざまな状態です。たとえば、時間帯の場合は…
• pokeapi-pp-cli encounter-condition-value retrieve — 遭遇条件の値は、遭遇条件が取りうるさまざまな状態です。たとえば、時間帯の場合は…

encounter-method — 遭遇方法を管理

• pokeapi-pp-cli encounter-method list — プレイヤーが野生のポケモンに遭遇する方法です。たとえば、背の高い草むらを歩く方法があります。詳細はこちら…
• pokeapi-pp-cli encounter-method retrieve — プレイヤーが野生のポケモンに遭遇する方法です。たとえば、背の高い草むらを歩く方法があります。詳細はこちら…

evolution-chain — 進化系統を管理

• pokeapi-pp-cli evolution-chain list — 進化系統は、いわば家系図です。系統の最も低い段階から始まり、進化の過程を詳しく説明します…
• pokeapi-pp-cli evolution-chain retrieve — 進化系統は、いわば家系図です。系統の最も低い段階から始まり、進化の過程を詳しく説明します…

evolution-trigger — 進化のきっかけを管理

• pokeapi-pp-cli evolution-trigger list — 進化トリガーとは、ポケモンが進化するきっかけとなるイベントや条件です。詳しくは…
• pokeapi-pp-cli evolution-trigger retrieve — 進化トリガーとは、ポケモンが進化するきっかけとなるイベントや条件です。詳しくは…

gender — 性別を管理

• pokeapi-pp-cli gender list — 性別はポケモンの繁殖を目的として第 II 世代で導入されましたが、見た目の違いを生じさせることもあります…
• pokeapi-pp-cli gender retrieve — 性別はポケモンの繁殖を目的として第 II 世代で導入されましたが、見た目の違いを生じさせることもあります…

generation — 世代を管理

• pokeapi-pp-cli generation list — 世代とは、登場するポケモンを基準にポケモンゲームを分類したものです。それぞれの…
• pokeapi-pp-cli generation retrieve — 世代とは、登場するポケモンを基準にポケモンゲームを分類したものです。それぞれの…

growth-rate — 成長率を管理

• pokeapi-pp-cli growth-rate list — 成長率とは、ポケモンが経験値を通じてレベルを上げる速さです。詳しくは…
• pokeapi-pp-cli growth-rate retrieve — 成長率とは、ポケモンが経験値を通じてレベルを上げる速さです。詳しくは…

item — アイテムとは、ゲーム内でプレイヤーが拾い、バッグに入れて、何らかの方法で使用できるオブジェクトです。回復やパワーアップ、ポケモンの捕獲の補助、新しいエリアへのアクセスなど、さまざまな用途があります。

• pokeapi-pp-cli item list — アイテムとは、ゲーム内でプレイヤーが拾い、バッグに入れて、何らかの方法で使用できるオブジェクトです。…
• pokeapi-pp-cli item retrieve — アイテムとは、ゲーム内でプレイヤーが拾い、バッグに入れて、何らかの方法で使用できるオブジェクトです。…

item-attribute — アイテム属性を管理

• pokeapi-pp-cli item-attribute list — アイテム属性は、「バトルで使用可能」や「消耗品」など、アイテムの特定の側面を定義します。
• pokeapi-pp-cli item-attribute retrieve — アイテム属性は、「バトルで使用可能」や「消耗品」など、アイテムの特定の側面を定義します。

item-category — アイテムカテゴリーを管理

• pokeapi-pp-cli item-category list — アイテムカテゴリーによって、プレイヤーのバッグ内でアイテムを収納する場所が決まります。
• pokeapi-pp-cli item-category retrieve — アイテムカテゴリーによって、プレイヤーのバッグ内でアイテムを収納する場所が決まります。

item-fling-effect — アイテム投げの効果を管理

• pokeapi-pp-cli item-fling-effect list — さまざまなアイテムを使ったときの技「なげつける」の各種効果です。
• pokeapi-pp-cli item-fling-effect retrieve — さまざまなアイテムを使ったときの技「なげつける」の各種効果です。

item-pocket — アイテムポケットを管理

• pokeapi-pp-cli item-pocket list — カテゴリーごとにアイテムを収納する、プレイヤーのバッグ内のポケットです。
• pokeapi-pp-cli item-pocket retrieve — カテゴリーごとにアイテムを収納する、プレイヤーのバッグ内のポケットです。

language — 言語を管理

• pokeapi-pp-cli language list — API リソース情報の翻訳に使用する言語です。
• pokeapi-pp-cli language retrieve — API リソース情報の翻訳に使用する言語です。

location — ゲーム内で訪れることができる場所です。場所は、都市や道路など、地域の大部分を構成します。

• pokeapi-pp-cli location list — ゲーム内で訪れることができる場所です。場所は、都市や道路など、地域の大部分を構成します。
• pokeapi-pp-cli location retrieve — ゲーム内で訪れることができる場所です。場所は、都市や道路など、地域の大部分を構成します。

location-area — エリアを管理

• pokeapi-pp-cli location-area list — ロケーションエリアとは、建物や洞窟のフロアなど、エリアを区分したものです。各エリアには、それぞれ固有の可能な…

• pokeapi-pp-cli location-area retrieve — ロケーションエリアとは、建物や洞窟のフロアなど、エリアを区分したものです。各エリアには、それぞれ固有の可能な… machine — マシンは、ポケモンにわざを覚えさせる道具を表します。バージョンによって異なるため、特定のTMまたはHMが単一のマシンに対応するとは限りません。

• pokeapi-pp-cli machine list — マシンは、ポケモンにわざを覚えさせる道具を表します。バージョンによって異なるため、...

• pokeapi-pp-cli machine retrieve — マシンは、ポケモンにわざを覚えさせる道具を表します。バージョンによって異なるため、...

meta — メタデータを管理

• pokeapi-pp-cli meta — Git のコミットハッシュ、デプロイ日、タグなど、現在デプロイされている API のバージョンに関するメタデータを返します...

move — わざは、バトルでポケモンが使う技です。バトルでは、ポケモンは毎ターン1つのわざを使います。隠しマシンで覚えるものを含む一部のわざは、障害物を取り除いたり、新しいエリアを探索したりする目的で、バトル以外でも使えます。

• pokeapi-pp-cli move list — わざは、バトルでポケモンが使う技です。バトルでは、ポケモンは毎ターン1つのわざを使います。隠しマシンで覚えるものを含む一部の...
• pokeapi-pp-cli move retrieve — わざは、バトルでポケモンが使う技です。バトルでは、ポケモンは毎ターン1つのわざを使います。隠しマシンで覚えるものを含む一部の...

move-ailment — わざによる状態異常を管理

• pokeapi-pp-cli move-ailment list — わざの状態異常は、バトル中に使われたわざによって引き起こされる状態異常です。詳細は...
• pokeapi-pp-cli move-ailment retrieve — わざの状態異常は、バトル中に使われたわざによって引き起こされる状態異常です。詳細は...

move-battle-style — わざのバトルスタイルを管理

• pokeapi-pp-cli move-battle-style list — バトルパレスでわざを使う際のスタイルです。詳しくは[Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Battle_Fronti...を参照してください。
• pokeapi-pp-cli move-battle-style retrieve — バトルパレスでわざを使う際のスタイルです。詳しくは[Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Battle_Fronti...を参照してください。

move-category — わざのカテゴリを管理

• pokeapi-pp-cli move-category list — わざの効果を大まかに分類する、非常に一般的なカテゴリです。
• pokeapi-pp-cli move-category retrieve — わざの効果を大まかに分類する、非常に一般的なカテゴリです。

move-damage-class — わざのダメージ分類を管理

• pokeapi-pp-cli move-damage-class list — わざのダメージ分類です。たとえば、物理、特殊、またはダメージを与えないものがあります。
• pokeapi-pp-cli move-damage-class retrieve — わざのダメージ分類です。たとえば、物理、特殊、またはダメージを与えないものがあります。

move-learn-method — わざの習得方法を管理

• pokeapi-pp-cli move-learn-method list — ポケモンがわざを覚える方法です。
• pokeapi-pp-cli move-learn-method retrieve — ポケモンがわざを覚える方法です。

move-target — わざの対象を管理

• pokeapi-pp-cli move-target list — バトル中にわざを向ける対象です。対象はポケモン、環境、またはほかのわざの場合もあります。
• pokeapi-pp-cli move-target retrieve — バトル中にわざを向ける対象です。対象はポケモン、環境、またはほかのわざの場合もあります。

nature — 性格を管理

• pokeapi-pp-cli nature list — 性格はポケモンの能力値の伸び方に影響します。詳しくはBulbapediaを参照してください...
• pokeapi-pp-cli nature retrieve — 性格はポケモンの能力値の伸び方に影響します。詳しくはBulbapediaを参照してください...

pal-park-area — パルパークのエリアを管理

• pokeapi-pp-cli pal-park-area list — パルパークでのポケモンとの遭遇を分類するエリアです。パルパーク専用の生息地のようなものです。
• pokeapi-pp-cli pal-park-area retrieve — パルパークでのポケモンとの遭遇を分類するエリアです。パルパーク専用の生息地のようなものです。

pokeathlon-stat — ポケスロンの能力値を管理

• pokeapi-pp-cli pokeathlon-stat list — ポケスロンのステータスは、ポケスロンにおけるポケモンのパフォーマンスを示すさまざまな属性です。ポケスロンでは、競技が開催されます……
• pokeapi-pp-cli pokeathlon-stat retrieve — ポケスロンのステータスは、ポケスロンにおけるポケモンのパフォーマンスを示すさまざまな属性です。ポケスロンでは、競技が開催されます……

pokedex — 図鑑を管理

• pokeapi-pp-cli pokedex list — ポケモン図鑑は、情報を記録して保持できる携帯型の電子百科事典です……
• pokeapi-pp-cli pokedex retrieve — ポケモン図鑑は、情報を記録して保持できる携帯型の電子百科事典です……

pokemon — ポケモンは、ポケモンのゲームの世界に生息する生き物です。モンスターボールで捕まえ、ほかのポケモンとのバトルで育てることができます。それぞれのポケモンは特定の種に属しますが、同じ種のほかのポケモンとは、基本ステータスや使用可能な特性、タイプなどが異なる姿をとることがあります。詳しくはBulpapediaをご覧ください。

• pokeapi-pp-cli pokemon list — ポケモンは、ポケモンのゲームの世界に生息する生き物です。モンスターボールで捕まえ、……
• pokeapi-pp-cli pokemon retrieve — ポケモンは、ポケモンのゲームの世界に生息する生き物です。モンスターボールで捕まえ、……

pokemon-color — ポケモンの色を管理

• pokeapi-pp-cli pokemon-color list — ポケモン図鑑でポケモンを分類するために使われる色です。図鑑に記載される色は、通常、最も目立つ色です……
• pokeapi-pp-cli pokemon-color retrieve — ポケモン図鑑でポケモンを分類するために使われる色です。図鑑に記載される色は、通常、最も目立つ色です……

pokemon-form — ポケモンのフォルムを管理

• pokeapi-pp-cli pokemon-form list — 一部のポケモンは、見た目の異なる複数のフォルムのうちいずれかで現れることがあります。こうした違いは純粋に見た目だけのものです。……
• pokeapi-pp-cli pokemon-form retrieve — 一部のポケモンは、見た目の異なる複数のフォルムのうちいずれかで現れることがあります。こうした違いは純粋に見た目だけのものです。……

pokemon-habitat — ポケモンの生息地を管理

• pokeapi-pp-cli pokemon-habitat list — 生息地は一般に、ポケモンが見つかるさまざまな地形を指しますが、珍しいポケモンなどのために指定された場所を指すこともあります……
• pokeapi-pp-cli pokemon-habitat retrieve — 生息地は一般に、ポケモンが見つかるさまざまな地形を指しますが、珍しいポケモンなどのために指定された場所を指すこともあります……

pokemon-shape — ポケモンの形を管理

• pokeapi-pp-cli pokemon-shape list — ポケモン図鑑でポケモンを分類するために使われる形です。
• pokeapi-pp-cli pokemon-shape retrieve — ポケモン図鑑でポケモンを分類するために使われる形です。

pokemon-species — ポケモンの種を管理

• pokeapi-pp-cli pokemon-species list — ポケモンの種は、少なくとも1種類のポケモンの基礎となります。ポケモンの種の属性は、すべての……
• pokeapi-pp-cli pokemon-species retrieve — ポケモンの種は、少なくとも1種類のポケモンの基礎となります。ポケモンの種の属性は、すべての……

region — 地方を管理

• pokeapi-pp-cli region list — 地方は、ポケモンの世界を区分した地域です。地方ごとの主な違いは、多くの場合、登場する種です……
• pokeapi-pp-cli region retrieve — 地方は、ポケモンの世界を区分した地域です。地方ごとの主な違いは、多くの場合、登場する種です……

stat — ステータスを管理

• pokeapi-pp-cli stat list — ステータスは、バトルの特定の要素を決定します。各ポケモンは各ステータスの値を持ち、レベルが上がるにつれて成長します……
• pokeapi-pp-cli stat retrieve — ステータスは、バトルの特定の要素を決定します。各ポケモンは各ステータスの値を持ち、レベルが上がるにつれて成長します……

super-contest-effect — スーパーコンテストの効果を管理

• pokeapi-pp-cli super-contest-effect list — スーパーコンテストの効果は、スーパーコンテストで技を使ったときの効果を指します。
• pokeapi-pp-cli super-contest-effect retrieve — スーパーコンテストの効果は、スーパーコンテストで技を使ったときの効果を指します。

type — タイプを管理

• pokeapi-pp-cli type list — タイプは、ポケモンとその技の特性です。各タイプには3つの特性があります。どのタイプのポケモンに対して……
• pokeapi-pp-cli type retrieve — タイプは、ポケモンとその技の特性です。各タイプには3つの特性があります。どのタイプのポケモンに対して……

version — バージョンを管理

• pokeapi-pp-cli version game-list — 赤・青・黄など、ゲームのバージョンです。
• pokeapi-pp-cli version game-retrieve — 赤・青・黄など、ゲームのバージョンです。

version-group — バージョングループを管理

• pokeapi-pp-cli version-group list — バージョングループは、よく似たゲームのバージョンを分類します。
• pokeapi-pp-cli version-group retrieve — バージョングループは、よく似たゲームのバージョンを分類します。

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

やりたいことは分かっているものの、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。

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

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も適合するコマンドに対応付けます。終了コード 0 は少なくとも1つの候補が見つかったことを意味し、終了コード 2 は確度の高い候補が見つからなかったことを意味します。その場合は --help を使うか、より絞り込んだ問い合わせをしてください。

レシピ

チームの弱点になっているタイプは？

pokeapi-pp-cli team gaps pikachu,charizard,blastoise --json

チームに耐性も、効果抜群の攻撃手段もないタイプをすべて返します。ローカルでの結合処理は1回です。

効果から逆引きする

pokeapi-pp-cli move find --effect paralyze --type-target steel --json --select name,type,power,accuracy

Steel に命中する、まひ状態にする技を検索します。エージェントのコンテキストを絞るために --select を使います。

エージェントに必要な情報だけにプロフィールを絞る

pokeapi-pp-cli pokemon profile pikachu --json --select name,types,stats.hp,stats.attack,abilities

ドット区切りのパスを指定した --select を使い、深くネストされたレスポンスから重要なフィールドだけを取り出します。これにより、エージェントのコンテキストを軽量に保てます。

2つの地域フォームを比較する

pokeapi-pp-cli pokemon diff-learnset vulpix vulpix-alola --json

Vulpix と Alolan Vulpix の習得技を並べて比較します。API から2回全件取得する代わりに、ローカルで1回クエリします。

SQL を使ったカスタム結合

pokeapi-pp-cli sql "SELECT id FROM resources WHERE resource_type='pokemon-species' ORDER BY id LIMIT 10" --json

専用コマンドがない場合は、直接 SQL を使います。読み取り専用で、ローカルストアに直接アクセスします。

認証の設定

認証は不要です。

pokeapi-pp-cli doctor を実行して、設定を確認してください。

エージェントモード

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

• パイプ対応 — JSON は stdout に、エラーは stderr に出力されます

• フィルター対応 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。レスポンスが冗長な API でコンテキストを小さく保つうえで重要です。

  pokeapi-pp-cli ability list --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 に問題があることに気付いたら（エージェントが気付いた場合も）、記録してください。

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

記録はローカルの ~/.pokeapi-pp-cli/feedback.jsonl に保存されます。POKEAPI_FEEDBACK_ENDPOINT が設定され、かつ --send が指定されるか POKEAPI_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトではローカルにのみ保存されます。

バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1行で。それが積み重なって価値になります。

出力の配信

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

シンク	効果
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

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

名前付きプロファイル

プロファイルは保存済みのフラグ値のセットで、実行のたびに再利用できます。同じ設定で同じコマンドを毎回呼び出すスケジュール済みエージェントには、HeyGen の「Beacon」パターンのようにプロファイルを使用してください。

pokeapi-pp-cli profile save briefing --json
pokeapi-pp-cli --profile briefing ability list
pokeapi-pp-cli profile list --json
pokeapi-pp-cli profile show briefing
pokeapi-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

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

2. Claude Code に登録します。

   claude mcp add pokeapi-pp-mcp -- pokeapi-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

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

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