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.

  1. Step 1: Create your Virlo account for free

    Create your free Virlo account in under a minute. Already signed up? Open API Keys.
  2. Step 2: Add the Virlo server

    Run this in your terminal. It registers Virlo's hosted server; add --scope project to share it with your team in .mcp.json.

    Terminal
    claude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp
  3. Step 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"
  4. 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-analysis and /genre-monitor.

    Claude Code
    /plugin marketplace add Virlo-AI/Virlo-Agent-Plugin
    /plugin install virlo@virlo
  5. Step 5: Ask your first question

    Claude Code asks before it calls a tool, then writes the result where you tell it to.

    Prompt
    What 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?

RouteCommandSign-inWhat you getBest for
MCP serverclaude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcpVirlo sign-in through /mcp, or an API key headerEvery Virlo toolMost people
Virlo plugin/plugin marketplace add Virlo-AI/Virlo-Agent-Plugin, then /plugin install virlo@virloVirlo sign-in, no keyThe server, two skills and four slash commandsResearch you repeat every week
Skills onlynpx skills add Virlo-AI/Virlo-Agent-PluginUses the server from step 2Two skills: virlo and short-form-trend-researchRepos shared with a team, or Claude Code and Cursor side by side
Virlo CLInpm install -g virlo-cli, virlo setup, then virlo skill installAPI key, saved by virlo setupA virlo terminal command, plus a skill that teaches Claude to use itScripts 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

Which hook types work best on TikTok and Instagram?
Hook typeTikTok: share at 18+Instagram: share at 18+TikTok videos
POV setup32.9%18.1%49,405
Shock statement31.8%16.7%69,542
Relatable scenario31.2%15.3%83,359
Trend reference30.2%14.9%6,745
Comparison29.8%18.9%13,216
Before and after28.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 Virlo

How 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.