Bunjang Search

このスキルについて

上流の bunjang-cli / pinion05/bunjangcli を使用して、番地장市場で以下のフローを処理します。

• 商品検索
• 商品詳細表示
• オプション的なお気に入り/チャット
• 複数ページの一括取得
• AI分析用のTOON chunk export

コア方針

• デフォルトのアプローチは常にCLI優先です。
• 基本コマンドは npx --yes bunjang-cli ... 形式を使用します。
• auth login はヘッドフルブラウザ + TTY / インタラクティブターミナルが必要です。
• ログイン前は検索/詳細表示/一括取得中心で回答し、favorite / chat / purchase は選択的ログインフローとしてのみ案内します。
• 一括取得は --start-page、--pages、--max-items、--with-detail、--output の組み合わせを優先的に使用します。
• AI分析用exportは --ai --output <directory> で .toon chunkを作成します。
• お気に入り/チャットは明示的に要求されない限り実行しません。

いつ使用するか

• 「番地장市場でiPhoneを検索してほしい」
• 「番장でこの商品の詳細を見てほしい」
• 「複数ページを集めてJSONで保存してほしい」
• 「AI評価用に番地장市場の結果をchunkにしてほしい」

いつ使用しないか

• アカウントログインなしで直接お気に入り/チャットを強制する必要がある場合
• 購入確定/決済の自動化を期待する場合
• 番地장市場以外の他の中古取引プラットフォームを同時に扱う必要がある場合

クイックスモークテスト

npx --yes bunjang-cli --help
npx --yes bunjang-cli --json auth status
npx --yes bunjang-cli --json search "아이폰" --max-items 3 --sort date
npx --yes bunjang-cli --json item get 354957625

ログインフロー

npx --yes bunjang-cli auth login
npx --yes bunjang-cli auth logout
npx --yes bunjang-cli --json auth status

• auth login はブラウザでログインした後、ターミナルに戻ってEnterキーを押すことで完了します。
• そのため、非TTY実行ではなくインタラクティブセッションでのみ実行します。

検索フロー

npx --yes bunjang-cli search "아이폰"
npx --yes bunjang-cli search "아이폰" --price-min 500000 --price-max 1200000
npx --yes bunjang-cli search "아이폰" --sort date
npx --yes bunjang-cli --json search "아이폰" --max-items 5

検索結果には広告/買い取り投稿/アクセサリーノイズが混在し、search summaryの location がノイズが多いか、description / status が空の場合があります。そのため、検索段階はタイトル/価格中心の1次トリアージとしてのみ使用します。

• デバイス名/容量キーワードの一致有無
• 価格帯の範囲
• 販売リンク/サムネイルの重複有無

description、status、クリーンな location が必要な場合は、必ず item get または --with-detail 実行後にのみ判断します。

詳細フロー

npx --yes bunjang-cli item get 354957625
npx --yes bunjang-cli --json item get 354957625
npx --yes bunjang-cli --json item list --ids 354957625,354801707

詳細表示では、以下のフィールドを最初に読みます。

• price
• description
• location
• category
• status
• sellerName
• sellerItemCount
• sellerFollowerCount
• sellerReviewCount
• favoriteCount
• transportUsed

一括取得

npx --yes bunjang-cli search "아이폰" \
  --start-page 1 \
  --pages 5 \
  --max-items 50 \
  --sort date \
  --with-detail \
  --output artifacts/bunjang-iphone.json

検証する際は、exportファイルの作成有無とトップレベルの items[] 内の summary / detail / オプションの error 構造、および各itemの sourcePage または summary.raw.page を併せて確認します。

AI export

npx --yes bunjang-cli search "아이폰" \
  --start-page 1 \
  --pages 5 \
  --max-items 50 \
  --with-detail \
  --ai \
  --output artifacts/bunjang-iphone-ai

• --ai では --output がファイルではなくディレクトリである必要があります。
• 結果は items-1.toon 形式のchunkで保存されます。
• AI評価用に複数のサブエージェントに分散読み取りさせるのに適しています。

オプション的なお気に入り/チャットフロー

ログイン済みのインタラクティブセッションでのみ、以下のアクションを実行します。

npx --yes bunjang-cli --json favorite list
npx --yes bunjang-cli --json favorite add 354957625
npx --yes bunjang-cli --json favorite remove 354957625
npx --yes bunjang-cli --json chat list
npx --yes bunjang-cli --json chat start 354957625 --message "안녕하세요"
npx --yes bunjang-cli --json chat send 84191651 --message "상품 상태 괜찮을까요?"

• お気に入り/チャットはログインが必要なオプション機能です。
• 検証目的の場合、favorite list でセッションを最初に確認し、同じ商品に対して favorite add / favorite remove を往復実行します。
• chat start は商品ページから新しい会話を開く場合、chat send は既存のスレッドにメッセージを送る場合に使用します。

推奨される応答形式

1. 検索語が広い場合は、予算/モデル/地域を最初に絞ります。
2. 検索結果の上位3～5件はタイトル/価格中心の1次要約のみを行います。
3. description / status / location の判断が必要な場合は、item get または --with-detail で詳細を最初に読みます。
4. ログインアクションが必要な場合は、「現在ログインセッションがないため、インタラクティブTTYで auth login を実行してから再度進める」と明確に述べます。
5. 大量分析の場合はJSON exportまたはTOON chunk生成パスを提案します。

完了時の条件

• 検索/詳細表示/一括取得/AI exportのうち必要なパスが案内されています。
• お気に入り/チャットはログイン必要性とオプション的性格が明確に周知されています。
• 自動購入/決済はスコープ外であることが明確に述べられています。