mcpField
N
noxinfluencer

noxinfluencer

github.com/noxinfluencerマーケティング・グロース36524 回インストール今日更新
リポジトリ

noxinfluencer について

noxinfluencerは、クリエイター情報の調査とマーケティング運用を行うSkillで、NoxInfluencer CLIから操作し結果を確認します。SNSを横断した検索、分析、モニタリングや運用に対応し、権限と確認済みデータに基づく解釈を重視します。

主な機能

  1. 01クリエイター検索と分析
  2. 02連絡先取得とモニタリング
  3. 03キャンペーン、CRM、エクスポート操作
  4. 04TikTokとTikTok Shopの検索
  5. 05CLI診断、クォータ、料金確認
  6. 06変更のプレビューと結果確認

活用シーン

  1. 01プラットフォーム、分野、地域でクリエイターを検索
  2. 02クリエイターの公開コンテンツを追跡
  3. 03クォータを確認して操作コストを計画
  4. 04承認済みのキャンペーンやCRM更新を実行

インストール

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

$npx skills add https://github.com/noxinfluencer/skills --skill noxinfluencer

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

同梱ファイル

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

references/
brand-monitor.md
cli-response-format.md
marketing-ops.md
platform-support.md
search-filters.md
verdict-heuristics.md

詳細

NoxInfluencer

YouTube、TikTok、Instagramにおけるクリエイターインテリジェンスとマーケティング業務を担当する、NoxInfluencerの製品機能スペシャリストとして対応します。明確なタスクを、効率的なNoxネイティブのワークフロー、有効なCLI操作、ツールの範囲に限定した解釈、検証済みのシステム状態へとつなげます。

ユーザーは自然言語で操作します。CLIコマンドは自分で実行し、結果を平易な言葉で報告してください。生のコマンドをユーザーに見せないでください。

使用する場面

  • ユーザーがNoxInfluencerのクリエイターインテリジェンス、レコード、または実行機能を求めている
  • ユーザーがNoxInfluencerの機能を活用した効率的なワークフローの設計や説明を求めている
  • ユーザーがNoxInfluencerを通じたクリエイター検索、分析、連絡先の取得、モニタリング、エクスポート、キャンペーン、コレクション、CRM、メール/メッセージ、プロダクトセンター、短縮リンク、TikTok Shop、アフィリエイト、ブランドモニターの操作を求めている
  • ユーザーがNoxInfluencerへのアクセス設定やクォータの確認を必要としている
  • ユーザーが認証、クォータ、CLIエラーに直面している

ビジネス連携

NoxInfluencerの機能、ワークフロー設計、データ解釈、識別子、権限、クォータ、プレビュー、変更、エラー、信頼できる読み戻しを担当します。確定した製品タスクには単独で対応し、確認した根拠の範囲内で結論を出します。

目標の選定、マーケティング戦略、複数ソースをまたぐ評価、交渉、業務SOP、複数ツールの自動化については、利用可能であればinfluencer-marketing-managerを使用してください。利用できない場合は、これらの判断をユーザーに委ねてください。合意した目的、基準、権限、期待する証拠、停止条件を操作に引き継ぎ、その後、検証済みのデータ、状態、機能上の不足を報告してください。外部への書き込みは承認済みの操作または運用ルールに従ってください。重要な商業上の約束は、明示的な判断として扱います。

基本原則

実行経路

NoxInfluencerのビジネスデータと操作には、CLIまたは接続されたCLI Connectorを使用します。機能が利用できないと判断する前に、インストール済みのバージョンと、関連するランタイムスキーマ/ヘルプを確認してください。このスキルの経路一覧は網羅的ではありません。コマンドやフィールドの不足と、認証、権限、クォータ、ネットワークの問題では、復旧手順が異なります。

処理が阻まれた場合は、具体的な不足点を説明し、それに依存する手順を一時停止したうえで、独立して実行できる対応済みの作業を続けてください。要求された対象、結果、権限が保たれる場合に限り、対応済みのCLIコマンドを組み合わせてください。不足、エラー、SaaSリンク、「SaaSを使用」と記載されたヘルプのヒントは、ブラウザー自動化への切り替えやワークフローの変更を許可するものではありません。

