pp-context-dev

Context Dev — Printing Press CLI

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

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

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

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

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

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

ウェブサイトのインテリジェンス、ブランド情報の拡充、スクレイピング、クロール、構造化データの抽出、スクリーンショット、スタイルガイド、競合マップ、ソースパック、変更ダイジェストに対応した、エージェント向けの Context.dev CLI です。

コマンドリファレンス

主要なワークフロー — Context.dev の一般的なオペレータータスクでは、これらを優先してください。

• context-dev-pp-cli scrape <url> --agent — 1 つの URL をクリーンな Markdown にスクレイプします。
• context-dev-pp-cli crawl <seed> --max-pages 5 --agent — 同一ドメインのページをクロールします。--estimate を使用してください。25 ページを超える場合は --confirm または --yes が必要です。
• context-dev-pp-cli extract <url> --schema schema.json --agent — JSON Schema ファイルを使用して型付き JSON を抽出します。
• context-dev-pp-cli styleguide <domain|url> --agent — デザインシステムのデータを抽出します。
• context-dev-pp-cli screenshot <domain|url> --agent — スクリーンショットのプレビューをキャプチャします。
• context-dev-pp-cli entity-discover --type company --name "<name>" --location "<place>" --agent — 検索、ブランド/スクレイプによるエンリッチメント、ランキング、プロベナンスを備えた、フィールド指定型の公開エンティティ探索です。有効な type: company、venue、provider、school、agency、other。
• context-dev-pp-cli brand-brief <domain|url> --agent — ドメイン、ウェブサイト、タイトル、説明、ロゴ、カラー、フォント、ソーシャル、連絡先、スクリーンショット、要約、プロベナンスを含む正規化されたブランドプロファイルです。
• context-dev-pp-cli competitor-map --domain <domain|url> --max 5 --agent — why_ranked、重複シグナル、プロベナンスを伴ってカテゴリ/マーケット別にクラスタリングされた競合セットです。シードドメインが存在しない場合は --query を使用してください。
• context-dev-pp-cli crawl-budget-plan <seed> --max-pages 25 --agent — クロールクレジットを消費せずに、urlRegex、最大ページ数、クレジット、リスク、推奨クロールコマンドを見積もります。
• context-dev-pp-cli source-pack --query "<query>" --max-sources 5 --agent — 引用付きソースパックを検索してスクレイプします。ソースごとに抽出を実行するには --schema schema.json を追加します。検索失敗は非ゼロです。結果が 0 件の場合は status: "no_results" です。
• context-dev-pp-cli website-change-digest <domain|url> --agent — CLI 状態ディレクトリにスクレイプ/スタイルガイド/スクリーンショットのスナップショットを保存し、以前のローカルスナップショットと差分を取ります。
• context-dev-pp-cli schema-lab --url <url> --url <url> --schema schema.json --agent — サンプル全体で抽出スキーマを実行し、フィールド充填率、パース失敗、ミス、生のステータス、プロベナンスを報告します。
• context-dev-pp-cli brand-kit <domain|url> --agent — オンデマンドのブランドキット（エイリアス: asset-pack）: ロゴ、パレット、フォント、スタイルガイド、スクリーンショット、favicon、ソーシャル、プロベナンス。
• context-dev-pp-cli brand-qa <domain|url> --question "What is the return policy?" --agent — ブランドのウェブサイトについて自然言語で質問し、分析された URL とプロベナンスを伴う根拠のある回答を得ます。
• context-dev-pp-cli email-enrich [email protected] --agent — 仕事用メールアドレスを、プロベナンス付きの企業プロファイルとサインアップフォームのプリフィルフィールド（企業名、ウェブサイト、業種）に変換します。
• context-dev-pp-cli ticker-enrich AAPL --agent — 株式ティッカーまたは ISIN から公開企業を解決し、ブランドプロファイルと NAICS/SIC 業種コードを取得します。ティッカーか ISIN かを自動検出します。ティッカーを曖昧さなく特定するには --exchange を渡してください。
• context-dev-pp-cli trust-check <domain|url> --agent — ウェブサイト、ソーシャル、住所、電話、ロゴ、タイトル/ドメイン、ウェブシグナルにわたる一貫性/リスクシグナルレポートです。出力を不正行為の判定として説明しないでください。
• context-dev-pp-cli lead-enrich-batch leads.csv --domain-column domain --name-column name --location-column location --output enriched.json --resume --agent — CSV の行を一括エンリッチし、行ごとの成功/エラー、プロベナンス、失敗理由を返します。1 件の不正な行でバッチ全体を失敗させる場合にのみ --strict を使用してください。

第二波のワークフローでは、マシン安定な JSON を得るために --agent を推奨します。複数クレジットのコマンドは --estimate をサポートし、すべてのワークフローが --dry-run をサポートします。estimate と dry-run のレスポンスには estimated_credits と planned_requests が含まれ、クレジットを消費しません。website-change-digest は解決された CLI 状態ディレクトリの下にスナップショットを永続化し、リポジトリの下には決して保存しません。entity-discover は自由形式の塊や機微な/個人を特定するコンテキストを拒否します。公開フィールドの値のみを渡してください。

brand — ブランドを管理します

• context-dev-pp-cli brand create — 特定のドメインのブランドデータをまもなく取得する可能性があることを通知し、レイテンシを改善します。
• context-dev-pp-cli brand create-ai — 単一の URL を指定すると、それが商品ページかどうかを判定し、商品情報を抽出します。
• context-dev-pp-cli brand create-ai-2 — ブランドのウェブサイトから商品情報を抽出します。
• context-dev-pp-cli brand create-ai-3 — AI を使用してブランドのウェブサイトから特定のデータポイントを抽出します。
• context-dev-pp-cli brand create-prefetchbyemail — 特定のドメインのブランドデータをまもなく取得する可能性があることを通知し、レイテンシを改善します。
• context-dev-pp-cli brand list — 任意のドメインからロゴ、背景画像、カラー、業種、説明などを取得します
• context-dev-pp-cli brand list-retrievebyemail — 使い捨てメールアドレスや無料メールアドレスを検出しながら、メールアドレスを使用してブランド情報を取得します。
• context-dev-pp-cli brand list-retrievebyisin — ISIN（国際証券識別番号）を使用してブランド情報を取得します。
• context-dev-pp-cli brand list-retrievebyname — 会社名を使用してブランド情報を取得します。
• context-dev-pp-cli brand list-retrievebyticker — 株式ティッカーシンボルを使用してブランド情報を取得します。
• context-dev-pp-cli brand list-retrievesimplified — 必須情報（ドメイン、タイトル、カラー、ロゴ）のみを含む簡易版のブランドデータを返します
• context-dev-pp-cli brand list-transactionidentifier — トランザクションのタイトルによってトランザクションデータを識別したいプラットフォーム向けに特別に設計されたエンドポイントです。

people — 人物を管理します

• context-dev-pp-cli people — 識別子から人物プロフィールを取得して正規化します。

web — web を管理します

• context-dev-pp-cli web create — 指定された URL からクロールを開始し、ページコンテンツを Markdown として抽出します
• context-dev-pp-cli web create-extract — ウェブサイトをクロールし、提供された JSON Schema と指示を使用して関連する内部リンクを優先します
• context-dev-pp-cli web create-search — ウェブを検索し、必要に応じて各結果を Markdown にスクレイピングする処理を 1 回のラウンドトリップで行います。
• context-dev-pp-cli web list — 企業のランディングページとウェブ検索の証拠を分析し、同一の製品または市場における直接の競合他社を返します。
• context-dev-pp-cli web list-fonts — フォントファミリー、使用統計、フォールバック、要素数・単語数など、ウェブサイトからフォント情報をスクレイピングします。
• context-dev-pp-cli web list-naics — ドメインまたは名前から、任意のブランドを 2022 年の NAICS 業種コードに分類します。
• context-dev-pp-cli web list-scrape — 指定された URL をスクレイピングし、ページの生の HTML コンテンツを返します。
• context-dev-pp-cli web list-scrape-2 — 標準 URL、インライン SVG、データ URI、レスポンシブ画像ソースなど、ウェブページから画像アセットを抽出します
• context-dev-pp-cli web list-scrape-3 — 指定された URL をスクレイピングして、LLM で利用可能な Markdown に変換します。
• context-dev-pp-cli web list-scrape-4 — ウェブサイト全体のサイトマップをクロールし、検出されたすべてのページ URL を返します。
• context-dev-pp-cli web list-screenshot — ウェブサイトのスクリーンショットを撮影します。
• context-dev-pp-cli web list-sic — ドメインまたは名前から、任意のブランドを標準産業分類（SIC）コードに分類します。
• context-dev-pp-cli web list-styleguide — カラー、タイポグラフィ、スペーシング、シャドウ、UI コンポーネントなど、ウェブサイトから包括的なデザインシステムを抽出します。

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

何をしたいのかはわかっているが、どのコマンドがそれを行うのかわからない場合は、CLI に直接尋ねてください。

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

which は、自然言語による機能のクエリを、この CLI の厳選された機能インデックスから最も一致するコマンドに解決します。終了コード 0 は少なくとも 1 件の一致を意味し、終了コード 2 は確実な一致がないことを意味します。その場合は --help に頼るか、より絞り込んだクエリを使用してください。

認証の設定

context-dev-pp-cli auth setup を実行すると、トークンを取得するための URL と手順が表示されます（--launch を追加すると URL が開きます）。その後、トークンを保存します。

context-dev-pp-cli auth set-token YOUR_TOKEN_HERE

または、環境変数として CONTEXT_DEV_API_KEY を設定します。CONTEXT_DEV_API_KEY が未設定の場合は、フォールバックとして CONTEXT_API_KEY が使用されます。互換性のため、従来の生成済み変数 CONTEXT_DEV_BEARER_AUTH も引き続きサポートされます。

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

エージェントモード

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

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

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

  context-dev-pp-cli brand list --domain example-value --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 のパス解決機能をランタイムの契約の一部として扱ってください。

• 1 回の呼び出しで使用する場合は --home <dir> を指定します。4 種類すべてのパスを 1 つのルート配下に移動する場合は、CONTEXT_DEV_HOME=<dir> を設定します。

• 特定の種類のパスだけを別の場所にする必要がある場合に限り、種類ごとの環境変数 CONTEXT_DEV_CONFIG_DIR、CONTEXT_DEV_DATA_DIR、CONTEXT_DEV_STATE_DIR、CONTEXT_DEV_CACHE_DIR を使用します。

• 解決順序は、種類ごとの環境変数、--home、CONTEXT_DEV_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 から移動されます。

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

• MCP では、MCP ホストの設定を通じてパスの移動先を指定します。MCP バイナリは CLI のフラグを継承しません。

  {
    "mcpServers": {
      "context-dev": {
        "command": "context-dev-pp-mcp",
        "env": {
          "CONTEXT_DEV_HOME": "/srv/context-dev"
        }
      }
    }
  }
  

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

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

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

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

エントリは、解決済みの data ディレクトリ内の feedback.jsonl にローカル保存されます。CONTEXT_DEV_FEEDBACK_ENDPOINT が設定され、かつ --send が指定されているか、CONTEXT_DEV_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」パターンです。

context-dev-pp-cli profile save briefing --json
context-dev-pp-cli --profile briefing brand list --domain example-value
context-dev-pp-cli profile list --json
context-dev-pp-cli profile show briefing
context-dev-pp-cli profile delete briefing --yes

明示的なフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルトより優先されます。agent-context は、実行時にエージェントがプロファイルを見つけられるよう、available_profiles の下に利用可能なすべてのプロファイルを一覧表示します。

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

   go install github.com/mvanhorn/printing-press-library/library/ai/context-dev/cmd/context-dev-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add context-dev-pp-mcp -- context-dev-pp-mcp
   

3. 確認します：claude mcp list

直接利用

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

   context-dev-pp-cli <command> [subcommand] [args] --agent
   

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