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.

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

    Terminal
    droid mcp add virlo https://dev.virlo.ai/api/mcp/mcp --type http
  3. Step 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 auth runs the same flow from the shell.

    Inside Droid
    /mcp
  4. Step 4: Check the status

    The list command shows each server as connected, connecting, needs authentication or failed. virlo should say connected.

    Terminal
    droid mcp list
  5. Step 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 prompt
    Use 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?

SetupCommand or fileAuthBest for
OAuth sign-indroid mcp add virlo https://dev.virlo.ai/api/mcp/mcp --type httpVirlo approval page via /mcpInteractive sessions on your laptop
Header--header "Authorization: Bearer virlo_tkn_..." on the same commandAPI key in ~/.factory/mcp.jsondroid exec in CI or cron
Project file.factory/mcp.json committed to the repoEach teammate signs inShared repos with no secrets in git
Virlo skillsnpx skills add Virlo-AI/Virlo-Agent-PluginUses the server aboveBetter 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

JobDroid without VirloDroid with Virlo
Refresh a trends file in CINo source to refresh fromdroid exec pulls this week's trends to copy
Answer "which hook should we open with?"Opinion from model memoryHook-type rates at a Virality Score of 18+
Seed a marketing dashboardMock rowsReal TikTok and Instagram videos with links
React to a competitor's breakoutOnly if someone noticesA 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

Which Virlo tools does Droid call, and what do they return today?
Question your app asksTool it callsTop answer
Which format are most creators copying?get_content_trendsMy 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_hooksPOV setup: 32.9% reach a Virality Score of 18+
Which hook type wins most often on Instagram?search_hooksComparison: 19.0% reach a Virality Score of 18+
What is the second trend to copy?get_content_trendsWhile 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 free

How 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-skill so 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.json cannot be removed with droid 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.