instagram-tools

Instagram ツール

使用する場合

• Instagram の収集、正規化、抽出、ランキングのガイダンス向けのサポートスキルです。

使用しない場合

• そのタスクがアイデア出し、QA、または引き継ぎセクションに記載されている別のリリース済みスキルに属する場合。
• 必要な入力が欠けており、推測すると結果が変わってしまう場合。

必須入力

• ワークフローに応じて、ホスト型エンベロープまたはローカルの正規化済み Instagram データセット。

サポート方法論

このサポートは、収集された Instagram データセットに対してコンテキスト内で実行されます。 インストールされたスクリプトはありません。すべてのステップをプロバイダー非依存に保ってください。

• 正規化: 各収集アクターの生フィールドを、比較可能な 1 つの形 — username、followers、likes、comments、caption、hashtags、 publishedAt — にマッピングします。エンゲージメント値が欠落している場合や 負の値の場合は 0 として扱い、ランキングが単調性を保つようにします。
• ランキング: アカウントとクリエイターを、持続的で転用可能なシグナル — エンゲージメント率、直近の投稿頻度、認証ステータス、アウトリーチを可能にする 連絡先シグナル(email、website) — でスコアリングします。目標が個人クリエイターの 発見である場合は、ブランドアカウントや製品アカウントの重みを下げ、個人クリエイターが 先に現れるようにします。単一のハードコードされたカットオフではなく、完全な調査プールと 候補リストの両方を返します。
• コメントのクラスタリング: バケット化する前に、非常に短いコメントや純粋な反応 (lol、omg、wow) など、シグナルの弱いノイズを除外します。残りを再利用可能な オーディエンス言語のバケット — 称賛、反論、質問、購買意図、機能リクエスト — に グループ化します。
• ウォッチリスト: 繰り返しの収集実行のために、ユーザー名、ハッシュタグ、または タグ付きメンションをキーとする監視セットを維持します。

どの兄弟スキルがどのサポートを利用するか:

• instagram-account-research、instagram-audience-voice、および instagram-campaign-scout は収集と正規化のサポートを利用します。
• instagram-content-benchmark は投稿のランキングとベンチマークのサポートを利用します。
• instagram-creator-discovery はクリエイターの抽出とランキングのサポートを利用します。

停止条件

• 必要なユーザー意図、ソース証拠、または所有する入力成果物が欠けており、推測すると 結果が変わってしまう場合は停止します。
• 所有する CLI またはスクリプトコマンドが失敗した場合は、正確なエラーを報告して停止します。 メタデータのみの回答、レディネスプロービング、ローカルペイロードの書き換え、 フォールバックプロバイダー、または未公開ツールで失敗を回避しないでください。

引き継ぎ

• 構造化された出力を呼び出し元の Instagram スキルに返します。

収集実行

リリース済みの正確な収集キーとリクエスト形状を postplus research schema --json で確認します。コンパイル済みの収集入力を リクエストファイルに書き込み、次を実行します: postplus research collect <collectionKey> --request <input.json>。

postplus research collect instagram-comments --request request.json --output result.json

公開コマンド境界

• ユーザー入力から一致する最小のコマンドまたはワークフローを選択し、直接実行します。
• レディネス診断: postplus doctor --skill instagram-tools。
• 所有する CLI またはスクリプトコマンドが失敗した場合は、正確なエラーを報告して停止します。 メタデータのみの回答、レディネスプロービング、ローカルペイロードの書き換え、 フォールバックプロバイダー、または未公開ツールで失敗を回避しないでください。
• 不明なリクエスト形状を構築または修復する場合にのみ、 postplus research schema --collection-key <collectionKey> --json を使用します。
• ホスト型収集: postplus research collect <collectionKey> --request <input.json> --output <result.json>(input = 収集パラメーター)。
• 保留中の収集を再開する: postplus research collect --run-handle <runHandle> --output <result.json>。
• 最初のパスは範囲を限定して行い、最初の結果を確認してから拡張します。
• CLI が引用確認チャレンジを返した場合は、postplus quote confirm --json --challenge-file <challenge.json> を実行し、返されたトークンで再試行します。