Bunjang Search

此技能的功能

使用上游 bunjang-cli / pinion05/bunjangcli 處理 번개장터 的以下流程：

商品搜尋
商品詳細查詢
選擇性收藏/聊天
多頁大量收集
用於 AI 分析的 TOON chunk 匯出

核心原則

基本路徑始終以 CLI 優先。
基本指令使用 npx --yes bunjang-cli ... 格式。
auth login 需要 headful 瀏覽器 + TTY / 互動式終端機。
登入前，僅回覆搜尋/詳細查詢/大量收集相關內容，favorite / chat / purchase 僅作為選擇性登入流程引導。
大量收集優先使用 --start-page、--pages、--max-items、--with-detail、--output 組合。
用於 AI 分析的匯出使用 --ai --output <directory> 產生 .toon chunk。
除非明確要求，否則不執行收藏/聊天。

使用時機

「幫我在 번개장터 搜尋 iPhone」
「幫我看這個商品的詳細資訊」
「幫我收集多頁結果並存成 JSON」
「幫我把 번개장터 結果做成 chunk 供 AI 評估」

不使用時機

需要在未登入帳號的情況下強制執行收藏/聊天
期望自動化購買確認/付款
需要同時處理 번개장터 以外的其他二手交易平台

快速測試

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 才算完成。
因此僅在互動式 session 中執行，而非非 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

搜尋結果可能混雜廣告/收購文/配件雜訊，且搜尋摘要的 location 可能不準確，description 或 status 可能為空。因此搜尋階段僅作為以標題/價格為主的初步篩選。

檢查機型名稱/容量關鍵字是否相符
價格區間範圍
銷售連結/縮圖是否重複

如果需要 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

驗證時，檢查匯出檔案是否產生，以及頂層 items[] 中的 summary / detail / 可選的 error 結構，並確認每個 item 的 sourcePage 或 summary.raw.page。

AI 匯出

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 評估。

選擇性收藏/聊天流程

僅在已登入的互動式 session 中執行以下操作：

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 確認 session，再對同一商品執行 favorite add / favorite remove 來回測試。
chat start 用於在商品頁面開啟新對話，chat send 用於在現有對話中發送訊息。

建議的回覆格式

若搜尋詞過於廣泛，先縮小預算/型號/地區範圍。
搜尋結果前 3~5 個僅以標題/價格進行初步摘要。
若需判斷 description / status / location，先透過 item get 或 --with-detail 讀取詳細資訊。
若需登入操作，明確告知「目前無登入 session，請在互動式 TTY 中執行 auth login 後再繼續」。
若為大量分析，建議使用 JSON 匯出或 TOON chunk 生成路徑。

完成條件

已引導完成搜尋/詳細查詢/大量收集/AI 匯出等所需路徑。
已明確告知收藏/聊天需要登入且為選擇性功能。
已明確說明自動購買/付款不在此技能範圍內。

bunjang-search

相關技能