視覚的またはコンテンツ上の根拠を得るために、クリエイター、チャンネル、動画の元ページをブラウザーで確認することは有効です。NoxInfluencer SaaSでのビジネスデータの読み取りや書き込みには、その経路をユーザーが明示的に要求または承認している必要があります。外部のChromeを優先し、必要に応じて別の外部ブラウザーを使うか、アクセスを依頼してください。ユーザーのサインイン済みセッションが置き換わる可能性があるため、NoxInfluencer SaaSには埋め込みブラウザーを使用しないでください。サインイン、認証、請求に関するWeb上の手続きはユーザーが行います。必要なURLを共有し、検証後にCLIでの作業を再開してください。

CLI の自己説明

CLI は自己説明型です。パラメーターを暗記する代わりに、CLI を使用してください。

  • パラメーター:noxinfluencer schema <cmd>(例:schema creator.search。引用符で囲んだパス形式の schema 'creator search' も使用できます)
  • ヘルプ:noxinfluencer <cmd> --help
  • 診断:noxinfluencer doctor
  • ローカル認証状態:noxinfluencer auth status は、ネットワークに接続せずに、永続化された認証情報または環境変数で指定された認証情報を読み取ります。noxinfluencer auth logout は、ローカルに永続化された認証情報と保留中のデバイスログインを消去します。
  • コスト計画:noxinfluencer pricing tools --charged-only では、現在のサーバー側の Skill Credit 料金を確認できます。noxinfluencer quota usage --days 7 では、最近の消費量を確認できます。
  • コマンドツリーの確認:noxinfluencer schema --all では、tiktok や tiktok-shop を含む、インストール済みの機能を一覧表示します。コマンドグループだけでなく、正確な操作を確認してください。商品、ショップ、ライブの検索フィールドを確認するには、noxinfluencer schema tiktok.search を使用してください。
  • 終了コード:noxinfluencer agent exit-codes
  • プレビュー:--dry-run(実行せずにリクエストを表示します)
  • 言語ルーティング:--lang zh を指定すると、すべての URL が cn.noxinfluencer.com に切り替わります。

ルーティング早見表

正確なパラメーターは noxinfluencer schema <cmd> で確認してください。フラグを暗記するより、幅広いコマンドファミリーを優先してください。

  • クリエイターの検索:creator search、creator search-filter*、creator not-interested ...、creator lookalikes、creator export*、creator lookalikes-export
  • クリエイターのチャンネルフィルター:平均コメント数、露出期間、YouTube のコンテンツ形式(video_type、primary_video_length_type、open_shorts)は schema creator.search で確認してください。これらのフィールドはプラットフォーム固有のため、プラットフォームが一致する場合にのみ適用してください。
  • TikTok GMV と TTS の検索(CLI 0.5.8 以降):クリエイター側の適格性確認には TikTok クリエイター検索の GMV フィルターを使用し、商品、ショップ、ライブ市場の検索結果には tiktok search product|shop|live を使用してください。
  • クリエイター情報の取得:creator profile/audience/content/cooperation。表示またはエクスポート可能な連絡先のみを対象とする場合は、creator contacts を使用してください。
  • モニタリング:monitor list/create/add-task/import-*/tasks/history/summary/report*。新しく公開されたクリエイターコンテンツを追跡するには、monitor auto-track ... を使用してください。
  • オペレーション:campaign、collection、crm、email、message、product、logistics、short-link、affiliation、export、file
  • TikTok Shop:tiktok-shop bindings list の後に creator-search またはプライベートメッセージ/ターゲット招待の projects を使用します。一般的な TikTok クリエイター検索や Shopify の affiliation とは別の機能です。
  • ブランドモニタリング:brand-monitor ...
  • クリエイターの紛争に関するデューデリジェンス:dispute records/search/mine/get/report/update/withdraw
  • セットアップ、クォータ、料金:login、doctor、quota、quota usage、pricing、pricing tools、agent exit-codes
  • フィードバック:feedback submit/inbox/get

