Skip to main content
skill CX Codex

social-listening-brief — Claude Code skill: social listening reports

Pulls public mentions of a brand, product or topic from Reddit, TikTok, YouTube and elsewhere, then writes a cited report with themes and sentiment.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a claude-code
Open on GitHub

What social-listening-brief does

The skill kicks in when you ask what people are saying about a brand, a person, a product or a whole category. It searches public sources: Reddit posts and comments, TikTok keyword and hashtag search, YouTube transcripts and comments, Instagram, LinkedIn, Threads, and Google when platform search falls short. Results get clustered into themes instead of dumped as a link list.

You get a markdown brief: an executive summary with conversation volume and a confidence level, a table of themes with sentiment and representative quotes, notable posts, risks and opportunities, and a numbered action list. Every theme carries its URL, date, platform and engagement metrics.

The skill needs SCRAPECREATORS_API_KEY in your environment. It also states its own limits: this is public-data research, not exhaustive social monitoring, and averaging sentiment across very different communities needs caveats. So don't expect a single market-wide positivity score — you get a snapshot with the uncertainty left in.

What it helps with

  • gather quotes and links about a brand from Reddit and TikTok into one brief
  • find product complaints before a release
  • compare sentiment across separate communities
  • prepare a category discussion summary for a team meeting
  • separate notable posts from routine mentions

Example prompts for the agent

  • Run a social listening brief on what people say about our product on Reddit and TikTok this month
  • Find complaints and praise about competitor X on YouTube and Threads, with quotes and links
  • Build a category brief: top themes, sentiment, notable posts

How to install social-listening-brief

1Skills CLI (Vercel)

npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a claude-code

2Manually: put the files in place

~/.claude/skills/social-listening-brief/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/social-listening-brief/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about social-listening-brief

How do I install social-listening-brief in Claude?

Run npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a claude-code. The skill file then lands at ~/.claude/skills/social-listening-brief/SKILL.md.

What does social-listening-brief do?

It searches public mentions across Reddit, TikTok, YouTube, Instagram, LinkedIn and Threads, clusters them into themes, and returns a report with quotes, sentiment and recommended actions.

What does the skill need to run?

A SCRAPECREATORS_API_KEY environment variable. Without it the source queries won't go through.

Source text

SKILL.md · MIT
---
name: social-listening-brief
description: Use when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms. Produces cited themes, sentiment caveats, notable posts, and recommended actions.
allowed-tools: Bash, Read, Write, WebFetch

version: 1.0.0
author: ScrapeCreators
license: MIT
homepage: https://scrapecreators.com
repository: https://github.com/ScrapeCreators/social-media-research-skills
metadata:
  openclaw:
    requires:
      env:
        - SCRAPECREATORS_API_KEY
    primaryEnv: SCRAPECREATORS_API_KEY
    homepage: https://scrapecreators.com
    tags:
      - social-media
      - research
      - scrapecreators
---

# Social Listening Brief

## Overview

Research what people are saying publicly across social platforms. This is useful for brand monitoring, category research, product feedback, reputation checks, and understanding recent conversations.

## When to Use

Use this skill when the user asks:

- what are people saying about X?
- monitor this brand/topic/category
- find complaints or praise about a product
- summarize recent social discussion
- compare sentiment across Reddit, TikTok, YouTube, LinkedIn, Instagram, or Threads

## Useful Sources

- Reddit search, subreddit search, posts, comments
- TikTok search top/keyword/hashtag and comments
- YouTube search, transcripts, comments
- Instagram reels search and hashtag search
- LinkedIn post search
- Threads search
- Google search when platform search is not enough

## Workflow

1. Define topic, aliases, competitor names, and date window.
2. Search multiple relevant sources, not every source blindly.
3. Keep URLs, dates, platform, engagement metrics, and exact quotes.
4. Cluster conversations into themes.
5. Separate positive, negative, neutral, and mixed signals.
6. Highlight representative examples and action items.

## Output Format

```markdown
# Social Listening Brief: {topic}

## Executive Summary
- Main takeaway:
- Conversation volume: Low/Medium/High
- Sentiment: Positive/Neutral/Negative/Mixed
- Confidence: High/Medium/Low

## Top Themes
| Theme | Sentiment | Evidence | Representative quote/source |
|---|---|---|---|

## Notable Posts
- [source](url) — why it matters

## Risks / Opportunities
- ...

## Recommended Actions
1. ...
```

## Common Pitfalls

- Do not pretend this is exhaustive social monitoring. It is public-data research.
- Do not average sentiment across very different communities without caveats.
- Do not use engagement as a proxy for truth.

© ScrapeCreators · MIT · ScrapeCreators/social-media-research-skills

Similar skills

Everything for Marketing and content →

From the same set12

trend-discovery Finds trending topics, hashtags, and sounds across TikTok, Instagram, YouTube, Reddit, and Pinterest. Turns public signals into practical content angles. CX Codex +1 1,300installs influencer-prospecting Finds niche creators across TikTok, Instagram, and YouTube using public data, scores prospects from 1 to 5, and exports ready-to-contact lists to CSV. CX Codex +1 1,200installs content-repurposing Turns public social videos, transcripts and posts into drafts for other formats. Use it when one source needs adapting for several publishing channels. CX Codex +1 1,200installs product-demand-research This skill mines Reddit, social posts and video comments for complaints, requests and buyer objections. Useful before you commit to building a product. CX Codex +1 1,200installs audience-research Evaluates creator and brand audiences using public metrics, TikTok demographics, and comment signals. It helps teams check market fit before booking sponsorships. CX Codex +1 1,200installs creator-profile-teardown Analyzes a public creator or brand account for positioning, content pillars, outlier posts and repeatable patterns. Use it when you need research before adapting content ideas. CX Codex +1 1,200installs comment-mining Mines public social media comments to uncover audience questions, objections, content ideas, and buying intent. CX Codex +1 1,200installs transcript-intelligence Pulls transcripts from TikTok, YouTube, Instagram and other social video, then extracts hooks, quotes and reusable content ideas. CX Codex +1 1,300installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor