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.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 メタデータは保持してください。
ワークフロー
- ウォッチを枠付けする。 ブランド/製品/ローンチとその検索タームを取ります(名前、ハンドル、ハッシュタグ、誤記、比較する場合は競合ターム)。
.agents/product-marketing.md(または.claude/product-marketing.md)が存在すれば、まずそれを読み、欠けているものだけを尋ねます。Reddit については、キーワード検索がないため、オーディエンスが住んでいるシードサブレディットも尋ねます(または提案します)。時間ウィンドウ(例: 直近 7 日、またはローンチ日以降)を確認します。 - そのウィンドウについて、各サーフェスにわたってメンションを取得する —
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。 - 大きな投稿で増幅を追跡する。 高エンゲージメントの X 投稿については
x/tweets/{id}/quote_tweetsを、拡散している TikTok についてはtiktok/videos/{id}/commentsを取得します。引用ツイートとコメントは、増幅が同意か反発かを教えてくれます — それが傾きを変えます。 - テーマにクラスタリングする — 以下の方法を使います。
- 前回の実行と差分を取る。 過去のブリーフがあれば、何が新しいか、何が成長したか、何が薄れたか、そしてセンチメントのシフトを記録します。初回の実行なら、そう述べてベースラインを設定します。
- ブリーフを書く。 重要な 3〜5 件を先頭に置き、投稿例はテーマごとに強く代表的な数件に留めます。
テーマクラスタリング法
- まず純粋なノイズを落とします: ボット、無関係な同形異義語(ブランド名が一般的な単語でもある場合)、スパム。境界線上の項目は残し、フラグを立てます。
- 残りを、プラットフォームではなく メンションが実際に何についてか でグループ化します: praise / complaint / question / comparison / feature-request / misinformation / news-pickup。
- 各テーマについて、おおまかな ボリューム(メンション数)と リーチ加重ボリューム(エンゲージメントの合計)を計算します — 高エンゲージメント投稿の 3 メンションのテーマは、誰も見なかった 12 メンションのテーマより重要でありうるのです。
- 全体の 傾き を割り当てます: positive / negative / neutral / question。混在なら混在と述べ、内訳を示します。
- テーマを まずクロスプラットフォームの広がり、続いてリーチ加重ボリューム でランク付けします。3 プラットフォームのテーマは、より大きな単一プラットフォームのスレッドを上回ります。広がりのほうが偽装しにくいシグナルだからです。
投稿例の選定ルール
各テーマについて、最大 1〜2 投稿を示します。最も大きいものではなく 代表的 になるよう選びます:
- テーマを著者自身の言葉で最も明確に述べている投稿を選びます。
- 2 つが同等に明確なら、より高エンゲージメントの投稿を優先します(それが他の人が見ているものです)。
- センチメントが混在なら、同じ側の 2 つではなく、それぞれの側を 1 つずつ示します。
- オペレーターがトーンを直接判断できるよう、常に逐語テキスト + 著者 + URL を含めます。引用をでっち上げたり、よりきれいなものに言い換えたりは決してしないでください。
何が変わったか差分
過去のブリーフがあれば、現在の各テーマをそれに照らして分類します:
| ステータス | 意味 |
|---|---|
| New | 前回の実行になかった |
| Growing | 前回の実行よりボリュームまたはリーチが高い |
| Steady | おおむね変化なし |
| Fading | 前回の実行より低い |
| Resolved | 消えたか修正された、過去の complaint/misinfo のテーマ |
繰り越されたテーマの センチメントシフト(例: 修正後に称賛に変わった不満)も記録します。
出力
フィードのダンプではなく、短いブリーフ:
- TL;DR — この実行で知る価値のある 3〜5 件を、平易な文で。
- Repeated themes — 表、続いてテーマごとに 1〜2 行:
| Theme | Type | Vol (reach-wtd) | Platforms | Lean | Status vs last run |
|---|---|---|---|---|---|
| "pricing went up" | complaint | 14 (high) | X, Reddit | negative | Growing |
各テーマの下に 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 プラットフォームのいずれかです — プロダクトコード、デバッグ、カスタムエージェントフロー向けに、引き続き表示・呼び出しが可能です。
- 週次ブリーフ
- 繰り返されるテーマ
- 投稿の例
Social Listening Agentにある、ほかの skills
同じ agent の中でこれらをつなげれば、ある意思決定の成果物から次の成果物へと進めます — それぞれが独自の実行プロンプト、ワークフロー、期待される出力を持っています。