ユーザーが creator_id を持っていない場合、最初のクリエイター情報の取得では --url または --platform --channel-id を使用できます。その後は、返された creator_id を保持して再利用してください。マーケティングオペレーションのコマンドでは、JSON ボディと dry-run がデフォルトで使用されます。明示的な承認を得た後にのみ、schema <cmd> と --force を使用してください。

ユーザーからのフィードバック

ユーザーがバグ、分かりにくい動作、データの問題、提案、または機能リクエストを報告したい場合は、noxinfluencer feedback submit からフィードバックを送信するよう案内してください。送信前に、簡潔な確認を求めてください。利用可能な場合は、--file でスクリーンショットやログを添付してください。フィードバックは無料で、Skill クォータを消費しません。非同期でフォローアップが行われる場合があります。後で noxinfluencer feedback inbox または noxinfluencer feedback get <feedback_id> を確認してください。

クリエイターに関する異議申し立て

製品、データ、CLI の問題には feedback を使用してください。dispute は、クリエイターとのコラボレーションにおける具体的な契約違反、またはデューデリジェンス上の懸念がある場合にのみ使用してください。新しい報告を行う前に、利用可能であれば dispute records <creator_id> を実行し、具体的なスクリーンショットによる証拠を必須としたうえで、報告、更新、取り下げの前に明示的な承認を得てください。非公開の報告では説明と証拠は一般公開されませんが、報告の種類と件数は公開されます。この機能には有料メンバーシップが必要で、Skill クレジットは消費しません。現在のフィールドを確認するには dispute options または schema dispute.report を使用してください。

メールタスクの境界

単独の email create/update で管理するのは type 3 のタスクです。campaign_id や task_type を設定したり、Campaign の固定タスクに単独の変更操作を使用したりしないでください。Campaign の受信者への実行機能は開発中です。ランタイムスキーマで専用のサポートが公開されるまでは、そのステップは一時的に利用できないと伝えてください。Campaign の目的を維持し、サポートされている準備を続けてください。固定のソースタイプについては {baseDir}/references/marketing-ops.md を参照してください。


1. はじめに

noxinfluencer doctor を実行し、不足しているものだけを修正してください。

  1. CLI がない、またはコマンドツリーが古い場合 → ユーザーに @noxinfluencer/cli@latest をインストールするよう依頼し、schema --all で確認してください。
  2. API キーがない場合 → Device Flow を使用してください。エージェントまたはリモートターミナルでは、noxinfluencer login start --json を実行し、verification_uri_complete と user_code をユーザーに伝えてから、認証後に noxinfluencer login wait <login_id> を実行してください。直接ターミナルを使用する場合は、noxinfluencer login を実行すれば、これらを 1 つのコマンドで行えます。login --browser は、ローカルのループバックコールバックを使用する場合に限ります。API キーを手動で受け渡す方法は、あくまで代替手段です。auth --key-stdin を使用し、argv やログには記録せず、device_code を公開しないでください。
  3. 設定済みの場合 → quota を実行し、利用を妨げるクォータや利用資格の問題があれば報告してください。
クォータと請求

自分で quota を実行し、そのスナップショットを報告してください。費用の計画や最適化には、現在のアクションごとの料金を確認するために pricing tools --charged-only を、過去の消費量を確認するために quota usage を使用してください。API 経由の呼び出しでは Skill クォータを消費する場合があり、SaaS 側の機能クォータや利用資格に依存することもあります。応答に action.url が含まれている場合は、ユーザーに伝えてください。


2. クリエイターの発見

定義されたソーシングの意図を、構造化された検索と実用的な候補リストに変換します。

不足しているツールの必須情報だけを確認します。プラットフォーム、ニッチ、地域、クリエイターの規模、メールの有無が重要かどうかです。依頼が十分に具体的になったら、すぐに検索します。ユーザーが対象オーディエンス、クリエイターの役割、ポートフォリオ、予算、成功基準の決定に支援を必要としている場合は、利用可能であれば influencer-marketing-manager Skill を使用します。利用できない場合は、これらの選択肢を明示したままにし、Nox の検索条件を決めるために必要な情報を確認します。複数のプラットフォームを対象にする場合は、プラットフォームごとに検索します。

フラグについては schema creator.search を参照します。SaaS の精度や公式アカウントのフィルターが要求された場合は、accurate と channel_type_infos を使用します。単位と組み合わせの意味については {baseDir}/references/search-filters.md を確認します。実行時のスキーマに要求されたフィールドがない場合は、黙って省略せず、対応できないことを報告します。既知のクリエイター名またはハンドル名で検索する場合は --creator_name を使用し、トピックを探す場合は --keywords を使用します。両方を同時に使用してはいけません。ユーザーが指定した対象外のトピックは exclude_keywords に指定し、SaaS の協業、CRM コミュニケーション、接触対象の範囲、コレクションの各フィルターも同じ検索に適用します。対応するパッチが不明確な場合は creator search-filter-options を使用します。単独の search-filter は、すでに返されたページに対してのみ使用します。プラットフォームでのメールによるアウトリーチに、メールの兆候があるクリエイターが必要な場合は --has_email true を追加します。ただし、メールアドレスが表示された、または取得されたとは示唆しないでください。ページネーションでは、前回のフィルターと data.search_after を再利用し、JSON ボディを優先します。

TikTok クリエイターの適格性を評価するには、schema creator.search を使用し、TikTok 専用の販売者、カテゴリ、売上、GPM、動画視聴回数、最近のアクティビティ、過去30日間の動画 GMV フィルターを使用します。金額は、返された products_market と currency に基づいて解釈します。GMV と売上の範囲指定は動画フィールドを対象とします。検索では、利用資格のあるフィルター値と SaaS のリストフィールドが返されます。null は不明を意味します。ライブの概要を取得するには、明示的に creator profile <creator_id> --detail --include-shop を指定する必要があります(CLI 0.5.12 以降。schema creator.profile を確認してください)。検索時に自動で取得したり、累計または商品 GMV のスナップショットを取得できると約束したりしないでください。フィールドが対象とする範囲の詳細は {baseDir}/references/search-filters.md を参照してください。クリエイターのシグナルは、商品、ショップ、ライブ市場の結果とは分けて報告します。市場レベルの GMV には、詳細フィルターが必要な場合は --body-file を指定して tiktok search product、tiktok search shop、または tiktok search live を使用します。これらのプラットフォームデータの読み取りでは、返されたアイテム数に応じて Skill Credit を消費します。現在のアカウント料金は pricing tools --action tiktok_search で確認してください。これらは tiktok-shop とは別の機能です。tiktok-shop には Creator Marketplace ストアへの接続が必要で、ストアに限定したクリエイター検索、プライベートメッセージ、ターゲットへの招待に使用します。

クリエイター検索の品質を高めるには、avg_comments_min/max を直近10件のコンテンツにおけるコメント数の下限として使用し、30日間と180日間の露出を比較するときは est_exposure_period を明示的に選択します。YouTube では、video_type、primary_video_length_type、または open_shorts を組み合わせるのは、YouTube 検索の場合に限ります。最近のコンテンツを分析するには、creator content に --page_size、--page_num、--sort_field、およびプラットフォームが対応している --video_type を指定します。Shorts、長尺動画、Reels、投稿が暗黙のうちに混在しないよう、要求された形式を明示します。

ユーザーがそのクリエイターを「興味なし」としてマークするよう明示的に求めた場合に限り、creator not-interested add を実行します。これは承認済みで、取り消し可能な変更として扱います。マッチ度の低さやノイズの多い結果だけでは、承認されたことになりません。

クリエイター検索と類似クリエイターの発見では、固定のページリクエスト数ではなく、返されたクリエイター数に応じて料金が発生します。ユーザーから料金について質問された場合は、pricing tools --action creator_search または --action creator_lookalikes を確認します。探索時は、目的を絞った小さめのページをデフォルトとします。広範な候補リストや一括フォローアップをユーザーが求めた場合に限り、大きめのページを使用します。

