pp-kdpnichefinder

KDP Niche Finder — Printing Press CLI

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

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

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

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

2. 確認します：kdpnichefinder-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/marketing/kdpnichefinder/cmd/kdpnichefinder-pp-cli@latest

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

KDP Niche Finder は、履歴やエクスポート機能のない、厳選されたニッチカテゴリーを一度に1つずつ表示するクリック操作型のウェブツールです。この CLI は4つすべてのカテゴリーをローカルの SQLite に取り込み、カテゴリーを横断して機会の大きさでニッチを順位付けし（rank）、前回の更新以降に上昇または下降しているニッチを確認し（drift）、複数のカテゴリーに登場する書籍を見つけ（dupes）、出版社の寡占度を把握し、KDP 用の CSV をエクスポートできます。すべてオフラインで動作し、エージェントから直接利用できます。

この CLI を使用する場面

エージェントまたはパワーユーザーが、Amazon KDP のニッチをプログラムで調査する必要がある場合に、この CLI を使用します。たとえば、すべてのカテゴリーを横断した機会の順位付け、ニッチの収益トレンドの追跡、出版社間の競争状況の調査、候補リストのエクスポートに利用できます。KDP Niche Finder の閲覧専用ウェブ UI を、クエリ可能なローカルデータベースに変えます。

使用しない場面

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

• 書籍のカバーや本文の生成には使用しないでください。それには Artistly の生成スイートを使用します。このニッチツールの用途ではありません。
• 任意の ASIN を対象に、Amazon の BSR をリアルタイムで照会する用途には使用しないでください。対象は、厳選された KDP Niche Finder のカテゴリーに限られます。
• 米国以外のマーケットプレイスには使用しないでください。元データは米国中心です。

独自の機能

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

蓄積されるローカル状態

• rank — 推定収益、販売数、価格を組み合わせた指標で、4つすべてのカテゴリーを横断してニッチを順位付けします。

  カテゴリーごとに閲覧するのではなく、機会の大きさから最有力のニッチを1つ選びたいエージェントに適しています。

  kdpnichefinder-pp-cli rank --max-price 9.99 --sort value --agent
  

• drift — 以前のスナップショットと比べて、同期済みのニッチの推定収益が上昇しているか下降しているかを表示します。

  元のツールではまったく判断できない、今すぐ出版するか見送るかといったタイミングの決定に適しています。

  kdpnichefinder-pp-cli drift --since 7d --sort rising --agent
  

• keywords — 同期済みの書籍タイトルをトークンに分割し、キーワードの出現頻度を集計して、ニッチの注目キーワードを明らかにします。

  実際に売れているものをもとに、KDP のバックエンドのキーワード欄に入力する語句を検討するのに適しています。

  kdpnichefinder-pp-cli keywords --type evergreen --min-count 3 --agent
  

カテゴリー横断の分析

• dupes — 複数のニッチカテゴリーに登場する書籍（同一 ASIN）を見つけ、該当するカテゴリーを表示します。

  複数のカテゴリーで見られるニッチを見つけるのに適しています。これは、複数の情報源によって裏付けられた強い兆候です。

  kdpnichefinder-pp-cli dupes --agent
  

• saturation — カテゴリーごとに、出版社間で推定収益がどれほど集中しているか（大手独占型か分散型か）を表示します。

  まだ開拓の余地があるニッチと、すでに1社の出版社が独占しているニッチを見分けるのに適しています。

  kdpnichefinder-pp-cli saturation --type hidden_gems --agent
  

• competitors — 注目する書籍の ASIN を使い、同じ出版社および同じ価格帯の競合書籍を一覧表示します。

  特定のニッチに参入する前に、ほかに誰が成功しているのかを調べるのに適しています。

  kdpnichefinder-pp-cli competitors 2584 --agent
  

エージェント向けの連携機能

• export — タイトル、ASIN、価格、推定販売数、収益を CSV としてエクスポートし、KDP のバックエンドのキーワード設定やカバー制作に利用できます。

  タイトルを入力し直すことなく、候補リストをキーワード／カバー制作ツールに渡すのに適しています。

  kdpnichefinder-pp-cli export --csv
  

検出シグナル

この CLI は、ブラウザーで観測されたトラフィックのコンテキストをもとに生成されています。

