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.
npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/social-listening-brief/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/social-listening-brief/
1Skills CLI (Vercel)
npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a codex2Manually: put the files in place
.agents/skills/social-listening-brief/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a cursor2Manually: put the files in place
.cursor/skills/social-listening-brief/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ScrapeCreators/social-media-research-skills social-listening-brief2Manually: put the files in place
.github/skills/social-listening-brief/SKILL.md1Skills CLI (Vercel)
npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a gemini-cli2Platform CLI
gemini skills install https://github.com/ScrapeCreators/social-media-research-skills --path skills/social-listening-briefManually: put the files in place
.devin/skills/social-listening-brief/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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