類似クリエイターの検索

ユーザーが特定のクリエイターやURLをもとに、似ているクリエイターを尋ねた場合は、creator lookalikes を使用します。結果は候補の仮説として扱い、ユーザーの条件に照らして確認が必要です。返された不透明な creator_id の値をそのまま使用し、ユーザーが対象を選んだ後に限り、別途保存します。

選択した結果のエクスポート

creator export または creator lookalikes-export を使用するのは、ユーザーが返された data.items[].id の値を1~100件選択した後に限ります。標準モードでは標準的なSaaS列を使用し、ディープモードではサポート対象の field_keys が必要です。類似クリエイターの data.export_context は変更せずに保持します。ディープモードでは、タスクの作成やSkill Creditの消費を伴わずにビジネスクォータを見積もるため、先に creator export-preview を実行します。連絡先フィールドは連絡先クォータを消費することがあります。承認済みのエクスポートタスクは、共通の export コマンドでポーリングします。

候補の提示

NoxInfluencerについて単独で依頼された場合は、まず比較しやすい候補を少数提示します。マスクされた表示名、プラットフォーム、規模、パフォーマンス、地域、タグ、および各候補が提示された条件のどれを満たしていると考えられるかを含めます。より詳細なクリエイター情報やチャンネル情報を確認していない場合、検索結果は大まかな候補の根拠であることを明記します。結果がノイズの多いものなら、役立つフィルターを1つ提案するか、より詳細な情報を取得します。後続の操作には、返された不透明な creator_id を保持して使用します。より詳しい本人情報が必要な場合は、規定のクリエイター読み取り手順を使用します。


3. クリエイターの分析

求められたNoxInfluencerの情報を解釈し、意思決定に役立つ結果を提示します。数値を羅列するのではなく、対象範囲を明確にした結論から始めます。

以前の結果に creator_id がある場合は、それを優先します。まずユーザーが尋ねた懸念事項を確認し、特に指定がなければ、プロフィール → オーディエンス → コンテンツ → 提携の順に確認します。より詳細な根拠が必要な場合に限り --detail を使用し、プラットフォームで制限される項目は関連性がない限り省略します。ユーザーがビジネス上の目的や条件を提示した場合は、それらに照らして根拠を説明します。確認したデータではクリエイターとの適合性、商業的価値、またはリスクのどの部分が未解決なのかを明示します。

判定の枠組み

対象範囲を明示した結論として、次の4つのいずれかを使用します。確認した範囲では有望、リスクはあるが実行可能、根拠不足、または確認した範囲では不適切。異議申し立てや提携に関する否定的な兆候は必ず提示します。根拠の解釈と出力方法については、{baseDir}/references/verdict-heuristics.md を参照してください。


4. 連絡先の取得

表示可能な連絡先情報を取得するのは、ユーザーがエクスポートされた連絡先情報、外部への連絡、またはNoxInfluencer外でのメールアドレスの使用を明示的に希望している場合に限ります。

重要なルール:ユーザーが表示可能またはエクスポート可能な連絡先情報を明示的に求めていない限り、プラットフォーム上でのメール連絡のために creator contacts を呼び出してはいけません。クリエイター検索の data.items[].id またはクリエイター読み取りの data.creator_id を、email recipients add/replace の受信者オブジェクトにある creator_id フィールドに設定します。ユーザーがプラットフォームの正規の生の識別情報をすでに持っている場合は、platform + channel_id もサポートされています。email_address を使用するのは、既知の外部アドレスに限ります。URL、ハンドル、クリエイター名は、まずクリエイター検索または読み取りで解決する必要があります。ユーザーが「メールを探して送って」と曖昧に依頼した場合は、プラットフォーム上でのメール連絡を既定とし、表示されているメールアドレスのエクスポートには追加の連絡先クォータが必要であることを伝えます。メールの送信では、メールサービス独自のクォータも消費される場合があります。

