Skip to main content
skill CX Codex

competitor-social-research — Claude Code skill: how to install

Researches competitor social media strategies across multiple platforms and generates a practical content brief from public metrics.

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

What competitor-social-research does

This skill analyzes public social profiles across TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, and Bluesky. It pulls recent posts, compares engagement metrics against each account's median baseline, and flags high-performing outlier content.

Under the hood, the skill queries scrapecreators-api endpoints for profiles, video feeds, transcripts, and comments. It uses Bash, Read, Write, and WebFetch tools to process the retrieved data and structure findings.

The final output is a Markdown brief detailing competitor benchmarks, content pillars, whitespace opportunities, and testable hypotheses. You need a valid SCRAPECREATORS_API_KEY in your environment, or profile calls will fail.

What it helps with

  • benchmark competitor posting cadence and formats across social networks
  • identify viral outlier posts using account-level median baselines
  • discover content gaps and underserved audience questions
  • generate structured Markdown briefs with actionable content tests

Example prompts for the agent

  • Compare the Instagram and TikTok accounts of competitor1 and competitor2, then find their top-performing reels.
  • Analyze recent YouTube videos from our niche competitors and produce a competitor research brief with content gaps.

How to install competitor-social-research

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/competitor-social-research/SKILL.md

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

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

Questions about competitor-social-research

How to install competitor-social-research in Claude Code?

Run npx skills add ScrapeCreators/social-media-research-skills --skill competitor-social-research -a claude-code in your terminal.

What does competitor-social-research do?

It pulls public data from competitor social profiles, benchmarks outliers against account medians, and outputs a strategy brief.

What API key is required to use this skill?

You must set the SCRAPECREATORS_API_KEY environment variable to authenticate requests against the ScrapeCreators endpoints.

Source text

SKILL.md · MIT
---
name: competitor-social-research
description: Use when the user wants to research competitors' social media strategy, compare brands or creators, find what content is working in a niche, identify content gaps, or produce a practical social strategy brief from public social data.
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
---

# Competitor Social Research

## Overview

Analyze what competitors are doing on social and what appears to be working. This skill combines profile data, recent posts, outlier analysis, transcripts, and optionally comments to produce a practical competitor brief.

## When to Use

Use this skill when the user asks to:

- compare competitors on TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, or other social platforms
- find what content is working in a niche
- benchmark posting frequency, formats, topics, and engagement
- identify content gaps or opportunities
- build a social strategy from competitor research

## Workflow

1. **Define competitors and platforms**
   - Use provided handles/URLs.
   - If only company names are provided, search profiles first and confirm likely matches when ambiguity matters.

2. **Fetch profile snapshots**
   - Followers/subscribers
   - Bio/positioning
   - Links
   - Verification/public metadata

3. **Fetch recent content**
   - Pull comparable recent windows per competitor.
   - Track source URLs, dates, captions, formats, and metrics.

4. **Find outliers per competitor**
   - Use each account's own median baseline.
   - Do not compare raw views between a huge brand and a small brand without context.

5. **Analyze content strategy**
   - Content pillars
   - Formats
   - Hook styles
   - Posting cadence
   - Offers/CTAs
   - Use of founder/creator personality
   - Community/comment patterns

6. **Find gaps and opportunities**
   Look for:
   - topics competitors avoid
   - formats that overperform but few competitors use
   - unanswered audience questions
   - weak hooks or repetitive content
   - platform whitespace

## Useful ScrapeCreators Endpoints

Use the relevant profile/feed/detail/transcript/comment endpoints from `scrapecreators-api`. Common routes include:

- TikTok: `/v1/tiktok/profile`, `/v3/tiktok/profile/videos`
- Instagram: `/v1/instagram/profile`, `/v2/instagram/user/posts`, `/v1/instagram/user/reels`
- YouTube: `/v1/youtube/channel`, `/v1/youtube/channel-videos`, `/v1/youtube/channel/shorts`
- LinkedIn: `/v1/linkedin/company`, `/v1/linkedin/company/posts`
- Facebook: `/v1/facebook/profile`, `/v1/facebook/profile/posts`, `/v1/facebook/profile/reels`
- X/Twitter: `/v1/twitter/profile`, `/v1/twitter/user-tweets`
- Threads: `/v1/threads/profile`, `/v1/threads/user/posts`
- Bluesky: `/v1/bluesky/profile`, `/v1/bluesky/user/posts`

## Output Format

```markdown
# Competitor Social Research Brief

## Executive Summary
- Biggest opportunity:
- Competitor to study closest:
- Content format to test first:

## Competitor Snapshot
| Competitor | Platforms | Audience size | Posting cadence | Best-performing format | Notes |
|---|---|---:|---|---|---|

## What Is Working
### Competitor A
- Content pillars:
- Outlier examples:
- Hooks/formats:

## Cross-Competitor Patterns
1. ...
2. ...

## Gaps and Opportunities
| Opportunity | Evidence | Suggested test |
|---|---|---|

## Recommended Content Tests
1. ...
2. ...
3. ...

## Sources
- [Post/profile/ad](url)
```

## Common Pitfalls

- Do not compare competitors only by follower count. Engagement and outlier lift matter more.
- Do not mix platforms without platform context. A good LinkedIn post and good TikTok are different artifacts.
- Do not assume a profile match from a company name if multiple brands share the name.
- Do not present competitor strategy as fact when it is inferred from public content. Say "appears to" or "suggests".

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

Similar skills

Everything for Marketing and content →

From the same set12

ad-library-teardown This skill pulls active ads from the Meta, Google and LinkedIn ad libraries and breaks them into hooks, offers and CTAs. Useful when you want to see what the market is testing. CX Codex +1 1,300installs outlier-post-finder Finds posts and videos that beat an account's usual numbers, then explains why they worked. Handy when you want a swipe file built from someone else's hits. CX Codex +1 1,300installs 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

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