pp-isitagentready

Is It Agent Ready — Printing Press CLI

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

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

1. Printing Press インストーラーを使ってインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

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

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

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールする方法に切り替えてください（Go 1.26.6 以降が必要です）。この方法では $GOPATH/bin（既定では $HOME/go/bin）にインストールされるため、代わりにそのディレクトリを $PATH に追加してください。

go install github.com/mvanhorn/printing-press-library/library/developer-tools/isitagentready/cmd/isitagentready-pp-cli@latest

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

isitagentready.com と is-agentic.com は、それぞれブラウザーのタブで一度限りのスコアを提示しますが、記憶機能はなく、互いの存在も把握していません。この CLI は両方を、繰り返し実行できるひとつのワークフローにまとめます。どのサイトもいずれかのスキャナーでチェックし、優先度順の修正案とアドバイスを取得し、CI でゲートし、経時的に差分を確認し、競合他社と比較し、サイト群全体を一括スキャンできます。スキャンはすべてローカルに保存され、ソース別にタグ付けされるため、履歴と未解決アドバイスから、何が変わったのか、何がまだ修正されていないのかを正確に把握できます。

2 つのスキャナーの結果は一致しませんが、それがこの仕組みの狙いです。isitagentready.com は、固定された 5 つのカテゴリで Level 0-5 を報告します。一方、is-agentic.com は、サイトごとに該当しないチェックを除外した分母に対して、0-100 のスコアを報告します。この CLI は両者を平均したり、尺度を変換したりしません。crossref は両方のネイティブな判定結果を並べて表示し、実際に同じ項目を測定している 4 つのチェックについてのみ、一致を判定します。

この CLI を使用する場面

ウェブサイトの AI エージェント対応状況を確認または改善する必要がある場合に使用してください。robots.txt、llms.txt、MCP、OAuth、コマースプロトコルへの対応状況をスキャンする、レベルを上げるためにコピーして使える修正案を取得する、対応状況に基づいてデプロイをゲートする、サイトのスコアを経時的に追跡する、複数のサイトを比較するといった用途に適しています。提示された修正を適用するコーディングエージェント内での利用に最適です。

使用しない場面

次の用途にはこの CLI を使用しないでください。

• llms.txt または robots.txt ファイルを一から生成する場合（この CLI はスキャンとアドバイスを行いますが、ファイル自体は作成しません）。
• ChatGPT や Perplexity が自社ブランドを引用しているかを追跡する場合（これは AI 可視性の追跡であり、別の製品です）。
• 一般的な SEO キーワード順位やバックリンクを監査する場合。
• エージェントが読み込むためにページのコンテンツを Markdown として取得する場合（これはスキャナーではなく、対象サイト上の Markdown ネゴシエーション機能です）。

独自の機能

これらの機能は、この API を扱う他のツールでは利用できません。

リグレッションを防いでリリースする

• gate — サイトの対応レベルが目標を下回った場合や、以前は合格していたチェックがリグレッションした場合に、ビルドを失敗させます。

  JSON を壊れやすい grep で調べるのではなく、決定的な終了コードが必要な CI で使用してください。

  isitagentready-pp-cli gate https://isitagentready.com --min-level 3
  

• open-advice — スキャンしたすべてのサイトでまだ失敗しているチェックと、それぞれの修正プロンプトを一覧表示するため、残作業を正確に把握できます。

  すべてのサイトに残っている修正を 1 つのコマンドで確認したい場合に使用してください。

  isitagentready-pp-cli open-advice --agent
  

対応状況を経時的に追跡する

• history — サイトの過去すべてのスキャンにおける対応レベルを表示し、スキャン間で合否が切り替わったチェックを示します。

  修正が実際に反映されたことを確認し、気づきにくいリグレッションを検出するために使用してください。

  isitagentready-pp-cli history https://example.com --agent
  

• diff — サイトの 2 回分のスキャン（既定では最新の 2 回）を比較し、チェックごとのリグレッション／修正済み／変更なしの表と、レベルの差分を表示します。

  新しいスコアだけでなく、2 つの時点の間に何が変わったのかを正確に確認するために使用してください。

  isitagentready-pp-cli diff https://example.com
  

複数のサイトを横断

• compare — 複数のサイトをスキャンし、各サイトがどのエージェント標準を実装しているかをチェックごとのマトリクスで表示するとともに、各サイトのレベルも表示します。

  競合他社が実装していて、自社ではまだ実装していない標準を正確に把握するには、このコマンドを使います。

  isitagentready-pp-cli compare https://example.com https://isitagentready.com
  

• batch — ファイルまたは stdin から URL のリストをスキャンしてそれぞれを保存し、レベルまたは失敗したチェック数の順に並べたリーダーボードを表示します。

  サイトを1つずつブラウザーのタブでスキャンするのではなく、Web サイト全体を問題の深刻な順に優先度付けしてトリアージするには、このコマンドを使います。

  isitagentready-pp-cli batch urls.txt --rank failing --csv
  

2つのスキャナーを相互照合

• crossref — 1つの URL について、isitagentready.com のレベル 0～5 と is-agentic.com のスコア 0～100 を、それぞれの固有の尺度のまま並べて表示します。2つのスコアを統合せず、実際に同じ項目を測定している4つのチェックについて一致判定も表示します。

  一方のスキャナーでは問題ないと表示されたものの、2つのスコアが同じ数値であるかのように扱わずに、セカンドオピニオンを得たい場合にこのコマンドを使います。

  isitagentready-pp-cli crossref https://example.com
  

• --source is-agentic — スキャン結果に基づく任意のコマンドを2つ目のスキャナーで実行します。保存された各スキャンにはソースがタグ付けされるため、history、diff、gate、compare、batch は同じスキャナーの尺度内で処理され、2つの尺度が暗黙に混在することはありません。実行中のすべての is-agentic リクエスト（並行実行される compare と batch の一括リクエストを含む）は、1つの共有クライアントを経由します。これにより、プロセス全体がホストの公開レポート向けに告知されている毎秒2リクエストの制限内に収まり、リクエストが競合して 429 エラーになるのを防ぎます。

  すでに isitagentready を追跡しているのと同じ方法で、is-agentic を継続的に追跡するには、このオプションを使います。

  isitagentready-pp-cli report https://example.com --source is-agentic
  

コマンドリファレンス

scan — AI エージェント対応状況についてウェブサイトをスキャンします

• isitagentready-pp-cli scan — URL をスキャンし、対応レベル（0～5）と5つのカテゴリーにわたるチェックごとの結果を返します

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

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

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

which は、自然言語で指定した機能の問い合わせを、この CLI の厳選された機能インデックスから最も適したコマンドに対応付けます。終了コード 0 は1つ以上の一致があったことを示し、終了コード 2 は確信を持てる一致がなかったことを示します。一致がない場合は --help に戻るか、より対象を絞った問い合わせを使ってください。

レシピ

サイトに適用する修正をコピー＆ペースト用に取得する

isitagentready-pp-cli advice https://example.com --copy

次のレベルに進むための修正プロンプトをすべて、コーディングエージェントに貼り付けられる1つのブロックとして出力します。

すべてのサイトで未修正の項目を確認する

isitagentready-pp-cli open-advice --agent

ローカルのスキャン履歴から、まだ失敗しているすべてのチェックとその修正プロンプトをサイト横断で一覧表示します。

詳細なスキャン結果から必要なチェックだけに絞り込む

isitagentready-pp-cli report https://example.com --agent --only-failing --select checks.discovery.mcpServerCard.status,checks.discovery.mcpServerCard.message

完全なスキャン結果は大きく、深くネストされています。--select を使うと、必要なドット区切りのフィールドだけを取得できるため、エージェントが数十 KB のデータを解析せずに済みます。

対応状況をデプロイの条件にする

isitagentready-pp-cli gate https://example.com --min-level 3 --no-regress

サイトがレベル3未満の場合、または以前は合格していたチェックが退行した場合に、ゼロ以外の終了コードで終了します。CI で安全に使用できます。

競合他社と比較する

isitagentready-pp-cli compare https://example.com https://isitagentready.com

各サイトがどのエージェント対応チェックを実装しているか、標準ごとのマトリクスで表示します。

2つのスキャナーでサイトを相互照合する

isitagentready-pp-cli crossref https://example.com

isitagentready のレベル 0～5 と is-agentic のスコア 0～100 を、別々の固有の判定結果として表示した後、実際に両方のスキャナーが測定している4つのチェックについて一致表を表示します。2つのスコアを平均したり、尺度を換算したりすることはありません。分母が異なるためです（固定された5つのカテゴリーと、該当しないチェックを除いたサイトごとのチェック項目）。URL に対するレポートが一方のスキャナーにない場合でも、もう一方の結果は表示されます。

2つ目のスキャナーを継続的に追跡する

isitagentready-pp-cli check https://example.com --source is-agentic
isitagentready-pp-cli history https://example.com --source is-agentic

--source is-agentic を指定すると、check は is-agentic 独自の判定結果を表示します。具体的には、スコアとラベル、必須／推奨のティア別内訳、不合格となった各項目とその修正方法です。2つの尺度が同じ意味を示すものではないため、isitagentready のレベルは表示しません。

各スキャンはソースとともに保存され、読み込み時には必ず1つのソースに絞り込まれるため、is-agentic の履歴と isitagentready の履歴が混在することはありません。--source を省略すると、これまでの isitagentready の動作が維持されます。これは、この機能が追加される前に記録されたスキャンにも適用されます。

is-agentic スコアで CI をゲートする

isitagentready-pp-cli gate https://example.com --source is-agentic --min-score 70

--min-score は is-agentic のしきい値で、--min-level は isitagentready のしきい値です。誤った組み合わせ（--source is-agentic で --min-level を指定すること）は、黙って解釈し直すのではなく、使用法エラーになります。Level 3 とスコア 70 は同じ主張ではないためです。

認証の設定

API キーもログインも不要です。スキャンエンドポイントは公開されており、読み取り専用なので、すべてのコマンドをすぐに実行できます。

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

エージェントモード

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

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

• フィルタ可能 — --select でフィールドを絞り込めます。ドット区切りのパスでネストされた構造をたどり、配列は各要素を順にたどります。出力が多い API でコンテキストを小さく保つのに重要です：

  isitagentready-pp-cli scan --url https://example --agent --select id,name,status
  

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

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

• 明示的な再試行 — すでに存在するリソースの作成を成功として扱う場合に限り、--idempotent を使用します

パスと状態

エージェントは、CLI のパス解決機能をランタイム契約の一部として扱ってください。

• 1 回の実行には --home <dir> を使用するか、ISITAGENTREADY_HOME=<dir> を設定して、4 種類すべてのパスを 1 つのルート配下に移動します。

• 特定の種類のパスだけを分ける必要がある場合に限り、種類ごとの環境変数を使用します：ISITAGENTREADY_CONFIG_DIR、ISITAGENTREADY_DATA_DIR、ISITAGENTREADY_STATE_DIR、ISITAGENTREADY_CACHE_DIR。

• 解決順序は、種類ごとの環境変数、--home、ISITAGENTREADY_HOME、XDG（XDG_CONFIG_HOME、XDG_DATA_HOME、XDG_STATE_HOME、XDG_CACHE_HOME）、プラットフォームのデフォルト設定です。

• config には config.toml やプロファイルなどの設定が含まれます。data には credentials.toml、data.db、Cookie、認証サイドカーが含まれます。state には永続化されたクエリ、ジョブ、teach.log が含まれます。cache には再生成可能な HTTP／キャッシュファイルが含まれます。

• 保存されたシークレットは、data ディレクトリ内の credentials.toml に格納されます。既存のレガシーな config.toml 内のシークレットは互換性のために読み込まれ、最初の認証情報書き込み時に config.toml から移動します。

• isitagentready-pp-cli doctor --fail-on warn を実行すると、パスと認証情報の保存場所に関する警告が表示されます。agent-context は、解決済みのディレクトリを必要とするエージェント向けに、スキーマ v4 の paths ブロックを公開します。

• MCP の場合、移動先は MCP ホストの設定で指定してください。MCP バイナリは CLI フラグを継承しません：

  {
    "mcpServers": {
      "isitagentready": {
        "command": "isitagentready-pp-mcp",
        "env": {
          "ISITAGENTREADY_HOME": "/srv/isitagentready"
        }
      }
    }
  }
  

フリートでの優先順位：継承された種類ごとの環境変数は、その種類について明示的に指定された --home より優先されます。永続的なフリート設定には ISITAGENTREADY_HOME または種類ごとの変数を使用し、--home は 1 回の実行に限って使用してください。環境変数の設定を解除しても、移動は元に戻りません。ISITAGENTREADY_HOME をクリアする前にファイルを手動で移動してください。そうしないと、doctor は以前のルートに残された認証情報を見つけられません。

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

この CLI に問題があることに気付いたら、あなた（またはエージェント）が記録してください：

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

エントリは、解決済みの data ディレクトリ内にある feedback.jsonl にローカル保存されます。ISITAGENTREADY_FEEDBACK_ENDPOINT が設定され、かつ --send が指定されているか、ISITAGENTREADY_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカルのみです。

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

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定したシンクへ送られるため、エージェントはコマンド結果をパイプで手動転送せずにルーティングできます。次の 3 種類のシンクがサポートされています：

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

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

名前付きプロファイル

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

isitagentready-pp-cli profile save briefing --json
isitagentready-pp-cli --profile briefing scan --url https://example
isitagentready-pp-cli profile list --json
isitagentready-pp-cli profile show briefing
isitagentready-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

   go install github.com/mvanhorn/printing-press-library/library/developer-tools/isitagentready/cmd/isitagentready-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add isitagentready-pp-mcp -- isitagentready-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

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

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