xianyu-publish について
ブラウザーからXianyuの商品出品と基本運用を行うスキルです。編集、出品の一時停止と再開、削除、未読メッセージの要約に対応し、事前確認や危険操作の承認を経て結果を報告します。
主な機能
- 01商品の出品と編集
- 02出品の公開と取り下げ
- 03二段階確認付きの削除
- 04未読問い合わせの要約
- 05事前チェックと実行結果の報告
- 06セーフモードと失敗時の停止
活用シーン
- 01Xianyuに商品を新規出品
- 02商品の価格や説明を変更
- 03商品の取り下げや再出品
- 04未読の購入希望者からの問い合わせを確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ smartcat999/ xianyu-publish --skill xianyu-publishインストール後、Claude Code で/xianyu-publishを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
CHANGELOG.mdTROUBLESHOOTING.mdREADME.mdSECURITY.md.gitignoreexamples/edit-relist.mdmessage-digest.mdpublish.mdreferences/feature-roadmap.mdv1-runbook.mdquickstart-safe-mode.md詳細
xianyu-publish
依存関係と環境
- 必須:
browserツール - 必須:Chrome Browser Relay(接続済み)
- 必須:闲鱼のウェブサイトにログイン済み
- デフォルトモード:
MODE: safe
概要
闲鱼のウェブ版で、出品から基本的な運用までの一連の作業(出品、編集、出品・取り下げ、削除、メッセージの集約)を実行します。 デフォルトでは、まずページの状態を確認してから操作を実行し、最後に結果を報告します。
対応範囲(v1)
- ✅ 対応済み:
- 新しい商品の出品
- 出品済み商品の編集(説明/価格/一部の属性)
- 出品/取り下げ
- 商品の削除(二重確認が必要)
- メッセージを開いて未読の問い合わせを集約
- ⚠️ 制限事項:
- OS レベルのファイル選択ダイアログは安定して自動操作できません
- 出品時に本人確認でブロックされた場合は、ユーザーが QR コードをスキャンした後に続行します
クイック判断
- ユーザーが新しい商品を出品したい →「出品ワークフロー」を実行します。
- ユーザーが「この商品の価格/説明を変更して」と言う →「編集ワークフロー」を実行します。
- ユーザーが「いったん取り下げて/再出品して」と言う →「状態切り替えワークフロー」を実行します。
- ユーザーが「この商品を削除して」と言う →「削除ワークフロー(強い確認)」を実行します。
- ユーザーが「価格の問い合わせが来ているか見て」と言う →「メッセージ集約ワークフロー」を実行します。
初心者モード(MODE: safe、デフォルト)
- トリガー語の例:
闲鱼の管理を開始/リスク管理モードで実行。 - 動作:まず Preflight の自己診断を実行し、その後、操作可能な状態に移行します。
- デフォルトの制限:
- 高リスク操作(削除、一括価格変更、大量出品)の直接実行は禁止
- 重要な操作には二重確認(確認語)が必要
- 失敗が連続した場合は自動で遮断し、手動での引き継ぎを案内
Preflight(起動時の自己診断、操作を実行する前に実施)
- browser ツールが使用可能であること。
- Chrome Relay が現在のタブに接続されていること。
- goofish.com にアクセスでき、アカウントにログイン済みであること。
- アップロード機能が使用可能であること(
/tmp/openclaw/uploads/にアクセスでき、画像を挿入できること)。 - リスク管理の状態が正常であること(CAPTCHA/ログイン異常/インターフェースの連続エラーがないこと)。
自己診断結果のレベル:
- 緑:そのままタスクを実行します。
- 黄:続行できますが、まずリスクを知らせます(例:1 枚目の画像は手動での操作が必要な場合があります)。
- 赤:実行を停止し、最短の復旧手順を案内します。
ワークフロー A:新しい商品を出品
https://www.goofish.com/publishを開きます。- 説明文を入力し、続けて価格と配送方法を入力します。
- 属性(カテゴリー、年齢、性別、品種など)を入力します。
- 1 枚目の画像をアップロードし、ページに反映されたことを確認します(「詳細画像を追加」と表示される、またはサムネイルが表示されるなど)。
- 出品ボタンをクリックし、画面遷移が成功したことを確認します。
- 結果を報告します:入力済みの項目、出品結果、異常項目。
ワークフロー B:出品済み商品の編集
- マイページ/出品中リストに移動し、対象商品(タイトル/価格/出品日時)を特定します。
- 編集ページを開き、対象項目(説明、販売価格、元の価格、配送方法など)を変更します。
- 保存して詳細ページに戻り、新しい値が反映されたことを確認します。
- 結果を報告します:変更内容、変更前後の値、反映の有無。
ワークフロー C:出品/取り下げ
- マイページの商品リストで対象商品を特定します。
- 取り下げ:そのまま「取り下げ」をクリックし、確認ダイアログで確定します。
- 再出品の優先順位:
- 優先:リストにある「再出品」ボタン(存在する場合)を使用します。
- 代替手段:編集ページ
https://www.goofish.com/publish?itemId=<商品ID>に移動し、「出品」をクリックして再出品します。
- リストを更新し、状態が変わったこと(「取り下げ済み」↔「取り下げ」ボタン)を確認します。
- 結果を報告します:対象商品、現在の状態、通常手順と代替手順のどちらを使用したか。
ワークフロー D:商品の削除(高リスク)
- 1 回目の確認:影響範囲と元に戻せないことを説明します。
- 2 回目の確認:ユーザーに確認語
確認删除 <商品名>の入力を求めます。 - 削除を実行し、確認ダイアログに対応します。
- リストを更新し、商品が存在しなくなったことを確認します。
- 結果を報告します:削除結果と元に戻せないことの注意喚起。
ワークフロー E:メッセージの集約
- メッセージページを開き、未読メッセージを優先して確認します。
- 「商品ごと」に問い合わせを集約します:価格、送料込みかどうか、販売中かどうか、直接受け取り可能かどうか。
- 簡潔な要約を出力します。ユーザーが明確に求めない限り、購入者には自動送信しません。
画像アップロードのルール(安定性に関する重要事項)
- まずプログラムによるアップロードを試し、システムのファイル選択ダイアログは使用しません。
- アップロードするファイルは、まず
/tmp/openclaw/uploads/に置きます。 - システムのファイル選択ダイアログが表示された場合:ユーザーにキャンセルしてもらってから、プログラムによるアップロードを再試行します。
- アップロード後、必ずページへの反映を確認します。
upload okだけでは成功とはみなしません。
失敗時の対応
- 出品ボタンが機能しない/画面遷移しない:必須項目(画像、属性、価格)を確認します。「再出品」の場合は、優先して
publish?itemId=の編集ページに切り替えてから出品します。 - 属性がページによって書き戻される:出品前の最後の手順でもう一度確認し、入力し直します。
- アップロードは成功したが画像が添付されていない:挿入を再試行します。それでも失敗する場合は、ユーザーに 1 枚目の画像を手動でアップロードしてもらい、その後の操作を自動化で引き継ぎます。
- 本人確認でブロックされた場合:ユーザーに QR コードをスキャンして本人確認するよう案内し、完了後に続行します。
リスク管理のルール(デフォルトで有効)
- 操作間隔の管理:重要な操作(出品/取り下げ/再出品/価格変更)の間は、少なくとも 15~30 秒空けます。
- 推奨頻度の上限:
- 出品:1 時間あたり ≤ 5 回
- 価格変更:1 時間あたり ≤ 8 回
- 出品・取り下げ:1 時間あたり ≤ 6 回
- 連続失敗時の遮断:同種の操作に 2 回連続で失敗した場合は自動化を一時停止し、手動で確認してから再開します。
- 説明文の重複回避:一括出品の場合、重複が多くならないようにタイトル/説明を少しずつ変えます。
- 画像の扱い:短時間に同じ 1 枚目の画像を複数の商品へ繰り返しアップロードすることは避けます。
- 環境の安定性:頻繁な切り替えを避けるため、ログイン環境(デバイス/IP/ブラウザー)はできるだけ固定します。
- 異常時は操作を停止:CAPTCHA、ログイン異常、インターフェース異常など、リスク管理上の兆候が見られた場合は、高頻度の再試行を直ちに停止します。
対話のルール
- 実行前に必要なパラメーターをまとめて収集し、確認のやり取りを減らします。
- 高リスク操作(削除、大幅な価格変更)は必ず確認します。
- 結果報告は簡潔かつ正確にします:完了/未完了/阻害要因/次の手順。
参考資料
- v1 機能ロードマップ:
references/feature-roadmap.md - v1 実践チェックリスト:
references/v1-runbook.md - 初心者向けワンクリック起動:
references/quickstart-safe-mode.md
コメント
Markdown 対応