1688-shopkeeper

1688-shopkeeper

統一エントリーポイント：python3 {baseDir}/cli.py <command> [options]

コマンド早見表

コマンド	説明	例
search	商品を探す	cli.py search --query "帮我找1688上支持一件代发包邮的露营椅，100元以内" --channel douyin
prod_detail	商品詳細	cli.py prod_detail --item-ids "991122553819,894138137003"
shops	紐づいている店舗を確認	cli.py shops
publish	商品を出品	cli.py publish --shop-code CODE --data-id ID
opportunities	商機ランキング	cli.py opportunities
trend	トレンド分析	cli.py trend --query "大码女装"
shop_daily	店舗運営日報	cli.py shop_daily
configure	AK を設定	cli.py configure YOUR_AK
check	設定状態を確認	cli.py check

すべてのコマンドは JSON を出力します：{"success": bool, "markdown": str, "data": {...}} 表示する際は markdown フィールドをそのまま出力し、エージェントによる分析はその後に追加してください。フィールド内に混ぜてはいけません。

使用手順

エージェントはユーザーの意図に応じて対応するコマンドを直接実行し、毎回最初に check を実行する必要はありません。 各コマンドは、AK が未設定の場合や店舗に異常がある場合などに、明確なエラーを自ら返します。エージェントは下記の「異常への対応」に従ってください。

商品選定・出品の典型的な流れ：search → ユーザーが選択 → shops（対象店舗を確認） → publish

商品詳細の使用ガイド：

• prod_detail：ユーザーが商品タイトル、価格、カテゴリ、SKU、CPV 属性、事業者情報を見たい場合に使用します。

商機・トレンドの使用ガイド：

• opportunities：ユーザーが「今／直近1時間／ランキング／トレンド商機」を見たい場合に使用します。
• trend：ユーザーが広いカテゴリや業界の周期的なトレンド、価格分布、人気商品の概要について尋ねた場合に使用します。キーワードが長すぎる、または細かすぎる場合は、まずユーザーの元のキーワードで試し、結果が空なら、より広いキーワードに変更するか、分割して再試行するようユーザーに案内してください。
• shop_daily：ユーザーが「店舗運営日報／今日の販売状況／チャネル運営診断／主力商品の選定提案」を見たい場合に使用します。

安全に関する宣言

リスクレベル	コマンド	エージェントの動作
読み取り専用	search, shops, check, opportunities, trend, shop_daily	直接実行
設定	configure	影響範囲を案内してから実行
書き込み	publish	必ず事前に dry-run で確認してください。書き込み先が一意でない場合に限りユーザーに確認し、一意であればそのまま実行してください

すべての書き込み操作に適用される共通ルール：

1. 必ず先に dry-run を実行します。
2. 書き込み先が一意でない場合（商品または店舗に複数の候補がある場合）に限り、曖昧さを解消するためにユーザーに一度だけ確認します。
3. 書き込み先が一意の場合、dry-run が成功したら正式な書き込みをそのまま実行し、再確認は不要です。

異常への対応

いずれかのコマンドが success: false を出力した場合：

1. まず markdown フィールドを出力します（ユーザー向けのエラー説明が含まれています）
2. 次にキーワードに応じた案内を追加します：

markdown のキーワード	エージェントの追加対応
"AK 未配置" または "签名无效"/"401"	下記の AK 案内文を出力
"授权过期"	1688 AI版 APP で再認証するようユーザーに案内
"店铺未绑定" または shops が店舗を 0 件返す	下記の 開店案内文を出力
"限流"/"429"	1～2 分待ってから再試行するようユーザーに案内
その他	markdown のみを出力

エラーコードの詳細については references/common/error-handling.md を参照してください。

実行前の準備（各機能を初めて実行する際に必須）

• search の初回実行前：references/capabilities/search.md をすべて読んでください
• prod_detail の初回実行前：references/capabilities/prod_detail.md をすべて読んでください
• shops の初回実行前：references/capabilities/shops.md をすべて読んでください
• publish の初回実行前：references/capabilities/publish.md をすべて読んでください
• configure の初回実行前：references/capabilities/configure.md をすべて読んでください
• opportunities の初回実行前：references/capabilities/opportunities.md をすべて読んでください
• trend の初回実行前：references/capabilities/trend.md をすべて読んでください
• shop_daily の初回実行前：references/capabilities/shop_daily.md をすべて読んでください
• 同一セッション内で同じ機能を再度呼び出す場合は、読み込み済みの知識を再利用できます。ルールの競合やドキュメントの更新がある場合にのみ、読み直してください。

AK 案内文

"まず AK を設定する必要があります。1688 AI版 APP を開き（インストールしていない場合はリンクからダウンロードしてください）、ホーム画面で「一键部署开店Claw，全自动化赚钱🦞」をタップしてページに進み、AK を取得してください。その後、「私の AK は xxx です」と伝えてください。"

開店案内文

"まだ店舗が紐づいていません。1688 AI版APP を開き、ホーム画面の「一键开店」をタップしてください。開店が完了したらお知らせください。"

FAQ ナレッジベース（必要に応じて読み込み）

ユーザーから運営や技術に関する質問があった場合は、回答する前に該当ファイルを読み込んでください。経験だけを頼りに大まかな回答をしてはいけません。

ユーザーの話題	読み込むファイル
AK の問題、商品出品の失敗、対応プラットフォーム、料金	references/faq/base.md
どのプラットフォームを選ぶか、抖店／拼多多／淘宝	references/faq/platform-selection.md
商品選定のリスク、カテゴリ、季節・イベントに合わせた商品選定	references/faq/product-selection.md
送料テンプレート、価格設定、値上げ倍率	references/faq/listing-template.md
発送の遅延、中継手数料、遠隔地	references/faq/fulfillment.md
返品、返金のみ、運賃保険、購入後のサポート	references/faq/after-sales.md
新店舗の初売上、サービス評価、プロモーション	references/faq/new-store.md
素材の審査、白背景画像、タイトルの最適化	references/faq/content-compliance.md