mcpField
X
xianyu-publish

xianyu-publish

github.com/smartcat999マーケティング・グロース6286 回インストール33 週間前に更新
リポジトリ

xianyu-publish について

ブラウザーからXianyuの商品出品と基本運用を行うスキルです。編集、出品の一時停止と再開、削除、未読メッセージの要約に対応し、事前確認や危険操作の承認を経て結果を報告します。

主な機能

  1. 01商品の出品と編集
  2. 02出品の公開と取り下げ
  3. 03二段階確認付きの削除
  4. 04未読問い合わせの要約
  5. 05事前チェックと実行結果の報告
  6. 06セーフモードと失敗時の停止

活用シーン

  1. 01Xianyuに商品を新規出品
  2. 02商品の価格や説明を変更
  3. 03商品の取り下げや再出品
  4. 04未読の購入希望者からの問い合わせを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/smartcat999/xianyu-publish --skill xianyu-publish

インストール後、Claude Code で/xianyu-publishを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
TROUBLESHOOTING.md
README.md
SECURITY.md
.gitignore
examples/
edit-relist.md
message-digest.md
publish.md
references/
feature-roadmap.md
v1-runbook.md
quickstart-safe-mode.md

詳細

xianyu-publish

依存関係と環境

  • 必須:browser ツール
  • 必須:Chrome Browser Relay(接続済み)
  • 必須:闲鱼のウェブサイトにログイン済み
  • デフォルトモード:MODE: safe

概要

闲鱼のウェブ版で、出品から基本的な運用までの一連の作業(出品、編集、出品・取り下げ、削除、メッセージの集約)を実行します。 デフォルトでは、まずページの状態を確認してから操作を実行し、最後に結果を報告します。

対応範囲(v1)

  • ✅ 対応済み:
    • 新しい商品の出品
    • 出品済み商品の編集(説明/価格/一部の属性)
    • 出品/取り下げ
    • 商品の削除(二重確認が必要)
    • メッセージを開いて未読の問い合わせを集約
  • ⚠️ 制限事項:
    • OS レベルのファイル選択ダイアログは安定して自動操作できません
    • 出品時に本人確認でブロックされた場合は、ユーザーが QR コードをスキャンした後に続行します

クイック判断

  • ユーザーが新しい商品を出品したい →「出品ワークフロー」を実行します。
  • ユーザーが「この商品の価格/説明を変更して」と言う →「編集ワークフロー」を実行します。
  • ユーザーが「いったん取り下げて/再出品して」と言う →「状態切り替えワークフロー」を実行します。
  • ユーザーが「この商品を削除して」と言う →「削除ワークフロー(強い確認)」を実行します。
  • ユーザーが「価格の問い合わせが来ているか見て」と言う →「メッセージ集約ワークフロー」を実行します。

初心者モード(MODE: safe、デフォルト)

  • トリガー語の例:闲鱼の管理を開始 / リスク管理モードで実行。
  • 動作:まず Preflight の自己診断を実行し、その後、操作可能な状態に移行します。
  • デフォルトの制限:
    • 高リスク操作(削除、一括価格変更、大量出品)の直接実行は禁止
    • 重要な操作には二重確認(確認語)が必要
    • 失敗が連続した場合は自動で遮断し、手動での引き継ぎを案内

Preflight(起動時の自己診断、操作を実行する前に実施)

  1. browser ツールが使用可能であること。
  2. Chrome Relay が現在のタブに接続されていること。
  3. goofish.com にアクセスでき、アカウントにログイン済みであること。
  4. アップロード機能が使用可能であること(/tmp/openclaw/uploads/ にアクセスでき、画像を挿入できること)。
  5. リスク管理の状態が正常であること(CAPTCHA/ログイン異常/インターフェースの連続エラーがないこと)。

自己診断結果のレベル:

  • 緑:そのままタスクを実行します。
  • 黄:続行できますが、まずリスクを知らせます(例:1 枚目の画像は手動での操作が必要な場合があります)。
  • 赤:実行を停止し、最短の復旧手順を案内します。

ワークフロー A:新しい商品を出品

  1. https://www.goofish.com/publish を開きます。
  2. 説明文を入力し、続けて価格と配送方法を入力します。
  3. 属性(カテゴリー、年齢、性別、品種など)を入力します。
  4. 1 枚目の画像をアップロードし、ページに反映されたことを確認します(「詳細画像を追加」と表示される、またはサムネイルが表示されるなど)。
  5. 出品ボタンをクリックし、画面遷移が成功したことを確認します。
  6. 結果を報告します:入力済みの項目、出品結果、異常項目。

ワークフロー B:出品済み商品の編集

  1. マイページ/出品中リストに移動し、対象商品(タイトル/価格/出品日時)を特定します。
  2. 編集ページを開き、対象項目(説明、販売価格、元の価格、配送方法など)を変更します。
  3. 保存して詳細ページに戻り、新しい値が反映されたことを確認します。
  4. 結果を報告します:変更内容、変更前後の値、反映の有無。

ワークフロー C:出品/取り下げ

  1. マイページの商品リストで対象商品を特定します。
  2. 取り下げ:そのまま「取り下げ」をクリックし、確認ダイアログで確定します。
  3. 再出品の優先順位:
    • 優先:リストにある「再出品」ボタン(存在する場合)を使用します。
    • 代替手段:編集ページ https://www.goofish.com/publish?itemId=<商品ID> に移動し、「出品」をクリックして再出品します。
  4. リストを更新し、状態が変わったこと(「取り下げ済み」↔「取り下げ」ボタン)を確認します。
  5. 結果を報告します:対象商品、現在の状態、通常手順と代替手順のどちらを使用したか。

ワークフロー D:商品の削除(高リスク)

  1. 1 回目の確認:影響範囲と元に戻せないことを説明します。
  2. 2 回目の確認:ユーザーに確認語 確認删除 <商品名> の入力を求めます。
  3. 削除を実行し、確認ダイアログに対応します。
  4. リストを更新し、商品が存在しなくなったことを確認します。
  5. 結果を報告します:削除結果と元に戻せないことの注意喚起。

ワークフロー E:メッセージの集約

  1. メッセージページを開き、未読メッセージを優先して確認します。
  2. 「商品ごと」に問い合わせを集約します:価格、送料込みかどうか、販売中かどうか、直接受け取り可能かどうか。
  3. 簡潔な要約を出力します。ユーザーが明確に求めない限り、購入者には自動送信しません。

画像アップロードのルール(安定性に関する重要事項)

  • まずプログラムによるアップロードを試し、システムのファイル選択ダイアログは使用しません。
  • アップロードするファイルは、まず /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

コメント