pp-trendhunter

Trend Hunter — Printing Press CLI

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

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

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

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

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

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

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

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

この CLI を使う場合

サイトを手動でクリックするのではなく、エージェントのループ、スクリプト、日々のルーティンに TrendHunter のデータを取り込みたい場合に、この CLI を使います。週ごとのトレンド監視、LLM が引用できる FAQ 形式のトレンド要約、コーパス全体のキーワードクラスタリングに特に適しています。認証不要の無料スクレイパーです。公式の有料 API を利用する場合は、TrendHunter の商用サービスをお使いください。

この CLI を使わない場合

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

独自の機能

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

蓄積されるローカル状態

• digest — カテゴリ内の新しいトレンドと再登場したトレンドを比較し、上昇中のキーワードを含む週ごとのダイジェストを生成します。

  週次の競合調査を行うエージェントは、30 件のカードを手作業で開き直すことなく、「今週のエコ分野では何が新しいですか？」と尋ねられます。

  trendhunter-pp-cli digest --since 7d --category eco --json
  

• watch — カテゴリごとの新着のみを表示するフィードです。TrendHunter の RSS が全カテゴリ共通であることによる不足を補います。

  エージェントや独立系のトレンド調査担当者は、全体の膨大なフィードを再処理せずに、特定の分野の新着情報だけを取得できます。

  trendhunter-pp-cli watch --category gadgets --since 24h --json
  

• cluster — FTS5 の共起分析と、現在の期間と前の期間との差分により、上昇中のキーワードクラスターを抽出します。

  新たなテーマを調査するエージェントは、見出しのトレンドだけでなく、関連キーワードのうちどれが加速しているかも把握できます。

  trendhunter-pp-cli cluster --window 30d --min-count 3 --json
  

• authors — TrendHunter の著者や未来予測家を、生涯の投稿数ではなく、期間ごとの投稿頻度で順位付けします。

  過去の実績が最も大きい人ではなく、現在あなたの分野で活躍しているトレンドハンターを見つけられます。

  trendhunter-pp-cli authors --top 20 --since 30d --json
  

• inbox — 前回 inbox を実行してから見つかったトレンドを、マシンごとのカーソルテーブルを使って表示します。

  月曜の朝のルーティンに組み込めば、まだ見たことのない情報だけを常に確認できます。

  trendhunter-pp-cli inbox --json
  

エージェント向けの抽出

• faq — トレンドページから FAQPage の JSON-LD を抽出し、構造化された Q&A に変換します。

  記事の要約を別の LLM に依頼することなく、エージェントは各トレンドについて、そのまま引用できる Q&A 要約を取得できます。

  trendhunter-pp-cli faq ai-clone --json
  

• brief — カテゴリ内の上位 N 件のトレンドを順位付けし、それぞれに FAQ の Q&A とキーワードを付けて、JSON または Markdown で出力するワンショットのエージェント向けブリーフです。

  市場メモの確かな情報源として、そのままエージェントのプロンプトに組み込めます。接続用のコードは不要です。

  trendhunter-pp-cli brief --category ai --top 10 --format markdown
  

• scout — カテゴリ内の上位トレンドを取得し、ビジネスプロフィールとの関連性に基づいて各トレンドをスコア付けします。スコア付けをローカル LLM に任せることもできます。

  特定の分野を調査するエージェントは、パイプラインの次の段階に渡せる、ビジネスに合わせて順位付けされたトレンド一覧を取得できます。

  trendhunter-pp-cli scout --category kitchen --business "We sell smart ovens for home cooks" --top 10 --llm
  

グラフと統合

• megatrend-map — 起点となるスラッグから関連トレンドのグラフを 2 階層たどり、深さ 1 と深さ 2 の関連スラッグを返します。特定の概念に関連する無料のトレンドを確認できます。

  295 ドルの有料メガトレンドレポートに価値があるか判断する評価担当者は、どの無料トレンドがそのレポートにつながるかを確認できます。

  trendhunter-pp-cli megatrend-map ai-clone --json
  

検出シグナル

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