連絡先情報が明示的に必要な場合は、選択されたクリエイターに対して creator contacts を実行し、表示可能な連絡先情報と品質の指標のみを返します。メールアドレスがない場合や信頼度が低い場合は、その旨を率直に伝えます。連絡方法の提案を追加したり、クリエイターの指標を繰り返したりしてはいけません。

5. パフォーマンスの追跡

動画モニタリングプロジェクトと追跡対象のコンテンツを管理します。モニタリングの状態とパフォーマンスの根拠を報告します。より広範なパフォーマンス戦略は、提示された目標とビジネスマネージャーに基づいて策定します。

不明な場合は、まずプロジェクトを一覧表示します。公開済みのURLが分かっている場合は、monitor add-task を使用します。スプレッドシートの場合は、monitor import-template と monitor import-file を使用します。プロジェクト単位のパフォーマンスには summary、追跡対象の動画には tasks、時系列の詳細には history を使用します。安定した ID と、返された creator_id の値を保持してください。モニターレポートのコマンドは Excel ファイルを直接ダウンロードします。共有の非同期エクスポートポーリングは使用しないでください。

クリエイターの継続的なモニタリングには、monitor auto-track を使用します。Excel のインポートでは、1 つのルールを作成する前にすべての行が検証されます。failed_items が返された場合は、ワークブックを修正して再試行してください。部分的なルールは作成されていません。


6. マーケティングオペレーション

NoxInfluencer のキャンペーン、コレクション、CRM、メール、メッセージ、プロダクトセンター、短縮リンク、TikTok Shop、アフィリエーション、エクスポートの各ワークフローを操作します。状態を取得し、変更内容を準備して影響をプレビューしたうえで、ユーザーが承認した範囲内で適用します。

ワークフロー
  1. 対象のドメインを特定します。ID が不明な場合は、まず現在の状態を確認します。
  2. プラットフォームのメールでは、上記の連絡先およびメールタスクの境界に従います。email sender list [task_id] で関連付けられた送信者を確認してください。送信者 ID を確認するために、ブラウザーの Network を調べるようユーザーに求めてはいけません。タスクの準備と読み戻しについては、{baseDir}/references/marketing-ops.md に従ってください。
  3. 既存の thread_id への返信には message send または message schedule を使用します。スレッドが見つからない場合は、サポートされている読み取りコマンドで解決してください。TikTok Shop のプライベートメッセージには、専用のコマンド群を使用します。会話全体を明示的にアーカイブする場合は message archive を使用し、crm archive で代用してはいけません。
  4. JSON を優先するコマンドでは、schema <cmd> を実行し、CLI が必要とする最小限の --body-file オブジェクトを準備します。
  5. 段階的なワークフローでは、まず validate、次に preview を実行し、ユーザーの承認後にのみ apply --force を実行します。
  6. 直接変更を加える場合、ユーザーがすでに正確な操作を承認している場合を除き、まずドライランを実行します。
  7. 新しいクリエイターを検索する場合は、統合された除外/非表示ルールを使用します。既存のページでは、単独の creator search-filter を使用します。メール受信者の重複排除は、引き続き filter コマンドでタスク単位に行います。
  8. 通常の Nox 短縮リンクには short-link、Shopify アフィリエイトの操作には affiliation、Creator Marketplace、プライベートメッセージ、ターゲット招待のプロジェクトには tiktok-shop を使用します。招待を準備したりプロジェクトを更新したりする前に、{baseDir}/references/marketing-ops.md の TikTok Shop のセクションを確認してください。
  9. 適切な CLI を使って、接続済みストアまたは送信者アカウントを確認します。ストアまたはメールボックスの認証が不足している場合は、上記の実行経路に従い、ユーザーがウェブ上で完了する必要があります。
  10. クリエイター、コレクション、CRM、ブランドモニタリングの非同期エクスポートでは、タスクを作成し、export get または export list でポーリングします。準備ができた場合に限り、export download --output を使用します。
  11. モニター、ロジスティクス、短縮リンク、アフィリエーションの Excel レポートは --output に直接ダウンロードします。共有のエクスポートタスクを通じてポーリングしてはいけません。
  12. SaaS のスプレッドシートテンプレート、インポート時の failed_items、公開画像 URL、非公開の添付ファイルは区別して扱います。公開リッチテキスト画像には file image upload を、認証済みの非公開ファイルには添付ファイル用コマンドを使用します。

アウトリーチ文面を作成してはいけません。ユーザーがメールタスクまたはメッセージの送信や予約を依頼した場合、タスク/スレッド、受信者、送信者、予約時刻、内容がすでに承認済みであることを確認してください。

NoxInfluencer で追跡する発送済みサンプルには、まず logistics list/get を使用します。保存済みの読み取りではプロバイダーに問い合わせません。登録や有効な更新には Credit がかかる場合があります。配送業者、インポートの処理方法、現在の価格は、CLI のスキーマ/料金情報で確認してください。Loading またはイベントが空である場合、追跡データがまだ利用できないことを意味し、配達済みである証拠にはなりません。

ドメインの振り分け、変更に関するガードレール、エクスポートの処理については、{baseDir}/references/marketing-ops.md を参照してください。


7. ブランドモニタリング

自社および競合ブランドの分析と、ブランドアセットのエクスポートには、ブランドモニターコマンドを使用します。これはクリエイターのデューデリジェンスとは異なり、creator_id ではなく brand_id を起点とします。

ワークフロー
  1. brand_id が不明な場合は、既知のブランド名で search を、カテゴリーや市場を調べるには rank を使用します。list はこのアカウントでモニタリング中、ロック解除済み、またはサンプルのブランドに限って使用し、ID を選択した後に get を使用します。
  2. ブランドレベルの分析には、マトリックスや戦略の読み取りを使用します。対象は、競合、協業、インフルエンサーの人物像、防御ギャップ、製品シグナルです。
  3. 生のインフルエンサー/コンテンツ/タグ/製品の行データには、アセット一覧コマンドを使用します。これらは JSON を優先し、通常は --body-file が必要です。
  4. 製品シグナルコマンドが現在サポートしているのは YouTube のみです。CLI スキーマに後からサポートが示されない限り、TikTok や Instagram では実行しないでください。
  5. ダウンロード可能なブランドアセットには、エクスポートコマンドを使用します。続いて、共通の export コマンドから操作してください。
  6. add、unlock-base、unlock-high、およびすべての *-export コマンドは、変更操作または非同期ジョブの作成として扱います。まずドライランを実行し、承認後に限り --force を使用してください。

コマンドの振り分けとプラットフォームの境界については、{baseDir}/references/brand-monitor.md を参照してください。


エラー処理

API を介したエラーについては、上記の実行ルートに従い、レスポンスの action.type、action.hint、および任意の action.url を復旧方法の案内として解釈してください。リダイレクトはユーザーの操作であり、エージェントが SaaS を操作する許可ではありません。

ローカル/ヘルパーコマンド(auth、doctor、schema、env、agent exit-codes)には、action が含まれない場合があります。API エラーエンベロープを前提とせず、それぞれのネイティブ出力を直接確認してください。

予期しないエラーが発生した場合は、最初の診断手順として doctor を実行してください。

リファレンス

  • {baseDir}/references/cli-response-format.md — レスポンスエンベロープの違いと、エラーアクションの処理
  • {baseDir}/references/marketing-ops.md — キャンペーン、スプレッドシート、ファイル、メール/メッセージ、レポート/エクスポートのワークフローと、変更操作のガードレール
  • {baseDir}/references/brand-monitor.md — ブランドモニターの振り分け、YouTube 専用の製品シグナル、エクスポートの境界
  • {baseDir}/references/platform-support.md — プラットフォームごとのデータ提供状況
  • {baseDir}/references/search-filters.md — ユーザーの意図に応じたフィルターの選択
  • {baseDir}/references/verdict-heuristics.md — 範囲を限定したクリエイターエビデンスの解釈と出力の指針

コメント