Give your Paperclip AI agents live TikTok and Instagram research
Updated
Virlo is social listening for TikTok and Instagram Reels. Paperclip can organise a whole team of AI agents, but none of them knows which TikTok or Instagram videos are breaking out unless a tool tells them. Import the Virlo skill, give agents a Virlo key, and your marketing agents can pull trends, hooks, sounds and outliers from a database of 23.1M viral videos. Paperclip is an open-source, MIT-licensed platform for running a company of AI agents, with org charts, tickets, budgets, approvals and heartbeats, where each agent is an adapter such as Claude Code, Codex or Gemini CLI.
- Import the Virlo skill once for the whole company
- One key per agent as an environment secret
- MCP for Claude Code and Codex adapters
Part of Virlo's AI assistant guides. Most Paperclip agents run on Claude Code or Codex; their guides cover the adapter side.
How do I add Virlo to Paperclip agents?
Virlo goes where your agents actually run. Paperclip ships the skill to them, and a key in each agent's environment lets them call Virlo.
Step 1: Create your Virlo account for free
Step 2: Install the Virlo CLI on the agent host
On the machine where your Paperclip adapters execute, install the CLI and paste your key into
virlo setup.virlo whoamiconfirms the key works.Terminalnpm install -g virlo-cli virlo setup virlo whoamiStep 3: Import the Virlo skill into your company
On the Paperclip Skills page, paste the GitHub source below into the source field and press Add (or use Skills, Sources, Import from GitHub). Paperclip pins the skill to a commit, so upgrades are deliberate.
Skill sourceVirlo-AI/Virlo-Agent-PluginStep 4: Assign the skill and the key to your marketing agents
Give the
virloandshort-form-trend-researchskills to the agents that do research, and addVIRLO_API_KEYunder Environment variables on each agent as a secret reference.Step 5: Open a ticket for the research agent
Assign the first task in plain language. On its next heartbeat the agent loads the Virlo skill, runs the research and posts the result back to the ticket.
Your first promptUse Virlo to pull this week's top 5 TikTok and Instagram trends to copy in [your niche], with the best hook on each and an example video. Save it to research/trends.md and hand a summary to the content lead.
Agents on the Claude Code adapter can also use Virlo's MCP server directly: run claude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp on the host and sign in once. Codex agents use codex mcp add virlo --url https://dev.virlo.ai/api/mcp/mcp.
Skill + CLI vs MCP server: which route do Paperclip agents need?
| Route | How the agent reaches Virlo | Credential | Works for these adapters |
|---|---|---|---|
| Virlo skill + CLI | The skill teaches the agent to run virlo … --json in its shell | VIRLO_API_KEY as an agent environment secret | Any adapter that runs shell commands: Claude Code, Codex, Gemini CLI, OpenCode, Hermes, Kimi Code |
| MCP server | The adapter's own MCP client calls Virlo's research tools | OAuth sign-in on the host, or a bearer header | MCP-native adapters such as Claude Code and Codex |
| Both | Skill for routines and exports, MCP for ad hoc questions | Same Virlo account | A research agent that also answers teammates on tickets |
Paperclip keeps budgets and approvals at the company level either way, so Virlo calls sit inside the same controls as every other agent action.
Which hook types should your Paperclip content agents favour?
A research agent with the Virlo skill can drop this into a ticket: hook types ranked by how often TikTok videos using them hit a Virality Score of 18 or more, next to the Instagram rate.
In Virlo's snapshot of 1,365,774 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 19, 2026
| Hook type | TikTok: share at 18+ | Instagram: share at 18+ | TikTok videos |
|---|---|---|---|
| POV setup | 32.9% | 18.1% | 49,587 |
| Shock statement | 31.8% | 16.8% | 70,816 |
| Relatable scenario | 31.2% | 15.3% | 84,123 |
| Trend reference | 30.3% | 15.3% | 6,884 |
| Comparison | 29.8% | 19.0% | 13,443 |
| Before and after | 28.6% | 14.6% | 9,249 |
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,365,774 TikTok and 264,108 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 19, 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, “Give your Paperclip AI agents live TikTok and Instagram research”, virlo.ai/paperclip
How do I set up a marketing department of Paperclip agents with Virlo?
Paperclip lets you model a team as an org chart, so give research a seat of its own. One agent owns Virlo; the others take its output and turn it into work. Budgets cap what each seat can spend on model calls, and approvals gate anything that leaves the company.
- Research lead (Claude Code adapter): has the Virlo skill and key, runs a daily routine for trends to copy and breakout sounds.
- Content writer (Codex adapter): receives the research ticket and writes scripts that keep each trend's structure.
- Competitor analyst (Gemini CLI adapter): checks rival handles weekly and files any video scoring 18 or more on Virality Score.
- Editor-in-chief (you, on the board): approves the weekly plan before anything goes to clients.
- Reporter: on the first of each month, compiles the month's tickets into a client-ready summary.
Keep the Virlo key on the research seats only. Writers do not need it if the research lead hands them finished briefs.
Which Virlo CLI commands do Paperclip agents use most?
The skill tells agents which command fits the task and to add --json so results are easy to parse and attach to a ticket. Some commands ask before they start a research run; -y confirms runs so an unattended heartbeat never stalls on a prompt.
| Command | What the agent gets |
|---|---|
virlo trends digest --json | This week's trends to copy, with the part to keep and example videos |
virlo sounds trending --json | Trending sounds for TikTok and Instagram Reels |
virlo hashtags list --json | Hashtags ranked by recent use |
virlo satellite creator tiktok @[handle] --include videos,outliers --json | A creator profile with their outlier videos |
virlo satellite video-outlier [video url] --platform tiktok --json | How far one video beat the creator's usual views |
What tickets can I assign to Paperclip agents with Virlo?
Write these as tasks for your research agent. Replace the brackets.
Daily trend routine
Every weekday, use Virlo to list new trends to copy in [your niche], save them to research/[date].md and notify the content writer.
Script hand-off
Take today's top trend from research/[date].md and write three scripts for [your product] that keep its structure. Request approval before sharing.
Competitor file
Use Virlo to check @[competitor] on TikTok and Instagram every Friday and open a ticket for any video of theirs with a Virality Score of 18 or more.
Hook study
Compare hook types on TikTok and Instagram in [your niche] with Virlo and write the results as a table in docs/hooks.md.
Sound brief
Pull this week's trending sounds for TikTok and Instagram Reels with Virlo and pick the five that fit [your brand]'s tone.
Client month-end
Compile this month's research tickets for [client] into a report with the top trends, the best videos and next month's plan.
Creator scouting
Find 15 creators under [N] followers in [your niche] whose videos beat their follower count and add them to creators.csv for the partnerships agent.
Paperclip vs the agents it runs: where does Virlo plug in?
Paperclip is the company layer; the work happens inside adapters. Virlo connects at the adapter level.
Paperclip (this page)
The open-source orchestration layer: org charts, tickets, budgets, approvals and heartbeats. It ships the Virlo skill to agents and stores their keys as secrets.
Claude Code
The most common Paperclip adapter. It can use Virlo through the skill or as an MCP server with claude mcp add.
Codex
OpenAI's coding agent, Paperclip's other recommended adapter. Add Virlo with codex mcp add or the skill.
Hermes Agent
Also available as a Paperclip adapter, and usable on its own with Virlo from chat apps.
What are the limits?
- Paperclip agents get research data, not posting rights: Virlo reads public TikTok and Instagram content and holds no social credentials.
- The CLI and skill must exist on the host where adapters execute; a skill imported into Paperclip only reaches adapters that support skills sync.
- Store
VIRLO_API_KEYas a secret reference on each agent rather than a plain value, and give it only to research seats. - Trends to copy refresh hourly after review by the Virlo team; TikTok results include transcripts, Instagram Reels include hooks and numbers.
- Virlo plans are listed on pricing.
Frequently asked questions
How do I add a skill to Paperclip agents?
Import it on the Skills page by pasting a GitHub source, a skills.sh link or an npx skills add command, then assign it to agents. For Virlo, import Virlo-AI/Virlo-Agent-Plugin and give the virlo and short-form-trend-research skills to your research agents.
What is Paperclip AI?
Paperclip is an open-source, MIT-licensed platform for running teams of AI agents as a company. It organises agents in org charts with tickets, per-agent budgets, approvals, heartbeat scheduling and audit logs. Each agent is an adapter for a runtime such as Claude Code, Codex, Gemini CLI or Hermes.
Can Paperclip agents research TikTok and Instagram?
Yes, once they have Virlo. With the skill and a key, a Paperclip agent can pull trends to copy, outlier videos, hooks, sounds and TikTok transcripts, then write the findings to files or tickets for the rest of the org chart.
Do Paperclip agents support MCP servers?
Through their adapters. Paperclip itself orchestrates; MCP-native adapters like Claude Code and Codex connect to MCP servers on the host. Add Virlo to those agents with their own mcp add command, and use the skill plus CLI for any adapter that runs shell commands.
How do I give a Paperclip agent an API key?
Open the agent and add the key under Environment variables, either as a plain value or as a secret reference. For Virlo, name it VIRLO_API_KEY and use a secret reference, so the key never shows up in logs or exports.
Which Paperclip adapters work with Virlo?
Any adapter that can run shell commands works with the Virlo skill and CLI, including Claude Code, Codex, Gemini CLI, OpenCode, Hermes and Kimi Code. Claude Code and Codex can also call Virlo as an MCP server, which suits agents that answer ad hoc questions on tickets.
Can Paperclip agents post to social media through Virlo?
No. Virlo is read-only research on public TikTok and Instagram data and holds no social credentials. Your agents can plan, write and file work from it, and publishing goes through whichever approved tool your company already uses, behind the approval gates you set in Paperclip.
How do I schedule research in Paperclip?
Use heartbeats and routines. Give the research agent a daily routine that runs a Virlo command such as virlo trends digest --json, and its output lands in a ticket each morning for the writers to pick up. Budgets and approvals still apply to every scheduled run.
Hire a research desk for your Paperclip company
Import the Virlo skill, set one key and let your agents work from real TikTok and Instagram data.
More AI assistant guides
- AI assistant guides
- Claude
- Claude Code
- Cursor
- MCP server
- TikTok MCP server
- Instagram MCP server
- ChatGPT
- ChatGPT dots
- OpenAI Codex
- Gemini CLI
- Grok Build
- Claude Cowork
- n8n
- Zapier
- Grok Bot
- Muse
- Claude Duet
- Hermes Agent
- Kimi K3
- Cue
- Manus
- Perplexity Computer
- OpenClaw
- NanoClaw
- DeepSeek
- AI agents CLI
- ChatGPT agent
- Perplexity
- Microsoft Copilot
- Le Chat
- Notion
- Slack
- Discord
- Telegram
- Google Sheets
- Windsurf
- VS Code
- GitHub Copilot
- Cline
- JetBrains
- Kiro
- Google Antigravity
- goose
- Warp
- OpenCode
- Zed
- Amp
- Factory Droid
- Raycast
- Lovable
- Replit
- Bolt.new
- v0
- Ollama
- LM Studio
- Open WebUI
- LibreChat
- Make
- Pipedream
- Gumloop
- Lindy
- Relevance AI
- Airtable
- ClickUp
- Dify
- Flowise
- LangChain
- CrewAI
- OpenAI Agents SDK
- Mastra
- Vercel AI SDK
- Claude Agent SDK