pp-apify

Apify — Printing Press CLI

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

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

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

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

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

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

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

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

この CLI を使用する場面

定期的な調査、スクレイピング、ニュースレターのパイプラインの一環として、複数の Apify Actor を連携させる必要がある場合は、apify-pp-cli を使用してください。実行ごとのコストを把握したい場合、新規項目のみを出力したい場合、複数の Actor を横断して検索したい場合、またはスケジュールをコードとして管理したい場合に適しています。Actor を開発する（独自のスクレイパーを作成する）場合は、公式の apify-cli を使用してください。この CLI はプラットフォーム運用者向けです。

独自の機能

この API の他のツールでは、以下の機能を利用できません。

蓄積されるローカル状態

• run — Actor を実行し、その Actor の過去の実行で確認済みの項目を除いて出力します。

  ニュースレターやアラートのワークフロー向けに、定期的なスクレイピングで「前回の実行以降に何が新しくあったか」を把握したい場合に使用してください。

  apify-pp run trudax/reddit-scraper --input @sub-list.json --only-new --format markdown
  

• search items — すべての Actor のキャッシュ済みデータセットを横断して全文検索し、共通スキーマに正規化します。

  8 つのデータセット ID を使い分けることなく、「今週、X について誰が何を言っていたか」を調べたい場合に使用してください。

  apify-pp search "model context protocol" --since 7d --actors twitter,reddit,hn --json --select url,title,source_actor
  

• digest --offline — API にアクセスせず、過去のデータセットのローカル SQLite コピーを使ってクエリやテンプレートのレンダリングを実行します。

  テンプレートや重複排除のヒューリスティクスを調整する際に、コストをかけずに反復作業を行えます。

  apify-pp digest --offline --topic AI --since 7d --template draft.tmpl
  

コスト管理

• cost report — キャッシュされた実行メタデータと Apify の月次使用量エンドポイントを結合し、実行ごとの USD コストレポートを作成します。

  ユーザーから「Apify の請求額がこんなに高いのはなぜか」や「有用な項目あたりのコストが最も高い Actor はどれか」と聞かれた場合に使用してください。

  apify-pp cost report --since 30d --group-by actor,schedule --json
  

• run --max-cost — 同じ Actor の過去の実行のローカル p50/p90 から実行前にコストを予測し、予測額が予算を超える場合は実行を中止します。

  ロングテールの Actor や信頼性が不明な Actor を使用する場合は、請求書が届いてから気付くのではなく、コスト超過を防ぐために使用してください。

  apify-pp-cli run xquik/x-tweet-scraper --input @xquik-tweets.json --max-cost 0.50 --wait
  

• ab run — 同じ入力を競合する 2 つの Actor で実行し、統合スキーマで正規化したうえで、新規項目あたりのコストと重複率を報告します。

  定期スケジュールに採用する前に「安価な Actor で十分か」をユーザーが判断したい場合に使用してください。

  apify-pp ab run apidojo/tweet-scraper kaitoeasyapi/twitter-x-data-tweet-scraper-pay-per-result-cheapest --input shared.json --judge novelty --json
  

ニュースレターのワークフロー

• digest — ローカルストアから Markdown ダイジェストを生成します。URL とタイトルの類似度で重複排除し、エンゲージメント、最新性、新規性で順位付けして、Go テンプレートにデータを埋め込みます。

  ニュースレターや週次レポートのワークフローの最後の手順として使用してください。出力は Beehiiv に貼り付けるか、ライターエージェントに渡せる状態です。

  apify-pp digest --topic "AI dev tools" --since 24h --template weekly.tmpl
  

• workflow run — YAML で宣言されたワークフローを実行し、複数の Actor にまたがって run → normalize → novelty → digest → publish を連鎖させます。

  Actor の呼び出しを手作業で連携させるのではなく、「コマンドを 1 つ実行するだけでニュースレターが完成する」定期パイプラインが必要な場合に使用してください。

  apify-pp workflow run ./weekly-newsletter.yaml --json
  

GitOps

• schedules apply — cron と Actor 入力のバンドルを宣言的に管理し、稼働中の Apify スケジュール API に対して Terraform スタイルの plan/apply/diff を実行します。

  3 件以上のスケジュールを管理していて、バージョン管理したい場合に使用してください。

  apify-pp schedule apply ./schedules.yaml --dry-run && apify-pp schedule diff
  

再現性

• preset save — 過去の実行で正常に動作した Actor 入力 JSON を保存し、オーバーライドを適用して再実行します。

  定期的なスクレイピングを再実行するたびに入力 JSON を手作業で作り直す必要がなくなります。

  apify-pp preset save twitter weekly-ai --from-run abc123 && apify-pp call twitter --preset weekly-ai --override [email protected]
  

コマンドリファレンス

actor-builds — このセクションで説明する API エンドポイントでは、Apify Actor のビルドを管理および削除できます。

返されたビルドオブジェクトにドル建ての使用量が含まれている場合、クエリ時点での実効単価を使用してこのドル相当額が計算されています。そのため、参考情報としてのみご利用ください。

プラットフォームの使用量について詳しくは、ドキュメントをご覧ください。

• apify-pp-cli actor-builds delete — ビルドを削除します。Actor の現在のデフォルトビルドは削除できません。ビルド...
• apify-pp-cli actor-builds get — ユーザーのすべてのビルドのリストを取得します。レスポンスはオブジェクトの JSON 配列で、各オブジェクトには基本...
• apify-pp-cli actor-builds get-actorbuilds — Actor の特定のビルドに関するすべての詳細を含むオブジェクトを取得します。省略可能な...

actor-runs — このセクションで説明する API エンドポイントでは、Apify Actor の実行を管理および削除できます。

返された実行オブジェクトにドル建ての使用量が含まれている場合、クエリ時点での実効単価を使用してこのドル相当額が計算されています。そのため、参考情報としてのみご利用ください。

完了した実行では、stats などの集計フィールドやドル建ての使用量合計は最終的に整合し、数秒以内に更新されます。確定済みの合計と一致する値が必要な場合は、実行の完了から約 10 秒待ってから、実行を再取得してください。

プラットフォームの使用量について詳しくは、ドキュメントをご覧ください。

• apify-pp-cli actor-runs delete — 実行を削除します。削除できるのは終了した実行のみです。実行を開始したユーザーまたは組織のみが削除できます。
• apify-pp-cli actor-runs get — ユーザーのすべての実行のリストを取得します。レスポンスはオブジェクトのリストで、各オブジェクトには基本情報...
• apify-pp-cli actor-runs get-actorruns — これは単一のエンドポイントではなく、実行またはそのデフォルトのいずれかを取得できるエンドポイント群です...
• apify-pp-cli actor-runs put — このエンドポイントを使用して、実行のステータスメッセージを更新し、一般的なリソースアクセスを設定できます...

actor-tasks — このセクションで説明する API エンドポイントでは、Apify Actor タスクの作成、管理、削除、実行ができます。 詳細については、Actor タスクのドキュメントをご覧ください。

:::note

タスクを指定するために actorTaskId パラメーターを受け取るすべての API エンドポイントでは、タスク ID（例：HG7ML7M8z78YcAPEB）、またはタスクの所有者のユーザー名とタスク名をチルダで区切った形式（例：janedoe~my-task）のいずれかを渡すことができます。

:::

一部の API エンドポイントは実行オブジェクトを返します。そのような実行オブジェクトにドル建ての使用量が含まれている場合、クエリ時点での実効単価を使用してこのドル相当額が計算されています。そのため、参考情報としてのみご利用ください。

プラットフォームの使用量について詳しくは、ドキュメントをご覧ください。

• apify-pp-cli actor-tasks delete — actorTaskId パラメーターで指定したタスクを削除します。
• apify-pp-cli actor-tasks get — ユーザーが作成または使用したタスクの完全なリストを取得します。レスポンスはオブジェクトのリストで、各...
• apify-pp-cli actor-tasks get-actortasks — タスクに関するすべての詳細を含むオブジェクトを取得します。
• apify-pp-cli actor-tasks post — POST ペイロードで JSON として渡されたオブジェクトで指定する設定を使用して、新しいタスクを作成します。レスポンスは完全な...
• apify-pp-cli actor-tasks put — POST ペイロードで JSON として渡されたオブジェクトで指定する値を使用して、タスクの設定を更新します。オブジェクトが...

acts — act を管理します

• apify-pp-cli acts delete — Actor を削除します。
• apify-pp-cli acts get — ユーザーが作成または使用したすべての Actor のリストを取得します。レスポンスはオブジェクトのリストで、各オブジェクトには...
• apify-pp-cli acts get-actorid — 特定の Actor に関するすべての詳細を含むオブジェクトを取得します。
• apify-pp-cli acts post — POST ペイロードで JSON として渡された Actor オブジェクトで指定された設定を使用して、新しい Actor を作成します。レスポンスは...
• apify-pp-cli acts put — POST ペイロードで JSON として渡された Actor オブジェクトで指定された値を使用して、Actor の設定を更新します。...

browser-info — ブラウザー情報を管理します

• apify-pp-cli browser-info tools-delete — クライアント IP アドレス、国コード、リクエストヘッダー、ボディなど、HTTP リクエストに関する情報を返します...
• apify-pp-cli browser-info tools-get — クライアント IP アドレス、国コード、リクエストヘッダー、ボディなど、HTTP リクエストに関する情報を返します...
• apify-pp-cli browser-info tools-post — クライアント IP アドレス、国コード、リクエストヘッダー、ボディなど、HTTP リクエストに関する情報を返します...
• apify-pp-cli browser-info tools-put — クライアント IP アドレス、国コード、リクエストヘッダー、ボディなど、HTTP リクエストに関する情報を返します...

datasets — データセットを管理します

