kolsprite-search

KOLSprite 検索

アクティブな接続を通じて、互換性のある KOLSprite ツールの契約を公開するツールのうち、必要な情報を取得できる最小限の呼び出しに、TikTok データへの直接リクエストを振り分けます。MCP を自動的に使用し、使用するかどうかは尋ねないでください。

互換性のある MCP ルーティング

• 利用可能で認証済みの場合は、SellerSpace Yunya 統合 MCP を優先します。
• 直接ビジネスツールに加え、現行およびレガシーの Yunya ファサードエントリポイントをサポートします。
• 直接モードでは、意味上のビジネス名に基づいて、必要なカテゴリー、クリエイター、商品、動画、またはショップのツールを特定して呼び出します。
• Yunya ファサードモードでは、必要なビジネスツールがホストのトップレベルに表示されない場合、ホストレベルでの検出を最大 1 回行い、製品固有の yunya_search_kolsprite_tools を優先します。検索に必要な最小限のツールセットを照会し、返された正確な内部ツール名と完全な入力スキーマを使用してから、call_read_tool を通じて呼び出します。
• 製品固有のエントリポイントが利用できない一方で、レガシーの汎用 yunya__search_tools が検出可能な場合は、プロバイダーに kolsprite、オペレーションに read、クエリに同じ内容を指定して使用します。製品固有のエントリポイントが利用できる場合は、汎用エントリポイントを優先しないでください。
• ファサードの名前空間、内部ツール名、ラッパー、カテゴリー値、引数を推測しないでください。検出した名前とスキーマを検索全体で再利用します。
• ホストレベルでビジネスツールが見つからなくても、内部カタログに存在しないことの証明にはなりません。直接公開と、利用可能な現行またはレガシーのファサードでの検索が失敗した場合に限り、依存関係が見つからないと報告します。どちらのファサードエントリポイントも検出できない場合は、コネクターの検出失敗を報告し、同等であるかのように無関係なデータソースへ切り替えないでください。
• 単独の KOLSprite MCP が互換性を保つのは、必要な意味上のツール名、入力スキーマ、応答形式が同じ場合に限られます。
• 両方の接続が有効な場合は、検索全体で一方の接続のみを使用し、Yunya を優先して、有料の呼び出しを両サービスで重複させないでください。
• 必要なツールがない場合、またはスキーマに互換性がない場合は、その依存関係の不足を報告し、代替を推測するのではなく検索を絞るか停止します。

ツールのルーティング

• クリエイターカテゴリー値の解決：ユーザーがクリエイターコンテンツのカテゴリーを指定し、現在の実行中に検証済みの使用可能な値がない場合は、creator_search の前に creator_category_list を呼び出します。
• 商品カテゴリー ID の解決：カテゴリーで絞り込むクリエイター、商品、動画、またはショップの検索で、現在の実行中に検証済みの使用可能な ID がない場合は、検索の前に product_category_list を呼び出します。
• クリエイターの特定、オーディエンス規模、エンゲージメント、コンテンツカテゴリー、販売活動、連絡可能性、またはクリエイター候補の絞り込み：creator_search を呼び出します。
• 商品の特定、価格、評価、レビュー、掲載日、販売数、成長率、クリエイター数、または動画数：product_search を呼び出します。
• 購入可能な動画の特定、クリエイター、商品、再生数、エンゲージメント、販売数、投稿時期、または再生時間：video_search を呼び出します。
• ショップの特定、種類、カテゴリー、評価、商品、販売数、クリエイター、または動画：shop_search を呼び出します。

ユーザーの直接的な検索でレコードを結合する必要がある場合に限り、複数のツールを使用します。後続のツールが返された ID を受け付ける場合は、その ID を再利用します。例として、shop_search の後に shop_id を指定して product_search を呼び出す方法や、product_search の後に product_id を指定して video_search を呼び出す方法があります。

creator_search が特定の商品を宣伝した正確なクリエイターを特定できると主張しないでください。現在、公開されているクリエイターツールが対応しているのは、カテゴリーおよびパフォーマンスによる絞り込みであり、商品 ID に基づく関連付け検索ではありません。

カテゴリーの解決

• カテゴリー一覧ツールはパラメーターの解決手段として扱い、ユーザー向けの検索結果や必須の事前呼び出しとは見なしません。カテゴリーで絞り込む必要がない場合、または現在の実行ですでに有効な値が返されている場合は、呼び出しを省略します。
• ユーザーが指定した中国語または英語のクリエイターカテゴリーを creator_category_list と照合し、返された value を creator_search.category_list に渡します。
• 再帰的な product_category_list ツリーをたどり、categoryCn または categoryEn と照合します。該当する場合は、返された完全な category 値を product_search.cat_ids、shop_search.category、video_search.product_category_list、または creator_search.product_category_list に渡します。
• コンテンツのニッチ分野やアカウントの位置付けはクリエイターカテゴリーとして解釈し、販売、プロモーション対象商品、コラボレーションの方向性は商品カテゴリーとして解釈します。「美容クリエイター」のような曖昧な表現に対し、念のため両方のカテゴリー絞り込みを設定してはいけません。リクエストの文脈を用い、重要な前提を明示するか、選択によって結果が大きく変わる場合に限り、一度だけ質問してください。
• 現在の検索スキーマは配列を受け付けますが、サポートしているカテゴリー値は1つだけです。ユーザーの意図を保てる、最も狭く曖昧さのない一致を選んでください。妥当な対応付けが2つあり、結果が大きく変わる場合は一度だけ質問してください。それ以外の場合は、より広い有効な親カテゴリーを使い、その旨を明示してください。
• 必須の値／IDの代わりに表示ラベルを渡したり、IDを捏造したり、Skillのテキストに最新のカタログを固定したりしてはいけません。現在の実行中は、一度成功した対応付けを再利用してください。解決ツールを利用できない場合や安全に一致させられる項目がない場合は、カテゴリー絞り込みを省略し、役立つ場合はキーワードで範囲を明確に限定したクエリを使い、制約を明示してください。
• 上記の意味的なツール名を使用してください。MCP ホストによって、呼び出し可能な名前にクライアント固有またはサーバー固有の名前空間が追加される場合があります。特定のエージェントのプレフィックスをハードコードしてはいけません。

クエリのルール

1. 市場、キーワード、カテゴリー、価格、フォロワー数、エンゲージメント、売上、成長率、日付、並べ替え、ページサイズなど、明示された絞り込み条件を推測します。
2. 選択によって回答が大きく変わらない場合は、任意の入力にツールのデフォルト値を使用します。重要な前提は明示してください。
3. 必須であり、かつ安全に推測できない情報だけを質問します。
4. 要求された結果件数に対して、必要最小限のページ取得計画を立てます。「すべて」を求められた場合は、サポートされている最大のページサイズを使用し、次のページがなくなる、要求された範囲を取得し終える、サービスの上限に達する、またはエラーで取得が停止するまで続けます。
5. ページ分割されたレコードは、安定したオブジェクト ID で重複を除去します。要求件数、ページ範囲、取得した生の行数、重複除去後の行数、停止理由を報告します。
6. ユーザーが指定した並べ替えを適用します。ライブスキーマでサーバー側の並べ替え値が確認できない場合は、取得した範囲内に限りローカルで並べ替え、その範囲を明示します。
7. 成長率をパーセントで絞り込む前に、ライブスキーマまたは検証済みの公式例を確認します。50%が 50 と 0.5 のどちらで表されるかを推測してはいけません。それでも確認できない場合は、その絞り込みを省略し、制約を説明します。
8. 最初のクエリで結果が得られなかった場合、ユーザーの意図に沿う範囲内で、重要でない絞り込みを1つ緩和するか、近い同義語を1つ試します。範囲を黙って変更せず、緩和したことを報告します。
9. 要求された検索または範囲を限定した比較に回答できた時点で停止します。意思決定を目的とする追加質問は tiktok-shop-growth-research に振り分けます。

ポイントに配慮した実行

• ポイントの消費は、現在のアカウントルールの下で実際に実行したツールに基づきます。このSkillを選択しただけでは、課金記録にはなりません。
• リクエストに回答できる最小限の呼び出し／ページ計画を使い、返されたレコードを再利用します。理由を明示せずに、同一の有料呼び出しを繰り返してはいけません。
• ポイントの料金をハードコードしたり推定したりしてはいけません。差し引きポイントまたは残高は、現在のMCP応答またはホストクライアントで確認できる場合に限って報告します。
• ポイント不足になった場合は停止し、完了したページ数／行数と残りの作業を明示します。ユーザーが要求した範囲を超えて、ポイント消費が大きく増える任意のツールやページを追加する前に、ユーザーに確認してください。

エラーと不完全な収集

• 認証失敗、ツールの利用不可、ポイント／利用資格の不足、レート制限エラー、またはサーバー障害の繰り返しが発生した場合、影響を受けるチェーンを停止します。
• ポイント、利用資格、レート制限、認証に関するエラーが発生した場合、認証情報の変更、制限の回避、または中断を隠すためのリクエストの縮小によって再試行してはいけません。
• 収集が中断された場合は不完全と明記し、完了したページ数／行数、残っている依頼内容、およびどの結論が収集済みサンプルにのみ当てはまるかを示します。
• 1ページ目や、レート制限によって中断された収集を「すべての結果」と呼んではいけません。
• 現在のサーバーエラー、スキーマの不一致、空のカテゴリ結果、または安定IDが不自然に繰り返されるページが発生した場合は、日付付きの既知の問題の記録を確認します。これは再テストのガイドとして扱い、過去の問題が現在も発生している証拠とはみなしません。

エビデンスと回答のルール

• TikTok に関する事実は、現在の MCP 出力のみに基づいてください。不足しているレコードや指標を捏造してはいけません。
• 解釈に影響する場合は、ソース、市場、フィルター、並べ替え、期間の基準、ページ、および返されたサンプルサイズを明記します。
• フィールドが実際に示す期間を維持します。合計売上や期間が指定されていない売上を、7日間または30日間の売上と表記してはいけません。
• MCP のフィールドとクライアント側の計算を区別します。計算した率、順位、集中度には、計算式または平易な言葉で計算方法を示します。
• キーワードの一致は、商品／カテゴリとの関連性を確認するまで候補として扱います。
• 結果が空の場合は、「この条件ではレコードが返されなかった」とし、そのオブジェクトや市場が存在しない証拠とはみなしません。
• 役立つ場合は、返されたオブジェクトのリンクを使用します。TikTok や KOLSprite の URL を捏造してはいけません。
• まず結果または候補リストを示します。ユーザーの判断に影響しない限り、補足的な指標は含めません。
• 分析依頼では、優先順位を付けたアクション、その根拠となるエビデンス、観察する指標、見直しまたは中止の条件を最後に示します。ユーザーが求めていない単純な検索結果には、アクションプランを付け加えてはいけません。
• 再利用可能な分析の実行やパートナー向けの例では、共通の実行エビデンスの表示方法を適用し、クエリの実行を顧客成果の測定値として説明してはいけません。