Back to Details

bunjang-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bunjang Search

Bunjang 搜索

What this skill does

功能说明

upstream 
bunjang-cli
 / 
pinion05/bunjangcli
 를 사용해 번개장터에서 아래 흐름을 처리한다.
  • 상품 검색
  • 상품 상세조회
  • 선택적 찜/채팅
  • 다페이지 대량 수집
  • AI 분석용 TOON chunk export
基于上游工具 
bunjang-cli
 / 
pinion05/bunjangcli
 实现闪电市场的以下操作流程：
  • 商品搜索
  • 商品详情查询
  • 可选收藏/聊天功能
  • 多页批量数据采集
  • 导出AI分析用TOON分片

Core policy

核心规则

  • 기본 경로는 항상 CLI first 다.
  • 기본 명령은 
    npx --yes bunjang-cli ...
    형식을 쓴다.
  • auth login
    은 headful 브라우저 + TTY / interactive 터미널이 필요하다.
  • 로그인 전에는 검색/상세조회/대량 수집 위주로 답하고, 
    favorite
    / 
    chat
    / 
    purchase
    는 선택적 로그인 플로우로만 안내한다.
  • 대량 수집은 
    --start-page
    , 
    --pages
    , 
    --max-items
    , 
    --with-detail
    , 
    --output
    조합을 우선 쓴다.
  • AI 분석용 export 는 
    --ai --output <directory>
    로 
    .toon
    chunk 를 만든다.
  • 찜/채팅은 명시적으로 요청받지 않으면 실행하지 않는다.
  • 功能实现始终优先使用CLI
  • 默认命令采用 
    npx --yes bunjang-cli ...
    格式
  • auth login
    操作需要有头浏览器 + TTY/交互式终端支持
  • 未登录状态下仅支持搜索/详情查询/批量采集功能，
    favorite
    /
    chat
    /
    purchase
    功能仅引导走可选登录流程
  • 批量采集优先组合使用 
    --start-page
    、
    --pages
    、
    --max-items
    、
    --with-detail
    、
    --output
    参数
  • AI分析导出使用 
    --ai --output <目录>
    生成 
    .toon
    分片文件
  • 未收到明确请求时不执行收藏/聊天操作

When to use

适用场景

  • "번개장터에서 아이폰 검색해줘"
  • "번장에서 이 상품 상세 봐줘"
  • "여러 페이지 모아서 JSON으로 저장해줘"
  • "AI 평가용으로 번개장터 결과를 chunk 로 만들어줘"
  • "帮我在闪电市场搜索iPhone"
  • "帮我查看闪电市场上这个商品的详情"
  • "把多页搜索结果收集起来存为JSON文件"
  • "将闪电市场搜索结果生成分片供AI评估使用"

When not to use

不适用场景

  • 계정 로그인 없이 바로 찜/채팅을 강행해야 하는 경우
  • 구매 확정/결제 자동화를 기대하는 경우
  • 번개장터 외 다른 중고거래 플랫폼을 동시에 다뤄야 하는 경우
  • 无需账号登录直接强制使用收藏/聊天功能的场景
  • 期望实现自动确认购买/支付功能的场景
  • 需要同时处理闪电市场以外其他二手交易平台的场景

Quick smoke test

快速冒烟测试

bash
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
bash
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

Login flow

登录流程

bash
npx --yes bunjang-cli auth login
npx --yes bunjang-cli auth logout
npx --yes bunjang-cli --json auth status
  • auth login
    은 브라우저에서 로그인한 뒤 터미널로 돌아와 Enter 를 눌러야 완료된다.
  • 그래서 비-TTY 실행 대신 interactive 세션에서만 진행한다.
bash
npx --yes bunjang-cli auth login
npx --yes bunjang-cli auth logout
npx --yes bunjang-cli --json auth status
  • 执行
    auth login
    时，需要在浏览器完成登录后返回终端按下回车键才能完成操作
  • 因此仅支持在交互式会话中执行，不可在非TTY环境运行

Search flow

搜索流程

bash
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
이 noisy 하거나 
description
/ 
status
가 비어 있을 수 있다. 그래서 검색 단계는 제목/가격 중심 1차 triage 로만 쓴다.
  • 기기명/용량 키워드 일치 여부
  • 가격대 범위
  • 판매 링크/썸네일 중복 여부
description
, 
status
, 깔끔한 
location
이 필요하면 반드시 
item get
또는 
--with-detail
이후 에만 판단한다.
bash
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
参数之后再做判断

Detail flow

详情查询流程

bash
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
bash
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

Bulk collection

批量采集

bash
npx --yes bunjang-cli search "아이폰" \
  --start-page 1 \
  --pages 5 \
  --max-items 50 \
  --sort date \
  --with-detail \
  --output artifacts/bunjang-iphone.json
검증할 때는 export 파일 생성 여부와 top-level 
items[]
안의 
summary
/ 
detail
/ optional 
error
구조, 그리고 각 item 의 
sourcePage
또는 
summary.raw.page
를 같이 확인한다.
bash
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 export

AI导出

bash
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 평가용으로 여러 서브에이전트에 분산 읽기시키기 좋다.
bash
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
    格式的分片存储，适合分发给多个子Agent进行分布式读取，用于AI评估场景

Optional favorite/chat flow

可选收藏/聊天流程

로그인된 interactive 세션에서만 아래 액션을 진행한다.
bash
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
    는 기존 thread 에 메시지를 보낼 때 쓴다.
仅在已登录的交互式会话中执行以下操作：
bash
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
    用于向已有会话线程发送消息

Recommended response format

推荐回复格式

  1. 검색어가 넓으면 예산/모델/지역을 먼저 좁힌다.
  2. 검색 결과 상위 3~5개는 제목/가격 중심 1차 요약만 한다.
  3. description
    / 
    status
    / 
    location
    판단이 필요하면 
    item get
    또는 
    --with-detail
    로 상세를 먼저 읽는다.
  4. 로그인 액션이 필요하면 "지금은 로그인 세션이 없으니 interactive TTY 에서 
    auth login
    후 다시 진행" 이라고 분명히 말한다.
  5. 대량 분석이면 JSON export 또는 TOON chunk 생성 경로를 제안한다.
  1. 如果搜索词范围太广，先引导用户缩小预算、型号、地区范围
  2. 搜索结果前3~5条仅做以标题、价格为核心的初步摘要
  3. 如果需要判断
    description
    /
    status
    /
    location
    信息，先通过
    item get
    或添加
    --with-detail
    参数读取详情后再回复
  4. 如果需要登录操作，明确告知用户「当前无登录会话，请在交互式TTY中执行
    auth login
    后再继续操作」
  5. 如果是批量分析场景，建议用户生成JSON导出或TOON分片并提供存储路径

Done when

完成条件

  • 검색/상세조회/대량 수집/AI export 중 필요한 경로가 안내되었다.
  • 찜/채팅은 로그인 필요성과 선택적 성격이 명확히 고지되었다.
  • 자동 구매/결제는 범위 밖이라고 분명히 말했다.
  • 已引导用户完成搜索、详情查询、批量采集、AI导出中所需的流程
  • 已明确告知用户收藏/聊天功能需要登录且为可选功能
  • 已明确说明自动购买/支付不属于工具支持范围