Use Claude Code to research TikTok and Instagram
Updated
Virlo is social listening for TikTok and Instagram Reels. Claude Code can't see what's going viral on social media by itself. Add Virlo with one terminal command and it can pull trends, hooks, sounds and outlier videos from a database of 23.1M viral videos, then keep the research as files in your project, next to your scripts and briefs.
- One command: claude mcp add
- A plugin with four research commands
- Skills that work in Claude Code and Cursor
Part of Virlo's AI assistant guides. Using the Claude chat app instead? See the Claude guide. Coding in Cursor? See the Cursor guide.
How do I add Virlo to Claude Code?
Four steps in your terminal. Steps 2, 3 and 5 are all you need; the plugin in step 4 adds ready-made research commands.
Step 1: Create your Virlo account for free
Step 2: Add the Virlo server
Run this in your terminal. It registers Virlo's hosted server; add
--scope projectto share it with your team in.mcp.json.Terminalclaude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcpStep 3: Sign in to Virlo
Start
claude, type/mcp, pick virlo and sign in to Virlo in the browser tab that opens. No key to paste. For unattended runs, add the header below to the step 2 command instead of signing in.Optional: use an API key--header "Authorization: Bearer virlo_tkn_YOUR_KEY"Step 4: Optional: install the Virlo plugin
Inside Claude Code, run these two commands. The plugin connects the server for you and adds two skills plus four commands:
/trend-scout,/creator-deep-dive,/niche-analysisand/genre-monitor.Claude Code/plugin marketplace add Virlo-AI/Virlo-Agent-Plugin /plugin install virlo@virloStep 5: Ask your first question
Claude Code asks before it calls a tool, then writes the result where you tell it to.
PromptWhat TikTok formats are creators copying in [your niche] this week? Save the top 5 to research/trends.md with an example link for each.
Check the server is registered with claude mcp list. It shows virlo with its URL and whether it is connected.
MCP command vs plugin vs skills vs CLI: which route should I use?
| Route | Command | Sign-in | What you get | Best for |
|---|---|---|---|---|
| MCP server | claude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp | Virlo sign-in through /mcp, or an API key header | Every Virlo tool | Most people |
| Virlo plugin | /plugin marketplace add Virlo-AI/Virlo-Agent-Plugin, then /plugin install virlo@virlo | Virlo sign-in, no key | The server, two skills and four slash commands | Research you repeat every week |
| Skills only | npx skills add Virlo-AI/Virlo-Agent-Plugin | Uses the server from step 2 | Two skills: virlo and short-form-trend-research | Repos shared with a team, or Claude Code and Cursor side by side |
| Virlo CLI | npm install -g virlo-cli, virlo setup, then virlo skill install | API key, saved by virlo setup | A virlo terminal command, plus a skill that teaches Claude to use it | Scripts and pipelines that skip MCP |
Which hook types work best on TikTok and Instagram?
Here's a real result Claude Code can pull with search_hooks and save to a file: the hook types that most often reach a Virality Score of 18 or more, TikTok against Instagram, from Virlo's daily hook snapshot.
In Virlo's snapshot of 1,353,173 hook-tagged TikTok videos, POV setup hooks reached a Virality Score of 18 or more 32.9% of the time, against 18.1% on Instagram.
As of November 18, 2026
| Hook type | TikTok: share at 18+ | Instagram: share at 18+ | TikTok videos |
|---|---|---|---|
| POV setup | 32.9% | 18.1% | 49,405 |
| Shock statement | 31.8% | 16.7% | 69,542 |
| Relatable scenario | 31.2% | 15.3% | 83,359 |
| Trend reference | 30.2% | 14.9% | 6,745 |
| Comparison | 29.8% | 18.9% | 13,216 |
| Before and after | 28.6% | 14.5% | 9,169 |
Hook types by niche, with every hook behind them
Split by 20+ niches, with the hooks and videos behind each number, in the Virlo app.
Open hooks in VirloHow this sample is made
- Source
- Virlo's daily hook snapshot: 1,353,173 TikTok and 262,402 Instagram videos whose opening hook was tagged by type.
- Window
- All tagged videos in the snapshot. Hook types with fewer than 1,000 videos on either platform, and videos with no hook, are left out.
- Method
- Share at 18+ = the share of videos with that hook type whose Virality Score is 18 or more, the "strong" band. Virality Score measures how far a video beat its creator's usual views.
- As of
- November 18, 2026. Rebuilt every day.
- Made by
- Numbers are pulled automatically from Virlo's data; the text around them is written by the Virlo team.
Suggested citation: Source: Virlo, “Use Claude Code to research TikTok and Instagram”, virlo.ai/claude-code
How does Claude Code use Virlo?
Claude Code sees every Virlo tool the moment the server is connected, and it reads the skills on its own when a task matches them.
- It turns a plain question into the right tool call: trends, video search, creator lookups, sounds, hashtags or hooks.
- It ranks videos by Virality Score, not raw views, so a small creator's breakout counts.
- It waits for long research jobs, such as a new marketing agent, and reads the results once they are final.
- It writes what it finds to Markdown, JSON or CSV in your repo, so the next session starts from your notes.
- It asks before each tool call, so nothing runs without your OK.
What can I ask Claude Code to research?
These work in any Claude Code session with Virlo connected. Replace the brackets.
Weekly trend file
Pull the top 10 TikTok trends to copy this week and write them to research/[date]-trends.md with stage, creators this week and one example link.
Hook bank
Find the 30 strongest hooks in [your niche] on TikTok and Instagram and save them to hooks.csv with the source video for each.
Competitor brief
Look up @[competitor] on TikTok and Instagram. Write competitor.md: their outlier videos, posting rhythm and the formats they repeat.
Script from a video
Get the transcript of [TikTok link], list its beats, then write a 30-second script for [your product] that keeps the same beats.
Sound shortlist
Which sounds are trending on Instagram Reels this week? Add the five best fits for [your brand] to sounds.md.
Niche study
Run /niche-analysis for [your niche] and save the report to research/niche.md.
Content plan
Use the short-form-trend-research skill to plan next week's videos for [your brand] from live trend data.
Repo-aware brief
Read our product docs in /docs, then find the 10 TikTok videos that best match what we sell and explain why each one worked.
Claude Code vs Claude vs Claude Cowork: which guide do I need?
This page is about Claude Code. All three reach the same Virlo server.
Claude Code (this page)
The terminal and IDE agent. Add Virlo with claude mcp add, the plugin or the skills, and keep results as files.
Claude
The chat app at claude.ai and on desktop. Add Virlo from the Claude directory with one click; no terminal.
Claude Cowork
Anthropic's desktop agent. It uses the same Claude connector, so follow the Claude guide.
What are the limits?
- Public TikTok and Instagram data only. Virlo never logs in to your social accounts and has no way to post.
- Tool calls need your OK in an interactive session. For scripts, allow the Virlo tools in your Claude Code settings first.
- Servers load when Claude Code starts, so restart your session after you add Virlo.
- Full transcripts exist for TikTok videos, not Instagram ones.
- Plans are on the pricing page.
Frequently asked questions
How do I give Claude Code social media data?
Connect Virlo's MCP server. Run claude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp in your terminal, start claude, type /mcp and sign in to Virlo. Claude Code can then search TikTok and Instagram videos, trends, sounds, hashtags, hooks and creators, and save what it finds to files in your project.
How do I use Claude Code for TikTok research?
Add Virlo, then ask a research question that ends in a file: "Pull this week's top 10 TikTok trends to copy and save them to trends.md." Claude Code calls Virlo, ranks videos by Virality Score and writes the result. The /trend-scout command from the Virlo plugin runs a full trend report in one step.
What is the Virlo plugin for Claude Code?
A Claude Code plugin from Virlo-AI/Virlo-Agent-Plugin. Install it with /plugin marketplace add Virlo-AI/Virlo-Agent-Plugin, then /plugin install virlo@virlo. It connects the Virlo server with a sign-in, and adds two skills and four commands for trend reports, creator deep dives, niche studies and genre monitors.
What are Claude Code skills for social media research?
Skills are SKILL.md files that teach Claude Code a job. Virlo ships two: virlo, which picks the right tool and ranks by Virality Score, and short-form-trend-research, which turns live trend data into a weekly content plan. Install both with npx skills add Virlo-AI/Virlo-Agent-Plugin.
Do I need an API key to use Virlo in Claude Code?
Not with the sign-in route: type /mcp and sign in to Virlo, and a key is made for you. Use a key when Claude Code runs without you, such as from a script, by adding --header "Authorization: Bearer virlo_tkn_YOUR_KEY" to the claude mcp add command. Get keys from your Virlo dashboard.
Claude Code doesn't see the Virlo tools. What should I check?
Run claude mcp list and confirm virlo is there; if not, run the claude mcp add command again. Start a new session, because servers load at startup, then type /mcp and finish the sign-in. With a key, check it starts with virlo_tkn_ and was copied in full.
Can Claude Code run Virlo research without me?
Yes. Claude Code's headless mode, claude -p "...", runs one prompt and exits, so a script or scheduled job can refresh a trends file each morning. Set Virlo up on that machine with an API key header and allow the Virlo tools in your settings, since nobody is there to approve them.
Is Claude Code the same as Claude?
No. Claude Code is the terminal and IDE agent for developers. Claude is the chat app at claude.ai and on desktop, where you add Virlo from the Claude directory with one click. Both use the same Virlo server; the Claude guide covers the chat app.
Does Virlo work with Cursor too?
Yes. Cursor connects to the same Virlo server through its mcp.json file, and the Virlo skills install for Cursor and Claude Code in one npx skills add command. The Cursor guide has the config to paste and the checks to run after a restart.
Research social media from your terminal
One command connects Claude Code to Virlo. Ask your first question in under a minute.