• apify-pp-cli datasets delete — 特定のデータセットを削除します。
• apify-pp-cli datasets get — ユーザーのすべてのデータセットを一覧表示します。レスポンスはオブジェクトの JSON 配列で、各オブジェクトには基本的な...
• apify-pp-cli datasets get-datasetid — 指定されたデータセット ID のデータセットオブジェクトを返します。これはデータセットアイテムを返すのではなく、ストレージに関する情報のみを返します...
• apify-pp-cli datasets post — データセットを作成し、そのオブジェクトを返します。名前のないデータセットに保存されたデータは[データ...
• apify-pp-cli datasets put — POST で渡された JSON オブジェクトで指定された値を使用して、データセットの名前と一般的なリソースアクセスレベルを更新します...

key-value-stores — キー・バリューストアを管理します

• apify-pp-cli key-value-stores delete — キー・バリューストアを削除します。
• apify-pp-cli key-value-stores get — ユーザーが所有するキー・バリューストアのリストを取得します。レスポンスはオブジェクトのリストで、各オブジェクトには...
• apify-pp-cli key-value-stores get-keyvaluestores — 特定のキー・バリューストアに関するすべての詳細を含むオブジェクトを取得します。
• apify-pp-cli key-value-stores post — キー・バリューストアを作成し、そのオブジェクトを返します。レスポンスは[Get...
• apify-pp-cli key-value-stores put — POST で渡された JSON オブジェクトで指定された値を使用して、キー・バリューストアの名前と一般的なリソースアクセスレベルを更新...

logs — このセクションで説明する API エンドポイントは、Actor のビルドと実行によって 生成されたログをダウンロードするために使用します。ログの最後の 5M 文字のみが 保存され、それ以外は破棄されることに注意してください。

:::note

これらのエンドポイントは認証トークンを必要とせず、呼び出しは推測困難な Actor のビルドまたは実行の ID を使用して認証されることに注意してください。

:::

• apify-pp-cli logs <buildOrRunId> — 特定の Actor のビルドまたは実行のログを取得します。

request-queues — リクエストキューを管理します

• apify-pp-cli request-queues delete — 指定されたキューを削除します。
• apify-pp-cli request-queues get — ユーザーのすべてのリクエストキューを一覧表示します。レスポンスはオブジェクトの JSON 配列で、各オブジェクトには基本的な...
• apify-pp-cli request-queues get-requestqueues — 指定されたキュー ID のキューオブジェクトを返します。
• apify-pp-cli request-queues post — リクエストキューを作成し、そのオブジェクトを返します。名前のないキューに保存されたリクエストは[データ...
• apify-pp-cli request-queues put — POST で渡された JSON オブジェクトで指定された値を使用して、リクエストキューの名前と一般的なリソースアクセスレベルを更新...

schedules — このセクションでは、スケジュールを管理するための API エンドポイントについて説明します。 スケジュールを使用すると、指定した時刻に Actor を自動的に起動できます。各スケジュールには、複数の Actor と Actor タスクを関連付けることができます。また、API を使用して Actor（タスク）を実行するときと同様に、各 Actor（タスク）の設定を上書きすることもできます。 詳しくは、スケジュールのドキュメントをご覧ください。

各スケジュールには、実行するアクションが割り当てられます。アクションには、RUN_ACTOR と RUN_ACTOR_TASK の 2 種類があります。

詳しくは、Get schedule エンドポイントのドキュメントをご覧ください。

• apify-pp-cli schedules delete — スケジュールを削除します。
• apify-pp-cli schedules get — ユーザーが作成したスケジュールの一覧を取得します。このエンドポイントでは、limit と offset を使用したページネーションがサポートされています...
• apify-pp-cli schedules get-scheduleid — 詳細情報を含むスケジュールオブジェクトを取得します。
• apify-pp-cli schedules post — ペイロード内の JSON として渡されたスケジュールオブジェクトの設定を使用して、新しいスケジュールを作成します。レスポンスは...
• apify-pp-cli schedules put — POST ペイロード内の JSON として渡されたスケジュールオブジェクトで指定した値を使用して、スケジュールを更新します。オブジェクトが...

store — Apify Store には、Apify コミュニティが利用できる何千もの公開 Actor があります。 このセクションで説明する API エンドポイントは、これらの Actor を取得するために使用します。

:::note

これらのエンドポイントでは認証トークンは必要ありません。

:::

• apify-pp-cli store — Apify Store にある公開 Actor の一覧を取得します。search パラメーターを使用して、タイトル内の文字列で Actor を検索できます...

tools — このセクションで説明する API エンドポイントは、データのエンコード、署名、検証を行うユーティリティツールと、HTTP リクエストの詳細を調べるツールを提供します。

• apify-pp-cli tools decode-and-verify-post — encode-and-sign エンドポイントで以前に作成したエンコード済みの値をデコードして検証します。元の...
• apify-pp-cli tools encode-and-sign-post — 任意の JSON オブジェクトをエンコードして署名します。エンコードされた値には、認証済みユーザーの ID に紐付いた署名が含まれます。この...

users — このセクションで説明する API エンドポイントは、ユーザーアカウントに関する情報を返します。

• apify-pp-cli users get — 特定のユーザーアカウントの公開情報を返します。公開プロフィールページで確認できる情報と同様です（例：...
• apify-pp-cli users me-get — 公開情報と非公開情報の両方を含む、現在のユーザーアカウントの情報を返します。ユーザーアカウント...
• apify-pp-cli users me-limits-get — アカウントの上限に関する完全な概要を返します。アカウントの...で確認できる情報と同じです。
• apify-pp-cli users me-limits-put — アカウントの上限ページで管理できるアカウントの上限を更新します...
• apify-pp-cli users me-usage-monthly-get — 現在の月次利用サイクルの使用状況の完全な概要、全体の合計、および日別の...

webhook-dispatches — Webhook ディスパッチを管理します

• apify-pp-cli webhook-dispatches get — ユーザーが所有する Webhook ディスパッチの一覧を取得します。このエンドポイントでは、limit と...を使用したページネーションがサポートされています。
• apify-pp-cli webhook-dispatches webhook-dispatch-get — 詳細情報を含む Webhook ディスパッチオブジェクトを取得します。

webhooks — 自動通知を設定するための Webhook 関連 API エンドポイントです。

• apify-pp-cli webhooks delete — Webhook を削除します。
• apify-pp-cli webhooks get — ユーザーが作成した Webhook の一覧を取得します。このエンドポイントでは、limit と offset を使用したページネーションがサポートされています...
• apify-pp-cli webhooks get-webhookid — 詳細情報を含む Webhook オブジェクトを取得します。
• apify-pp-cli webhooks post — ペイロード内の JSON として渡された Webhook オブジェクトの設定を使用して、新しい Webhook を作成します。レスポンスは...
• apify-pp-cli webhooks put — POST ペイロード内の JSON として渡された Webhook オブジェクトで指定した値を使用して、Webhook を更新します。オブジェクトが...

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

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

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

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

レシピ

週刊ニュースレターのスクレイピング

apify-pp workflow run ./weekly-newsletter.yaml --agent

Twitter、Reddit、HN の各スクレイパーを YAML で宣言した 1 つのチェーンでつなぎ、ニュースレターにすぐ使えるダイジェストを 1 つ生成します。

Xquik のツイート調査

ツイート検索、タイムライン、スレッド、返信、引用、エンゲージメントの調査には、Xquik の X Tweet Scraper を使用します。

xquik-tweets.json を作成します。

{
  "searchTerms": ["from:OpenAI API", "#AI lang:en"],
  "maxItems": 100,
  "maxItemsPerTarget": 50,
  "outputVariant": "rich"
}

apify-pp-cli run xquik/x-tweet-scraper --input @xquik-tweets.json --max-cost 0.50 --wait --agent

maxItems は実行あたりの上限を設定します。maxItemsPerTarget は明示的に指定したターゲット間で結果のバランスを取ります。

Xquik のオーディエンス調査

フォロワー、フォロー中のアカウント、認証済みフォロワー、リスト、コミュニティの調査には、Xquik の X Follower Scraper を使用します。

xquik-followers.json を作成します。

{
  "twitterHandles": ["OpenAI", "AnthropicAI"],
  "relations": ["followers", "verified_followers"],
  "maxItems": 100,
  "maxItemsPerTarget": 50,
  "outputMode": "compact",
  "includeTargetMetadata": true,
  "dedupeMode": "merge"
}

apify-pp-cli run xquik/x-follower-scraper --input @xquik-followers.json --max-cost 0.50 --wait --agent

複数ターゲットの実行では、ターゲットのメタデータを保持します。オーディエンスの重複には、マージ時の重複排除を使用します。 maxItemsPerTarget を指定すると、必要に応じてターゲット間で結果のバランスを取れます。

有料で実行する前に、各 Actor の最新の Store スキーマと料金を確認してください。 CLI はローカル履歴から結果を提示します。--wait を指定すると、実行中の監視が追加されます。

Xquik は独立したサードパーティサービスです。X Corp. とは提携していません。「Twitter」と「X」は X Corp. の商標です。

Actor 横断トピック検索（簡易版）

apify-pp search 'agent' --since 30d --agent --select url,title,source_actor,published_at

ローカルストアの FTS5 を使用します。正規化された項目ペイロード全体を取得しないように、ドット区切りパスを指定して --select を使用します。

スケジュールの差分チェック

apify-pp schedule diff --agent

ローカルの YAML と稼働中の Apify スケジュールを Terraform 形式で比較し、変更セットを JSON で出力します。

2 つの Twitter スクレイパーの A/B テスト

apify-pp ab run apidojo/tweet-scraper kaitoeasyapi/twitter-x-data-tweet-scraper --input shared.json --judge cost-per-novel --agent

両方を実行して統一スキーマで正規化し、新規項目あたりのコストと重複率を報告します。

認証の設定

APIFY_TOKEN（Apify Console → Settings → Integrations で取得）を設定するか、apify-pp auth set-token を実行します。CLI は、呼び出しを行う前に /v2/users/me に対してトークンを検証します。クエリパラメーター形式の ?token= もサポートされていますが、推奨されません。

apify-pp-cli doctor を実行して、設定を確認します。

エージェントモード

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

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

• フィルター可能 — --select でフィールドの一部だけを保持します。ドット区切りパスでネストした構造をたどり、配列では各要素をたどります。出力が冗長な API から取得するコンテキストを小さく保つうえで重要です。

  apify-pp-cli actor-builds get --agent --select id,name,status
  

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

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

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

• 明示的な再試行 — 既存の作成対象を成功として扱う場合に限り --idempotent を使い、削除対象が見つからない場合に成功として扱う場合に限り --ignore-missing を使います

レスポンスエンベロープ

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

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

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人間が読みやすい N results (live) の概要は、stdout がターミナルで、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が指定されていない場合に限り、stderr に出力されます。パイプやエージェントでの利用、および明示的に形式を指定した実行では、stdout には純粋な JSON が出力されます。

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

あなた（またはエージェント）がこの CLI に何か違和感を覚えたら、記録してください。

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

エントリーは ~/.apify-pp-cli/feedback.jsonl にローカル保存されます。APIFY_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されているか APIFY_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトではローカルにのみ保存されます。

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

出力の配信

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

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

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

名前付きプロファイル

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

apify-pp-cli profile save briefing --json
apify-pp-cli --profile briefing actor-builds get
apify-pp-cli profile list --json
apify-pp-cli profile show briefing
apify-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

この CLI の公開済みパブリックライブラリーエントリーまたはビルド済みリリースから MCP バイナリをインストールし、登録します。

claude mcp add apify-pp-mcp -- apify-pp-mcp

確認します：claude mcp list

直接使用

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

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

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