• キャプチャ範囲：全 30 件のネットワークエントリーのうち、API エントリー 11 件
• プロトコル：html（信頼度 100%）、rss（信頼度 100%）
• 生成時のヒント：標準ライブラリの HTTP トランスポートを使用してください（http_transport: standard）。デフォルトの UA は Chrome を模倣する必要があります。curl のデフォルト UA はブロックされます。デフォルトの Accept ヘッダーは Chrome 形式の 'text/html,application/xhtml+xml,application/xml;q=0.9,/;q=0.8' にする必要があります。'/' のみの場合はブロックされます。RSS フィードはサイト全体のものだけです。カテゴリ別 RSS は有効ですが空のチャンネルを返すため、呼び出さないでください。トレンドページは、別の垂直型マイクロサイト（cleanthesky.com など）にリダイレクトされることがあります。リダイレクトに従い、正規の /trends/ URL を記録してください。/trends/ の FAQPage JSON-LD は、エージェントの要約を得るための最も情報密度の高い情報源です。faq コマンドで抽出してください。クリアランス Cookie、Surf、ブラウザーサイドカーは不要です。

コマンドリファレンス

category — カテゴリのインデックスページ（tech、fashion、food、eco、ai、marketing、design など）

• trendhunter-pp-cli category <category> — TrendHunter のカテゴリインデックスページ（トレンドカード約 30 件）を取得します。この CLI の 'category ' コマンドで解析します。

megatrends — メガトレンド／パターンのインデックスページ。

• trendhunter-pp-cli megatrends — メガトレンドのインデックスページを取得します。

popular — 厳選された「今人気」のインデックス。

• trendhunter-pp-cli popular — 人気トレンドのインデックスページ（カード約 30 件）を取得します。'popular' を実行すると、解析済みの JSON が得られます。

reports — トレンドレポートのインデックス。

• trendhunter-pp-cli reports — トレンドレポートのランディングページ（タイトル、説明、有料 PDF リンク）を取得します。

results — サイトの検索結果エンドポイント（フレームワークには手作りの search コマンドがすでにあります。これは生の HTML ページを公開します）。

• trendhunter-pp-cli results — TrendHunter で検索を実行し、結果ページの HTML を取得します。この CLI の 'search ' で解析します。HTML を取得するには --raw を渡してください。

rss — サイト全体から最新のトレンド 30 件を配信するグローバル RSS フィード。

• trendhunter-pp-cli rss — グローバル RSS 2.0 フィード（最新のトレンド約 30 件）を取得します。これらをローカルストアに取り込むには 'sync' を使用します。この生のエンドポイントは...

scoreboard — 主要コントリビューターとトレンドのスコアボード。

• trendhunter-pp-cli scoreboard — 主要コントリビューターのハンドル名と最近のトレンドを含むスコアボードページを取得します。'scoreboard' を実行すると、解析済みの JSON が得られます。

sitemap — 430 件を超える URL（カテゴリ、フューチャリスト、コントリビューター、ハブ）を含むマスターサイトマップ。

• trendhunter-pp-cli sitemap — sitemap.xml を取得します。この CLI の 'catalog refresh' がこれを使用します。ユーザーは代わりにそちらを使用してください。

trends — 完全なメタデータ、FAQ の Q&A、関連トレンド、著者、カテゴリを含む個別のトレンドページ。

• trendhunter-pp-cli trends <slug> — スラッグのトレンドページ全体の HTML を取得します。この CLI の 'trend show ' で解析します。ユーザーは代わりにそちらを使用してください...

手書きのコマンド

• trendhunter-pp-cli sync — グローバル RSS フィード（および任意のカテゴリ）をローカルの SQLite ストアに同期します。毎晩実行してください。冪等です。
• trendhunter-pp-cli search <query> — 全文検索です。ローカル優先（同期済みのトレンドを対象に FTS5 で検索）で、--live を指定すると上流の検索エンドポイントにも検索を展開します……
• trendhunter-pp-cli trend — トレンド詳細コマンドです。'trend show ' はページを解析し、'trend faq ' は FAQPage JSON-LD を抽出し、'trend...
• trendhunter-pp-cli category <name> — カテゴリを閲覧します。直近のトレンドカード約 30 件を JSON またはテーブル形式で返します。--sync を指定すると再取得して...
• trendhunter-pp-cli popular — 「現在人気」のトレンドを表示します（/popular から解析）。
• trendhunter-pp-cli scoreboard — 投稿者とトレンドのスコアボードを表示します。投稿者上位のみを表示するには --top を指定します。
• trendhunter-pp-cli pull — グローバル RSS フィードとサイトマップをローカルの解析済みトレンドストアに同期します。冪等です。
• trendhunter-pp-cli digest — 新規トレンドと再登場トレンドの週次比較ダイジェストを、上昇中のキーワード上位とともに表示します。--category、--since を指定できます（デフォルトは 7d）。
• trendhunter-pp-cli watch --category <name> — カテゴリごとの新着のみのフィードです。/rss がグローバルフィードのみであることを補います。
• trendhunter-pp-cli faq <slug> — /trends/ ページから FAQPage JSON-LD の Q&A を抽出します。
• trendhunter-pp-cli cluster — FTS5 の共起データを使って、前の期間との差分とともに上昇中のキーワードクラスターを表示します。
• trendhunter-pp-cli authors — サイトの全期間のみの /scoreboard とは異なり、期間ごとの投稿者の活動速度を表示します。
• trendhunter-pp-cli megatrend-map <slug> — 関連トレンドのグラフを深さ 2 までたどり、メガトレンドの分類を提示します。
• trendhunter-pp-cli brief --category <name> — FAQ の Q&A を含むトレンド上位 N 件のエージェント向けブリーフを、一括で JSON または Markdown 形式で生成します。
• trendhunter-pp-cli inbox — マシンごとのカーソルを使い、前回の inbox 呼び出し以降の新しいトレンドを表示します。
• trendhunter-pp-cli doctor — 到達可能性と DB の健全性を確認します。/rss、/sitemap.xml、ストアを検査し、緑・黄・赤のステータスを表示します。
• trendhunter-pp-cli scout --category <name> --business <description> — ビジネスとの関連性を調査します。カテゴリからトレンド上位を取得し、各トレンドをビジネスプロファイルとの関連性に基づいてスコアリングします（キーワード...

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

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

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

which は、自然言語で記述した機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は 1 件以上の一致を意味し、終了コード 2 は確信を持てる一致がないことを意味します。その場合は --help を使うか、より具体的な問い合わせに切り替えてください。

レシピ

エコ関連の週間トレンドメモ

trendhunter-pp-cli digest --since 7d --category eco --json --select trends.title,trends.keywords,trends.first_seen

過去 1 週間に登場したエコ関連トレンドすべてについて、タイトル、キーワード、初出時刻のみを返します。対象を絞った情報なので、Slack の投稿や LLM プロンプトに最適です。

AI 向けエージェントブリーフ

trendhunter-pp-cli brief --category ai --top 10 --format markdown

AI トレンド上位 10 件を、それぞれ FAQ の Q&A とキーワードとともに、プロンプトに貼り付けられる Markdown 形式で表示します。

上昇キーワードのスキャン

trendhunter-pp-cli cluster --window 30d --min-count 3 --json

直前の 30 日間と比べて共起数が増加したキーワードを表示します。

今月活動中の未来予測者

trendhunter-pp-cli authors --top 20 --since 30d --json

トレンドハンターと未来予測者の期間ごとの公開速度を表示します。サイトの /scoreboard は全期間のみです。

メガトレンドを無料トレンドにマッピングする

trendhunter-pp-cli megatrend-map ai-clone --json

開始スラッグから関連トレンドのグラフを 2 階層たどり、概念の周辺にある深さ 1 および深さ 2 の関連スラッグを提示します。

認証の設定

認証は不要です。

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

エージェントモード

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

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

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

  trendhunter-pp-cli category mock-value --agent --select id,name,status
  

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

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

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

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

レスポンスエンベロープ

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

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

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

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

この CLI で気になる点に気付いた場合は（エージェントが気付いた場合も）、記録してください：

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

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

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

出力の送信先

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

送信先	動作
stdout	既定値。stdout のみに出力します
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

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

名前付きプロファイル

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

trendhunter-pp-cli profile save briefing --json
trendhunter-pp-cli --profile briefing category mock-value
trendhunter-pp-cli profile list --json
trendhunter-pp-cli profile show briefing
trendhunter-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します：

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

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

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

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

2. Claude Code に登録します：

   claude mcp add trendhunter-pp-mcp -- trendhunter-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

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

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