mcpField
T
topview-amazon-ops

topview-amazon-ops

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

topview-amazon-ops について

ホストの統合 `topview-mcp` サーバーを介して、公開されている Amazon の市場、ASIN、キーワード情報を扱うスキルです。ツールの発見と呼び出しを案内し、Amazon データ用とクリエイティブ用を区別します。

主な機能

  1. 01Amazon の市場、ASIN、キーワード情報
  2. 02遅延ロードされるツールの段階的な発見
  3. 03呼び出し前のツールスキーマ確認
  4. 04Amazon 用とクリエイティブ用のツール振り分け

活用シーン

  1. 01Amazon の市場やカテゴリーの調査
  2. 02ASIN またはキーワードデータの検索
  3. 03クエリ前のツールスキーマ確認
  4. 04クリエイティブ依頼を `topview-generate` に引き継ぐ

MCP 対応

ホストに接続された `topview-mcp` サーバーを使い、`get_tool_schema` と `call_tool` で遅延ロードされる Amazon ドメインのツールを発見・呼び出します。同じサーバー上のクリエイティブ用ツールは `topview-generate` に直接振り分けます。

インストール

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

$npx skills add https://github.com/topviewai/skill --skill topview-amazon-ops

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

同梱ファイルreferences/tool_routing.md

詳細

Topview Amazon 運用

ホストの統合 topview-mcp サーバーを通じて、Amazon の市場／ASIN／キーワードに関する公開情報を取得します（プログレッシブディスクロージャー、ドメインは amazon）。

ステップ 0 — 初期設定

  1. ホストで MCP サーバー topview-mcp がすでに接続されていることを確認します（use_amazon_data、get_tool_schema、call_tool を探します）。
  2. ツールが見つからない場合は、リポジトリの mcp.example.json からサーバーを ~/.cursor/mcp.json に追加し、MCP を再読み込みしてから再試行するようユーザーに伝えます。
  3. 絶対に scripts/mcp_call.py を実行したり、自分で SSE を開いたり、curl／生の HTTP を使ったりしないでください。

実行

サーバー：topview-mcp（統合型）。自分で SSE を開かないでください。

Amazon データツールは遅延読み込みされるため、トップレベルの tools/list エントリには表示されません。プログレッシブディスクロージャーを通じて呼び出します。

  1. tools/list にある use_amazon_data の説明（埋め込みのツールカタログ）を読みます。ツールの一覧表示だけを目的に use_amazon_data を呼び出すのは任意です。カタログにまだ読み込まれていないと記載されている場合は、Amazon プロキシのウォームアップのために 1 回呼び出します。
  2. カタログまたは references/tool_routing.md から遅延読み込みツール名を選びます。
  3. { "name": "<deferred>", "domain": "amazon" } を指定して get_tool_schema を呼び出します。
  4. { "name": "<deferred>", "domain": "amazon", "arguments": { ... } } を指定して call_tool を呼び出します。

ホストでの一般的なツール ID：mcp__topview-mcp__get_tool_schema／mcp__topview-mcp__call_tool（Cursor では user- が前置される場合があります）。
market_research などの遅延読み込みツール名が、トップレベルのツールとして直接利用できるとは想定しないでください。クリエイティブツール（topview_*／ta_*）も同じサーバーにありますが、topview-generate に属しています。これらは直接呼び出し、call_tool 経由では呼び出さないでください。

UX ルール

  1. 簡潔にし、RPC の情報ではなく調査結果を先に伝えます。
  2. ツールのスキーマで必要な場合は、マーケットプレイス／カテゴリ／ASIN／キーワードをユーザーに確認します。
  3. 非公開の Seller Central の広告／注文／利益の数値を決して捏造しないでください。
  4. ユーザーの言語に合わせます。
  5. 分析後、ユーザーがクリエイティブを希望する場合は、topview-generate に引き継ぎます。

出典

ルーティングは、Marketing Studio の Amazon エキスパートスキル（V032）を参考にしています。

コメント

Markdown 対応