• キャプチャ範囲：全 273 件のネットワークエントリのうち、API エントリ 60 件
• プロトコル：rest_json（確度 75%）、html_scrape（確度 55%）
• コマンド候補：create_folders — 観測された POST /api/folders のトラフィックから導出。create_toggle_save — 観測された POST /api/books/{book_id}/toggle-save のトラフィックから導出。list_categories — 観測された GET /api/categories のトラフィックから導出。list_evergreen — 観測された GET /app/category/evergreen のトラフィックから導出。list_folders — 観測された GET /api/folders のトラフィックから導出。list_fresh_money — 観測された GET /app/category/fresh_money のトラフィックから導出。list_hidden_gems — 観測された GET /app/category/hidden_gems のトラフィックから導出。list_high_ticket — 観測された GET /app/category/high_ticket のトラフィックから導出。
• 注意点：empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。empty_payload：API のように見えるリクエストが空または null のペイロードを返しました。スキーマの確度は低いです。

コマンドリファレンス

books — ニッチな書籍を保存／保存解除します

• kdpnichefinder-pp-cli books <book_id> — 書籍の保存／保存解除を切り替えます。フォルダーへの保存も指定できます

categories — ニッチ分類のメタデータ

• kdpnichefinder-pp-cli categories — ニッチ分類のカテゴリ（キー、名前、説明）を一覧表示します

folders — 保存したニッチをフォルダーに整理します

• kdpnichefinder-pp-cli folders create — フォルダーを作成します
• kdpnichefinder-pp-cli folders list — フォルダーを一覧表示します

niches — 厳選された KDP ニッチ分類（推定販売数／売上付きの実在する Amazon 書籍）を閲覧します

• kdpnichefinder-pp-cli niches <type> — ニッチ分類を閲覧します：evergreen、fresh_money、hidden_gems、または high_ticket

saved — 保存したニッチな書籍

• kdpnichefinder-pp-cli saved — 保存した書籍を一覧表示します

user — 認証済みアカウント

• kdpnichefinder-pp-cli user — 認証済みユーザーを表示します

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

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

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

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

レシピ

すべての分類から低価格のニッチを見つける

kdpnichefinder-pp-cli rank --max-price 9.99 --sort value --agent

同期済みのすべての書籍を売上の対価格比で順位付けし、低価格で高収益のニッチが上位に表示されるようにします。

情報量の多いニッチ一覧から必要なフィールドだけに絞る

kdpnichefinder-pp-cli niches hidden_gems --search journal --agent --select title,estimated_monthly_revenue,amazon_url

ドット区切りの --select パスを使い、ページ分割された分類のレスポンスからタイトル、売上、Amazon リンクだけを取得します。

週ごとのニッチの成長を見つける

kdpnichefinder-pp-cli drift --since 7d --sort rising --agent

最新のスナップショットを 1 週間前のスナップショットと比較し、推定売上が伸びているニッチを表示します。

保存した候補リストをキーワード作業用にエクスポートする

kdpnichefinder-pp-cli export --csv

KDP のバックエンドキーワードツールや表紙作成ツールで使えるよう、タイトル／ASIN／価格／販売数／売上を CSV として出力します。

認証の設定

KDP Niche Finder では、Laravel のセッションログインを使用します（API キーは不要です）。kdpnichefinder-pp-cli auth login --chrome を実行して、ログイン済みの kdpnichefinder.com のブラウザーセッションを取得します。読み取りにはセッション Cookie を使用し、保存やフォルダー操作では、CLI が組み立てる CSRF トークンも送信します。

kdpnichefinder-pp-cli doctor を実行して、セットアップを確認します。

エージェントモード

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

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

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

  kdpnichefinder-pp-cli categories --agent --select id,name,status
  

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

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

• 非インタラクティブ — プロンプトは表示されず、すべての入力をフラグで指定します

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

レスポンスエンベロープ

ローカルストアまたは 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 に問題があることに（あなた自身またはエージェントが）気づいた場合は、記録してください：

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

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

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

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定した送信先に送られるため、エージェントはコマンド結果を手作業でパイプせずに振り分けられます。対応する送信先は次の3つです：

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

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

名前付きプロファイル

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

kdpnichefinder-pp-cli profile save briefing --json
kdpnichefinder-pp-cli --profile briefing categories
kdpnichefinder-pp-cli profile list --json
kdpnichefinder-pp-cli profile show briefing
kdpnichefinder-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します：

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

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

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

   go install github.com/mvanhorn/printing-press-library/library/marketing/kdpnichefinder/cmd/kdpnichefinder-pp-mcp@latest
   

2. Claude Code に登録します：

   claude mcp add kdpnichefinder-pp-mcp -- kdpnichefinder-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

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

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