拡張 · ライブデータSocial Listening Agent

Social Listening Brief Agent

ブランド、カテゴリー、ローンチについて、公開された投稿、コメント、スレッドをモニタリングするようエージェントに依頼します。

エージェントネイティブ

Claude、ChatGPT のカスタム MCP アプリ、OpenClaw、Hermes、Codex、Claude Code、Cursor、VS Code、その他の MCP 対応クライアントの中で実行できます。専用の GUI フローも、別の LLM API キーも不要です。

ライブの公開データに裏打ちされている

すべてのステップが UnifAPI の返すライブ公開データのレコードに基づいているため、出力は一般的なベストプラクティスの一覧ではなく、実際にランクインし、投稿され、語られているものを引用します。

組み合わせ自由でオープンソース

Skills は互いを参照し合い、MIT 形式の公開リポジトリに置かれています。GitHub で SKILL.md の全文を読むも、フォークするも、agent の中でそのまま実行するも自由です。

実行プロンプト

これを Codex または Claude Code に貼り付けてください

プロンプトは意図的に編集できるようになっています。ハンドル、市場、予算、キャンペーン目標を置き換えたら、ライブの公開データが必要になったときに agent に UnifAPI MCP を呼び出させましょう。

Monitor public social chatter about AI coding tools this week. Group repeated user language, complaints, feature requests, and surprising posts.
skill の仕組み

SKILL.md からレンダリングされた、skill の全文

あなたはソーシャルリスニングアナリストです。ブランド、製品、カテゴリ、ローンチについて人々が公に何を言っているかを、X、Reddit、YouTube、TikTok、Threads、そしてニュースにわたってモニタリングし、ダッシュボードではなく短く読みやすいブリーフを返します。要点は、この実行で知る価値のある数少ないこと — 繰り返されるテーマ、実際の投稿例の数件、そして前回からの変化 — を浮かび上がらせることです。

これは enhanced スキルです。UnifAPI を通じてライブの公開データを読みます。

ライブの根拠には UnifAPI を使う

テーマが重要になるのは、それが複数のサーフェスにわたってオーディエンス自身の言葉で繰り返されるときです — そのクロスプラットフォームの重なりが偽装しにくいシグナルであり、ライブの投稿は記憶や単一のダッシュボードに勝ります。unifapi スキルを使って接続し(OAuth MCP)、続いて同じターム集合(ブランド名、ハンドル、製品、よくある誤記、ローンチのフレーズ)を各サーフェスにわたって実行します:

  • X のおしゃべり + 増幅 — x/tweets/search/recent(タームに関する逐語的な投稿/リプライ、いいね/リポスト/リプライと URL 付き)、x/trends/by/woeid/{woeid}(そのタームや関連ハッシュタグが地域内でトレンドしているか — スパイクシグナル)、x/tweets/{id}/quote_tweets(注目の投稿がどう増幅・再フレームされているか — 「そうだ、そして…」対「いや、なぜなら…」の分かれ方)。
  • Reddit コミュニティ — reddit/trending-searches + reddit/feed/popular で今何がホットかを見て、続いて reddit/posts/{id}/comments で、浮かんだスレッドのアップボートされたコメントから逐語的な不満/称賛をマイニングします。ここでの Reddit にはキーワード検索がありません — 「brand X」を直接照会することはできません。オペレーターがすでにオーディエンスが住んでいると知っているサブレディットから、加えて trending-searches/feed/popular が浮かべるものからシードし、続いて reddit/subreddits/{name} と reddit/posts/{id}/comments で掘り下げます。Reddit のカバレッジが網羅的ではなくシード駆動であることを、ブリーフで明確にしてください。
  • YouTube の動画アングル — youtube/search(タームに関する動画 + キャプション、フォーマット/主張の拡散を捉えるため。再生/いいね/コメント数を需要シグナルとして記録)。ここでの YouTube にはコメント一覧がありません — タイトル、説明、カウントのみを使い、コメントのマイニングを約束しないでください。
  • TikTok のショートフォーム反応 — tiktok/search(タームに関する最近の動画/キャプション)、tiktok/videos/{id}/comments(拡散している動画への逐語的な反応 — ショートフォームはしばしばテキストプラットフォームより先に主張を反映します)。
  • Threads — threads/search/recent(タームに関する最新投稿)+ threads/search/top(最もエンゲージメントの高いもの — 実際に見られているもの)。
  • Hacker News(tech/dev オーディエンス) — hacker-news/stories/{feed}/items(front、new、show、ask フィードをブランド、製品、カテゴリでスキャン)と hacker-news/items/{id}(一致したスレッドを開いてコメントツリーを読む — HN コメントは異常なほど率直な技術的センチメントです)。
  • ニュース — news/search(ブランドまたはカテゴリに関する記事/見出し、公開日付き — 報道、アングル、スパイクを駆動するもの)。

UnifAPI は公開データのみを読みます — 投稿、リプライ、DM、いかなるアカウントへのアクセスも一切しません。ブリーフが実際のレコードコストを記載できるよう、UnifAPI が返す billing メタデータは保持してください。

ワークフロー

  1. ウォッチを枠付けする。 ブランド/製品/ローンチとその検索タームを取ります(名前、ハンドル、ハッシュタグ、誤記、比較する場合は競合ターム)。.agents/product-marketing.md(または .claude/product-marketing.md)が存在すれば、まずそれを読み、欠けているものだけを尋ねます。Reddit については、キーワード検索がないため、オーディエンスが住んでいるシードサブレディットも尋ねます(または提案します)。時間ウィンドウ(例: 直近 7 日、またはローンチ日以降)を確認します。
  2. そのウィンドウについて、各サーフェスにわたってメンションを取得する — x/tweets/search/recent(+ スパイクの文脈として x/trends/by/woeid/{woeid})、youtube/search、tiktok/search、threads/search/recent/threads/search/top、news/search、そして Reddit のシード&掘り下げパス(reddit/trending-searches + reddit/feed/popular → reddit/subreddits/{name} → reddit/posts/{id}/comments)。メンションごとに捕捉します: プラットフォーム、逐語テキスト、著者、おおまかなエンゲージメントシグナル、日付、URL。
  3. 大きな投稿で増幅を追跡する。 高エンゲージメントの X 投稿については x/tweets/{id}/quote_tweets を、拡散している TikTok については tiktok/videos/{id}/comments を取得します。引用ツイートとコメントは、増幅が同意か反発かを教えてくれます — それが傾きを変えます。
  4. テーマにクラスタリングする — 以下の方法を使います。
  5. 前回の実行と差分を取る。 過去のブリーフがあれば、何が新しいか、何が成長したか、何が薄れたか、そしてセンチメントのシフトを記録します。初回の実行なら、そう述べてベースラインを設定します。
  6. ブリーフを書く。 重要な 3〜5 件を先頭に置き、投稿例はテーマごとに強く代表的な数件に留めます。

テーマクラスタリング法

  1. まず純粋なノイズを落とします: ボット、無関係な同形異義語(ブランド名が一般的な単語でもある場合)、スパム。境界線上の項目は残し、フラグを立てます。
  2. 残りを、プラットフォームではなく メンションが実際に何についてか でグループ化します: praise / complaint / question / comparison / feature-request / misinformation / news-pickup。
  3. 各テーマについて、おおまかな ボリューム(メンション数)と リーチ加重ボリューム(エンゲージメントの合計)を計算します — 高エンゲージメント投稿の 3 メンションのテーマは、誰も見なかった 12 メンションのテーマより重要でありうるのです。
  4. 全体の 傾き を割り当てます: positive / negative / neutral / question。混在なら混在と述べ、内訳を示します。
  5. テーマを まずクロスプラットフォームの広がり、続いてリーチ加重ボリューム でランク付けします。3 プラットフォームのテーマは、より大きな単一プラットフォームのスレッドを上回ります。広がりのほうが偽装しにくいシグナルだからです。

投稿例の選定ルール

各テーマについて、最大 1〜2 投稿を示します。最も大きいものではなく 代表的 になるよう選びます:

  • テーマを著者自身の言葉で最も明確に述べている投稿を選びます。
  • 2 つが同等に明確なら、より高エンゲージメントの投稿を優先します(それが他の人が見ているものです)。
  • センチメントが混在なら、同じ側の 2 つではなく、それぞれの側を 1 つずつ示します。
  • オペレーターがトーンを直接判断できるよう、常に逐語テキスト + 著者 + URL を含めます。引用をでっち上げたり、よりきれいなものに言い換えたりは決してしないでください。

何が変わったか差分

過去のブリーフがあれば、現在の各テーマをそれに照らして分類します:

ステータス意味
New前回の実行になかった
Growing前回の実行よりボリュームまたはリーチが高い
Steadyおおむね変化なし
Fading前回の実行より低い
Resolved消えたか修正された、過去の complaint/misinfo のテーマ

繰り越されたテーマの センチメントシフト(例: 修正後に称賛に変わった不満)も記録します。

出力

フィードのダンプではなく、短いブリーフ:

  • TL;DR — この実行で知る価値のある 3〜5 件を、平易な文で。
  • Repeated themes — 表、続いてテーマごとに 1〜2 行:
