bunjang-search

Bunjang Search

本技能的功能

使用上游 bunjang-cli / pinion05/bunjangcli 处理Bunjang上的以下流程：

• 商品搜索
• 商品详情查看
• 可选收藏/聊天
• 多页批量采集
• 用于AI分析的TOON chunk导出

核心策略

• 默认路径始终以CLI优先。
• 默认命令使用 npx --yes bunjang-cli ... 格式。
• auth login 需要带浏览器的TTY / 交互式终端。
• 登录前，主要回答搜索/详情查看/批量采集相关问题，favorite / chat / purchase 仅作为可选登录流程引导。
• 批量采集优先使用 --start-page、--pages、--max-items、--with-detail、--output 组合。
• AI分析导出使用 --ai --output <directory> 创建 .toon chunk。
• 收藏/聊天除非明确请求，否则不执行。

使用时机

• “帮我搜索Bunjang上的iPhone”
• “帮我看看这个商品的详情”
• “帮我收集多页数据并保存为JSON”
• “将Bunjang结果导出为chunk用于AI评估”

不使用时机

• 需要在不登录账户的情况下强制收藏/聊天
• 期望自动确认购买/支付
• 需要同时处理Bunjang以外的其他二手交易平台

快速测试

npx --yes bunjang-cli --help
npx --yes bunjang-cli --json auth status
npx --yes bunjang-cli --json search "iPhone" --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 "iPhone"
npx --yes bunjang-cli search "iPhone" --price-min 500000 --price-max 1200000
npx --yes bunjang-cli search "iPhone" --sort date
npx --yes bunjang-cli --json search "iPhone" --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 "iPhone" \
  --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 "iPhone" \
  --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个仅做基于标题/价格的初步摘要。
3. 如果需要判断 description / status / location，先用 item get 或 --with-detail 读取详情。
4. 如果需要登录操作，明确说明“当前没有登录会话，请在交互式TTY中执行 auth login 后再继续”。
5. 如果是批量分析，建议JSON导出或TOON chunk生成路径。

完成条件

• 已引导搜索/详情查看/批量采集/AI导出中的所需路径。
• 已明确告知收藏/聊天需要登录且为可选功能。
• 已明确说明自动购买/支付不在本技能范围内。