mcpField
S
social-listening

social-listening

github.com/gooseworks-aiマーケティング・グロース1.3k39 回インストール3 日前に更新
リポジトリ

social-listening について

Social Listeningは、ウェブやソーシャルメディア上のブランドや競合への言及を追跡するマーケティング向けスキルです。幅広いウェブ検索、ソーシャル投稿の取得、特定ページからの構造化データ抽出を組み合わせます。

主な機能

  1. 01Exaによるウェブ上の言及検索
  2. 02XとLinkedInの投稿取得
  3. 03Scrapegraphによるページデータ抽出
  4. 04ブランド・競合・業界トピックの監視

活用シーン

  1. 01製品への公開フィードバックの確認
  2. 02競合の発表の追跡
  3. 03業界の議論の調査
  4. 04提携前のソーシャル動向の確認

インストール

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

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill social-listening

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

同梱ファイルskill.meta.json

詳細

ソーシャルリスニング

セットアップ

認証情報を設定する前に、利用可能な実行環境を選択してください。

  • ターミナルを使用しないクライアント: 以下のシェルコマンドはスキップしてください。接続済みの MCP ツールを使用してください。ScrapeCreators の操作では、scrapecreators-api を読み込み、call_data_provider を優先してください。接続済みのツールがないプロバイダーの手順では、ワークフローを維持できる場合は同等の組み込み公開ウェブ機能を使用するか、その手順を利用できないことを明確に伝えてください。
  • ローカルターミナル: 以下の GooseWorks 認証情報とプロキシコマンドを使用してください。

~/.gooseworks/credentials.json から認証情報を読み取ります。

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

~/.gooseworks/credentials.json が存在しない場合は、npx gooseworks login を実行するようユーザーに案内してください。

ローカルプロキシのエンドポイントでは Bearer 認証を使用します:-H "Authorization: Bearer $GOOSEWORKS_API_KEY"。以下の ScrapeCreators の操作説明は、どちらの実行環境でも共通です。

ソーシャルメディアやウェブ全体で、ブランドへの言及、競合他社の動向、業界の会話を追跡します。

使用するタイミング

  • ブランドや製品について人々が何と言っているかを監視したい場合
  • 「[会社]について、みんなは何と言っていますか?」と尋ねられた場合
  • 競合他社の製品発売や発表を追跡する場合
  • 業界のトレンドや評判を監視する場合
  • パートナーシップ締結前にソーシャルメディアでデューデリジェンスを行う場合

ワークフロー

ステップ 1:Exa でウェブ上の言及を検索する

ウェブ全体から最近の言及、レビュー、議論を見つけます。

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"exa","path":"/search"}'
  "query": "Notion reviews opinions user feedback",
  "numResults": 30,
  "contents": {"text": true}
}'
ステップ 2:Scrape Creators でソーシャルメディアを監視する

X/Twitter の投稿を確認します。

provider: scrapecreators
method: GET
path: /v1/twitter/user-tweets
query:
  handle: NotionHQ

LinkedIn で企業の活動を確認します。

provider: scrapecreators
method: GET
path: /v1/linkedin/company/posts
query:
  url: https://linkedin.com/company/notion

企業ページのみが必要な場合は /v1/linkedin/company を使用し、特定の投稿 URL を対象にする場合は /v1/linkedin/post を使用してください。

ステップ 3:Scrapegraph で重要なページを詳細にスクレイピングする

ステップ 1~2 で見つかった特定のページから、構造化データを抽出します。

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"scrapegraph","path":"/v1/smartscraper"}'
  "website_url": "https://example.com/review-page",
  "user_prompt": "Extract sentiment, key complaints, and praise about the product"
}'

例

ユーザー:「Slackについて、みんなは何と言っていますか?」

# Step 1: Web mentions
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"exa","path":"/search","body":{"query":"Slack reviews complaints praise 2025 2026","numResults":20,"contents":{"text":true}}}'

次に、選択した ScrapeCreators の実行環境を通じて、ステップ 2 の X/Twitter 操作を handle: SlackHQ で実行します。

ユーザー:「AI 業界の競合他社の製品発売を監視してください」

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"exa","path":"/search","body":{"query":"AI startup launch announcement new product 2026","numResults":30,"contents":{"text":true}}}'

ヒント

  • 幅広いウェブ監視(ブログ、フォーラム、ニュース)には Exa を使用します。
  • ソーシャルメディア(X/Twitter、LinkedIn、Instagram、TikTok)には Scrape Creators を使用します。
  • 特定の URL から構造化データを抽出するには Scrapegraph を使用します。
  • 最近の結果を得るには、Exa のクエリに日付範囲を含めます。
  • 比較分析に役立てるため、自社ブランドと競合他社の両方を追跡します。

コメント