Use the Factory Droid CLI to research TikTok and Instagram
Updated
Virlo is social listening for TikTok and Instagram Reels. Factory's Droid can work through a codebase, run tests and open pull requests, but it cannot check what is performing on TikTok or Instagram. Run droid mcp add with the Virlo URL and Droid can search a database of 23.1M viral videos for trends, hooks, sounds and outliers in interactive sessions and droid exec jobs alike. Droid is Factory's agent, and the Droid CLI runs it from your terminal, editor, tests and Git workflow.
- droid mcp add with --type http, then sign in from /mcp
- Team-shared through .factory/mcp.json
- Works headless in droid exec for CI and cron
Part of Virlo's AI assistant guides. Comparing agents? See Codex or Amp.
How do I add an MCP server to the Droid CLI?
One command registers Virlo and the /mcp manager finishes sign-in. You need the Droid CLI and a Virlo account.
Step 1: Create your Virlo account for free
Step 2: Register Virlo as an HTTP server
Run this in your terminal. Droid stores virlo in
~/.factory/mcp.json, the user-level file that applies to every project.Terminaldroid mcp add virlo https://dev.virlo.ai/api/mcp/mcp --type httpStep 3: Authenticate from the /mcp manager
Start
droid, type/mcp, select virlo and authenticate. Your browser opens the Virlo approval page; approve it and Droid saves the login.droid mcp authruns the same flow from the shell.Inside Droid/mcpStep 4: Check the status
The list command shows each server as connected, connecting, needs authentication or failed. virlo should say connected.
Terminaldroid mcp listStep 5: Hand Droid a research task
Ask in plain English inside a Droid session. It picks the Virlo tool, asks for approval according to your settings and writes the output where you say.
Your first promptUse Virlo to find the hook types that reach a Virality Score of 18+ most often in [your niche] on TikTok and Instagram, then write a ranked table to docs/hooks.md.
For a team repo, add the same server to .factory/mcp.json at the project root and commit it. Keep keys out of that file; each person signs in with their own Virlo account.
OAuth vs header vs project file: which Droid setup should I pick?
| Setup | Command or file | Auth | Best for |
|---|---|---|---|
| OAuth sign-in | droid mcp add virlo https://dev.virlo.ai/api/mcp/mcp --type http | Virlo approval page via /mcp | Interactive sessions on your laptop |
| Header | --header "Authorization: Bearer virlo_tkn_..." on the same command | API key in ~/.factory/mcp.json | droid exec in CI or cron |
| Project file | .factory/mcp.json committed to the repo | Each teammate signs in | Shared repos with no secrets in git |
| Virlo skills | npx skills add Virlo-AI/Virlo-Agent-Plugin | Uses the server above | Better tool choice and Virality Score ranking |
Header keys come from Virlo API Keys; the --header flag can be repeated and only applies to http and sse servers.
Droid alone vs Droid with Virlo
| Job | Droid without Virlo | Droid with Virlo |
|---|---|---|
| Refresh a trends file in CI | No source to refresh from | droid exec pulls this week's trends to copy |
| Answer "which hook should we open with?" | Opinion from model memory | Hook-type rates at a Virality Score of 18+ |
| Seed a marketing dashboard | Mock rows | Real TikTok and Instagram videos with links |
| React to a competitor's breakout | Only if someone notices | A Virlo webhook on new outliers, handled by code Droid writes |
Which Virlo tools does Droid call, and what do they return today?
A live map of the questions Droid sends to Virlo, the tool that answers each one and the top answer right now, pulled from the same data Droid reads.
In Virlo's data, 659 creators posted the "My moon my man couple montage" trend in the last 7 days, the top answer the trends tool gives as of November 19, 2026.
As of November 19, 2026 at 13:07 UTC
| Question your app asks | Tool it calls | Top answer |
|---|---|---|
| Which format are most creators copying? | get_content_trends | My moon my man couple montage: 659 creators this week |
| Which sound is trending on Instagram Reels? | get_trending_sounds | "Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score]": 75 Reels in 7 days |
| Which hook type wins most often on TikTok? | search_hooks | POV setup: 32.9% reach a Virality Score of 18+ |
| Which hook type wins most often on Instagram? | search_hooks | Comparison: 19.0% reach a Virality Score of 18+ |
| What is the second trend to copy? | get_content_trends | While they're out partying btw: 346 creators this week |
Every answer, not just the top one
Connect the server and the same tools return the full lists, filters and history.
Start for freeHow this sample is made
- Source
- Virlo's Trends to copy, Instagram sound rankings and daily hook snapshot: the same data the MCP tools read.
- Window
- Trends: creators in the last 7 days. Sounds: Reels in the last 7 days. Hooks: all hook-tagged videos in the latest snapshot. TikTok and Instagram only.
- Method
- Each row is the top item for that question, from the data the named tool reads.
- As of
- Trends November 19, 2026 at 13:07 UTC; sounds November 19, 2026 at 12:03 UTC; hooks November 19, 2026.
- Made by
- Numbers are pulled automatically from Virlo's data every hour; the text around them is written by the Virlo team.
Suggested citation: Source: Virlo, “Use the Factory Droid CLI to research TikTok and Instagram”, virlo.ai/factory-droid
How do I run Virlo research in droid exec?
droid exec runs Droid non-interactively with structured input and output, which makes it a good fit for a scheduled research job. Use the header route so no browser is involved: register Virlo with the --header flag on the machine that runs the job, then call droid exec with a prompt.
The header version of the add command: droid mcp add virlo https://dev.virlo.ai/api/mcp/mcp --type http --header "Authorization: Bearer virlo_tkn_YOUR_KEY". After that, a cron entry or CI step can run something like droid exec "Refresh research/trends.md from Virlo for [your niche]" each Monday and commit the result.
Want Droid to react to events instead of a timetable? Virlo's REST API at https://api.virlo.ai/v1 accepts POST /v1/webhooks with a url and a list of events, such as tracking.outlier_video.detected or content_research_agent.run.completed. Ask Droid to build the receiving endpoint, and every new outlier or finished marketing agent run can kick off follow-up work in your repo.
Building a research Droid for your team
Custom Droids are scoped subagents you delegate to with /droids. A dedicated research droid keeps social data work separate from coding work:
- Give it one job: answer TikTok and Instagram questions with Virlo and return a file.
- Tell it to rank videos by Virality Score and always include example links.
- Let the main Droid hand it questions like "what hooks win in [your niche]" mid-task.
- Package the steps as a skill with
/create-skillso the whole team gets the same routine.
What can I ask Factory Droid to research?
Paste these into a Droid session or a droid exec call with virlo connected. Replace the brackets.
Hook ranking
Which hook types reach a Virality Score of 18+ most often in [your niche]? Write docs/hooks.md with the TikTok and Instagram rates side by side.
Trend refresh
Pull this week's trends to copy for [your niche], update research/trends.md and open a pull request with the changes.
Outlier export
Export 50 TikTok videos about [topic] from the last 30 days, ranked by Virality Score, to data/outliers.csv.
Creator report
Look up @[creator] on TikTok and Instagram and write a report on their outlier videos and repeated formats.
Transcript tool
Get the transcript of [TikTok link] and write a function that splits any transcript into hook, body and call to action.
Sound brief
List trending and breakout sounds on Instagram Reels this week and add the top five to the brief in content/brief.md.
Research droid
Create a custom droid called trend-researcher that only uses the virlo server and returns findings as Markdown.
Webhook wiring
Write a small endpoint in this repo that receives Virlo webhooks for tracking.outlier_video.detected and posts a summary to our team channel.
Factory Droid vs the Factory App vs other droids: which one is this?
"Droid" means several things, even inside Factory. This page is about the Droid CLI.
Droid CLI (this page)
Factory's agent in the terminal. Add Virlo with droid mcp add and manage it with /mcp.
Factory App
Factory's separate app surface for working with Droid. This guide covers the CLI setup.
Custom Droids
Scoped subagents you create and call with /droids inside a session. They can use the Virlo server you added.
Android droid tools
Android developer tools and devices nicknamed droid have nothing to do with Factory or MCP.
What are the limits?
- Public TikTok and Instagram data only; Droid cannot post or reach social accounts through Virlo.
- Project servers defined in
.factory/mcp.jsoncannot be removed withdroid mcp remove; edit the file instead. - Never commit API keys to
.factory/mcp.json; keep them in the user-level file or environment variables. - Trends to copy refresh every hour after review by the Virlo team.
- See pricing for Virlo plans.
Frequently asked questions
How do I add an MCP server to Factory Droid?
Run droid mcp add with a name, the URL and --type http. For Virlo: droid mcp add virlo https://dev.virlo.ai/api/mcp/mcp --type http. Droid saves it to ~/.factory/mcp.json. Then open /mcp inside a Droid session to finish the browser sign-in, and check with droid mcp list, which should show virlo as connected.
What is Factory Droid?
Droid is the AI agent from Factory. The Droid CLI runs it in your terminal, with project context, approvals, MCP tools and headless runs through droid exec. With Virlo connected, it can also research TikTok and Instagram while it works on your code.
Does the Droid CLI support remote MCP servers with OAuth?
Yes. Add the server with --type http, then run droid mcp auth or use the /mcp manager to complete the browser sign-in. Virlo supports OAuth with dynamic client registration, so no client ID has to be configured. If you prefer a key, the --header flag sends it instead.
Where does Droid store MCP servers?
Personal servers live in ~/.factory/mcp.json and apply to every project. Team servers go in .factory/mcp.json at the project root and get committed to git, so they should never contain keys. HTTP entries use type, url and optional headers fields, plus a disabled flag to pause one.
Can I use Virlo in droid exec?
Yes. Register Virlo with an Authorization header so no browser sign-in is needed, then run droid exec with your research prompt. It suits CI pipelines and scheduled jobs that refresh trend files, and its structured output formats make the results easy for the next step in a pipeline to read.
Can Factory Droid research TikTok trends?
With Virlo added, yes. Droid can request trends to copy, trending and breakout sounds, hashtags, hook types and outlier videos ranked by Virality Score, each returned with links to the original TikTok or Instagram post, and then fold those rows into code, docs or a pull request.
How do I remove Virlo from Droid?
Run droid mcp remove virlo for a server you added yourself. If virlo comes from a project .factory/mcp.json file, edit that file instead, because project-defined servers cannot be removed with the command. To pause it without deleting, toggle it off in the /mcp manager.
Can Droid post to Instagram through Virlo?
No. Virlo is a read-only research source for public TikTok and Instagram data, and it never connects to social accounts. Droid can analyse that data, build tools with it and write scripts from it, but posting to Instagram or TikTok stays outside Virlo and with your own publishing setup.
Does Factory Droid support skills for social media research?
Yes. Droid manages skills with /skills and creates new ones with /create-skill. Install Virlo's ready-made skills with npx skills add Virlo-AI/Virlo-Agent-Plugin, or package your own research routine, such as ranking by Virality Score and returning example links, so every session follows it.
Give Droid real social media data
Register Virlo once and research TikTok and Instagram from any Droid session or exec job.
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
- Paperclip
- 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
- 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