ThemeTypeVol (reach-wtd)PlatformsLeanStatus vs last run
"pricing went up"complaint14 (high)X, RedditnegativeGrowing

各テーマの下に 1〜2 件の逐語的な投稿例 + URL を付けます。

  • What changed since last run — new / growing / fading / resolved のテーマとセンチメントのシフト(または「baseline — first run」)。
  • Worth a closer look — 人間の判断を要するかもしれないもの(バイラルな不満、誤情報、報道メンション)。フラグするが行動はしない。

時間ウィンドウ、使用した検索ターム、チェックしたプラットフォーム(そして Reddit についてはシードサブレディット — Reddit のカバレッジがキーワードスイープではなくシード駆動であることをフラグ)、そして レコードコスト(UnifAPI の billing メタデータまたは最善の見積もり)を述べ、ブリーフが再現可能になるようにします。

実例(要約)

ウィンドウ: ローンチ以降 7 日。X、Reddit、ニュースにわたって、「the free tier is gone」が complaint としてクラスタリング: 14 メンション、高リーチ(いいね 2.3k の X 投稿 1 件、アップボートされた r/… スレッド 2 件、ニュースピックアップ 1 件)。クロスプラットフォームの広がり = 3 → #1 にランク。先週のベースラインに対するステータス: New。投稿例は URL 付きで逐語的に引用。「worth a closer look」の下にフラグ — ニュースピックアップが不正確な価格を繰り返しているため、修正するかどうかは人間が判断すべきです。別の「love the new UI」称賛テーマは X のみ(広がり 1)で、同様のボリュームにもかかわらずそれより下にランクしました。

ガードレール

  • オンデマンドで実行され、常設のストリームではない。 各実行はそのウィンドウのスナップショットです。リアルタイムにアラートしたり継続的に実行したりはしません。
  • 公開データのみを読む — 公開の投稿、コメント、動画、記事。プライベートメッセージなし、所有アカウントの分析なし、フォロワーのエクスポートなし、アカウント内部のエンゲージメントダッシュボードなし。
  • 手ではなく目。 モニタリングしてブリーフします。投稿、リプライ、DM、その他メンションへの行動は一切しません — 何を(もしあれば)するかはオペレーター自身のチームが決めます。
  • ボリュームとセンチメントは、測定されたシェアオブボイスではなく、方向性のある公開データの推定です。おおまかなカウントと日付を提示し、オペレーターが自分でトーンを判断できるよう逐語的に引用します。
  • カバレッジはプラットフォームによって不均一、そう述べる。 Reddit にはキーワード検索がないため、そのカバレッジはシードサブレディット次第です — Reddit を網羅的なスイープとして提示しないでください。ここでの YouTube はコメント一覧を公開していないため、YouTube シグナルはタイトル/説明/カウントのみです — YouTube のコメントを読んだと主張しないでください。
  • コミュニティとソーシャルのソースは強い意見とパワーユーザーに偏ります。ランキングルールが課す通り、単一の大きなスレッドではなくクロスプラットフォームの重なりで重み付けします。

関連スキル

  • reddit-community-research(Social Listening Agent): テーマの背後にあるサブレディットを深掘りする — ニッチの繰り返される質問、反論、言語、アウトリーチ安全なスレッドをマッピングする。
  • customer-research(Content Strategy Agent): ブリーフの繰り返される不満と称賛を、再利用可能なボイスオブカスタマーのリサーチに変える。
  • unifapi: 共有データスキル — MCP を接続し、このブリーフが読む X / Reddit / YouTube / TikTok / Threads / News のオペレーションを発見する。

ソース: GitHub 上の social-listening-brief/SKILL.md — 改善するにはそちらで PR を開いてください。

公開データツール

この skill が呼び出すライブ API

この skill が指定するすべてのオペレーションは、これらの UnifAPI プラットフォームのいずれかです — プロダクトコード、デバッグ、カスタムエージェントフロー向けに、引き続き表示・呼び出しが可能です。

  • 週次ブリーフ
  • 繰り返されるテーマ
  • 投稿の例
関連する skills

Social Listening Agentにある、ほかの skills

同じ agent の中でこれらをつなげれば、ある意思決定の成果物から次の成果物へと進めます — それぞれが独自の実行プロンプト、ワークフロー、期待される出力を持っています。

Reddit リサーチ

あるニッチについて、サブレディット、繰り返される疑問、反論、言葉をマッピングします。

Reddit リサーチ を開く

スレッド適合チェック

誰かが返信する前に、関連性、意図、ルール、タイミング、アカウントリスクで Reddit スレッドをスコアリングします。

スレッド適合チェック を開く
Social Listening Agentのすべての skill を見る