heqiangdiao-wq/AI-Cross-Border-Ecommerce-Agent-Toolkit
AI 跨境电商运营智能体工具箱 · 把运营 SOP 拆成 7 个可复用的 AI Agent 工作流,含 Prompt、模板与真实案例
AI越境ECエージェントツールキット
概要 – 越境ECのSOPを再現可能なワークフローに変換する、すぐに使える7つのAIエージェント「スキル」のコレクションです。各エージェントには以下が含まれます:
- 役割と契約を定義するシステムプロンプト、
- 入出力テンプレート、
- 小さなヘルパースクリプト(例:市場指標計算機、コンプライアンスチェック)、
- サンプルデータと自己検証用チェックリスト。
このツールキットはSaaSプラットフォームを提供するものではありません。プロンプトとテンプレートを任意のLLM(OpenAI、Claudeなど)に入力して、エージェントをローカルで実行します。
コアエージェント(7つ)
| # | エージェント | 主な役割 |
|---|---|---|
| 01 | 市場調査エージェント | カテゴリデータを解析し、集中度、価格帯、機会指標を計算します(バンドルされたスクリプトを使用)。 |
| 02 | 商品戦略エージェント | ポジショニング、SKU構成、価格モデル、利益率マトリックスを決定します。 |
| 03 | リスティングクリエイティブエージェント | キーワードグループ、タイトル、箇条書き、仕様表を生成し、文字数チェックと禁止語チェックを含みます。 |
| 04 | 商品画像エージェント | 9画像グリッドを計画し、画像生成プロンプトを作成し、ピクセルレベルのコンプライアンスチェックを実行します。 |
| 05 | 商品動画エージェント | スクリプトとストーリーボードを作成し、AI動画プロンプトを構築し、ナレーションと字幕を追加します。 |
| 06 | 広告最適化エージェント | ファネル段階を診断し、損益分岐CPCを計算し、段階的なアクション(P0-P2)を提案します。 |
| 07 | レビュー分析エージェント | レビューを8つの帰属カテゴリに分類し、誤解を特定し、リスティングの改善を提案します。 |
すべてのエージェントは**✅ v0.4**(安定版)とマークされ、SKILL.mdファイルとしてパッケージ化されており、スキルベースのLLMフレームワークにインポートできます。
実行方法(APIキー不要)
- 目的のエージェントの
templates/フォルダをコピーします。 - 商品情報を入力します(約10分)。
- システムプロンプト、タスクプロンプト、入力済みテンプレートを連結します。
- 結合したテキストを任意のLLMに送信します。
- 公開前に
docs/04_Result_Checklist.mdで出力を検証します。
リポジトリには、市場調査から広告/レビューフィードバックループまでの全チェーンを説明する完全なエンドツーエンドの例(電動スクーター)が含まれています。
コンプライアンス重視
元の内部SOPには禁止された戦術(例:偽注文、虚偽の主張)が含まれています。このツールキットはそれらの行為を除外し、レッドラインとコンプライアンスに準拠した代替案をリストした03_Compliance_Guard.mdファイルを提供します。別の05_SOP_Gap_Register.mdには、省略されたすべての項目が記録されています。
プラットフォーム対応
| プラットフォーム | サポートレベル | 主な制約 |
|---|---|---|
| Shopee(ブラジル) | ✅ ファーストクラス | 120文字のタイトル制限、9画像白背景グリッド、PT-BR言語 |
| Mercado Livre | ✅ ファーストクラス | 60文字のタイトル、クリーンな背景画像、PT-BR/ES |
| Amazon | 📄 フィールドマッピング済み | 200文字のタイトル(推奨80)、純白背景 |
| TikTok Shop | 📄 フィールドマッピング済み | 縦9:16画像を推奨 |
| Shopify | 📄 フィールドマッピング済み | ハードな制限なし |
詳細なフィールド仕様はdocs/02_Platform_Output_Spec.mdにあります。
ロードマップ概要
- v0.3(現在):全7エージェント、データ解析スクリプト、コンプライアンスガード。
- v1.0:直接アップロード用のワンクリック素材パッケージ生成。
- v2:Shopee / Mercado Livreからライブデータを取得するAPI統合。
- v3:視覚的なワークフローオーケストレーションのためのWeb UI。
- v4:クローズドループ最適化を備えた完全自動化・スケジュール実行エージェント。
対象ユーザー
- 専門家のSOPを反復可能なLLM駆動プロセスにコード化したい越境ECセラー。
- 複数のクライアントストア向けの内部ツールを構築する代理店。
- 具体的なプロンプトエンジニアリングの例と再利用可能なスキルバンドルを探している開発者。
ライセンス
MIT – 自由に使用、変更、共有できます。
結論 – このツールキットは、ホスト型サービスを必要とせず、任意のLLMで実行できるモジュール式AIエージェントに、熟練したEC知識を変換するための実用的でコンプライアンス優先の青写真です。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト