Connect NanoClaw to TikTok and Instagram research

Updated

Virlo is social listening for TikTok and Instagram Reels. NanoClaw keeps every agent group in a sealed container, which also means it starts with no view of what TikTok and Instagram audiences are watching. Mount Virlo into a group as a remote MCP server and that agent can read trends, hooks, sounds and outlier videos from a database of 23.1M viral videos. NanoClaw is a small, open-source assistant built on Anthropic's Claude Agent SDK that runs each group in its own container and answers through chat apps such as WhatsApp, Telegram, Slack and Discord.

  • One ncl command per group
  • Only the groups you choose can see Virlo
  • Schedule recurring research straight from chat

Part of Virlo's AI assistant guides. Using the bigger gateway it was built as an alternative to? See OpenClaw. Prefer a terminal agent on the same SDK? See Claude Code.

How do I add Virlo to NanoClaw?

This assumes NanoClaw is already running from bash nanoclaw.sh with at least one channel paired. Run the commands from a host shell in your fork.

  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: Find the group that should get Virlo

    Every NanoClaw group has its own container config, so pick the one you research in, such as your marketing channel. Copy its id from the list.

    Terminal
    ncl groups list
  3. Step 3: Add Virlo as a remote MCP server

    Pass the group id, a server name and the Virlo URL with your key in the headers. From a host operator shell it applies straight away; asked from inside an agent container, it waits for your approval.

    Terminal
    ncl groups config add-mcp-server --id [group-id] --name virlo \
      --url https://dev.virlo.ai/api/mcp/mcp \
      --headers '{"Authorization":"Bearer virlo_tkn_YOUR_KEY"}'
  4. Step 4: Restart the group and add the skills

    A running container keeps its old config until it exits, so restart the group. While you are in the fork, add Virlo's research skills so the agent knows how to rank results.

    Terminal
    npx skills add Virlo-AI/Virlo-Agent-Plugin
  5. Step 5: Message your assistant

    Use your trigger word (NanoClaw's default is @Andy) in the group you just configured.

    Your first prompt
    @Andy use Virlo to show me the 5 TikTok trends with the most creators posting in [your niche] this week, with what to copy and one example video each.

The server's tools show up to the agent under the mcp__virlo__ prefix. Groups you skipped never receive the key or the tools, which keeps research out of your family or support chats.

Per-group MCP vs skills vs in-app alerts: which NanoClaw route fits?

RouteWhere it livesWho sees itBest for
Remote MCP serverThe group's mcp_servers entry, written by ncl groups config add-mcp-serverOnly that groupAsking @Andy live questions about trends, hooks and creators
Virlo skillsnpx skills add Virlo-AI/Virlo-Agent-Plugin in your forkAgents with the Virlo server mountedBetter tool choices and a weekly plan format
Virlo CLI in the containervirlo-cli added to the group image, key in VIRLO_API_KEYThat groupAgents that prefer shell commands with --json output
Virlo AutomationsYour Virlo account, delivering to Telegram, Slack or DiscordWhoever is in the destination chatFixed reports with no agent in the loop

Which TikTok trends would @Andy report this week?

The five trends to copy with the most creators posting over the last 7 days, the same list a NanoClaw group reads through Virlo's trends tool.

In Virlo's tracking of 39 live trends to copy, "My moon my man couple montage" leads TikTok this week with 659 creators posting it as of November 19, 2026.

As of November 19, 2026 at 13:07 UTC

Which TikTok trends would @Andy report this week?
TrendStageCreators this weekCreators last week
Example video for the My moon my man couple montage trend by @haleyybayleeMy moon my man couple montageFresh659new this week
Example video for the While they're out partying btw trend by @larpniverseWhile they're out partying btwRising346115
Example video for the He wanna pay full price SNL trend trend by @anereslaila1He wanna pay full price SNL trendFresh175new this week
Example video for the But you're not a Buddhist trend trend by @nicolo.contradaBut you're not a Buddhist trendFresh15833
Example video for the Shoulder carry mirror selfie trend trend by @thecapcutterxShoulder carry mirror selfie trendFresh158new this week

See all 39 trends to copy

Recipes, 30-day charts, client fit and every example video are in the Virlo app.

Open Trends to copy

How this sample is made

Source
Virlo's Trends to copy: formats found by Virlo's trend detector and published only after the team checks each one.
Window
Creators who posted each trend in the last 7 days, counted from TikTok and Instagram videos only. Trends made with an AI tool are left out.
Method
Ranked by creators posting this week. Stages: Fresh, Rising, Peaking, Fading.
As of
November 19, 2026 at 13:07 UTC. Refreshes every hour.
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, “Connect NanoClaw to TikTok and Instagram research”, virlo.ai/nanoclaw

How does a NanoClaw group store the Virlo server?

NanoClaw keeps one container config per agent group in its database. The mcp_servers field lists every server that group's container can reach, merged with NanoClaw's own built-in server when the runner starts. An entry is either a local command or a remote Streamable HTTP endpoint, and remote endpoints must use HTTPS, which Virlo's does.

At spawn time NanoClaw writes the config out to groups/[folder]/container.json, but that file is regenerated on every start, so make changes through ncl rather than by hand. The entry below is what the command above produces.

The Virlo entry in a group config
KeyValue
typehttp (NanoClaw also accepts streamable-http)
urlhttps://dev.virlo.ai/api/mcp/mcp
headersAuthorization: Bearer virlo_tkn_… from your API Keys page

Full shape: "mcp_servers": { "virlo": { "type": "http", "url": "https://dev.virlo.ai/api/mcp/mcp", "headers": { "Authorization": "Bearer virlo_tkn_YOUR_KEY" } } }. Keys come from your Virlo developer dashboard.

Can NanoClaw run Virlo research on a schedule?

Yes. NanoClaw takes scheduled tasks in plain chat, so you can ask the configured group for a recurring job, for example "@Andy every Monday at 9am, pull this week's TikTok trends to copy in [your niche] from Virlo and post the top 5 here." Ask "@Andy list all scheduled tasks across groups" to review or cancel them later.

What can I ask NanoClaw with Virlo mounted?

Send these in the group that has the Virlo server. Swap the brackets for your details.

  • Weekly scan

    @Andy which TikTok formats in [your niche] gained the most new creators this week? Give me the top 3 with an example each.

  • Outlier hunt

    @Andy find Instagram Reels about [topic] from the last 14 days with a Virality Score of 18 or more and tell me what they share.

  • Hook swipe

    @Andy pull 10 spoken hooks from top [your niche] TikToks and sort them by hook type.

  • Rival watch

    @Andy check @[competitor] on TikTok and Instagram. Which videos beat their normal views this month?

  • Sound pick

    @Andy what TikTok sounds are breaking out right now? Suggest two for a [tone] video about [product].

  • Script draft

    @Andy grab the transcript of [TikTok link] and write me a version for [your brand] with the same structure.

  • Recurring digest

    @Andy every Friday at 4pm, send me the 3 hashtags in [your niche] that grew fastest this week, with one video for each.

NanoClaw vs OpenClaw: which one am I running?

NanoClaw was created as a small, readable alternative to OpenClaw. The Virlo setup differs between them.

NanoClaw (this page)

A compact fork you clone and customise, with each group in its own Docker container. Virlo goes in per group through ncl groups config add-mcp-server.

OpenClaw

The larger self-hosted gateway with the ClawHub registry. Install Virlo with openclaw skills install @virlo-ai/short-form-market-research-brain.

Claude Agent SDK

The Anthropic library NanoClaw is built on. Building your own agent from scratch? That guide shows how to pass Virlo's server to the SDK.

What are the limits?

  • Virlo sees public TikTok and Instagram videos only and never signs in to any social account, so a NanoClaw group can study content but not publish it.
  • MCP changes made through ncl apply after the group restarts; a container that is already running keeps its previous config.
  • Each group needs its own entry. Mounting Virlo in one group does not share it with the others.
  • Virlo's team reviews each trend to copy, and the list refreshes every hour.
  • Compare Virlo plans on the pricing page.

Frequently asked questions

How do I add an MCP server to NanoClaw?

Use ncl groups config add-mcp-server with the group id and a server name. Remote servers take --url plus an optional --headers JSON object; local ones take --command. For Virlo, pass its server URL and an Authorization header with your key, then restart the group.

What is NanoClaw?

An open-source, self-hosted assistant built on Anthropic's Claude Agent SDK. It runs each agent group in its own Linux container that only sees what you mount, and it talks to you through channels such as WhatsApp, Telegram, Discord, Slack and Teams, each added with an /add skill.

Does NanoClaw support remote MCP servers?

Yes. A group config entry can be a stdio command or a remote Streamable HTTP endpoint with type set to http and a headers object. Remote URLs must use HTTPS and cannot carry credentials in the address, so keys belong in the headers.

Where are NanoClaw skills installed?

Skills are added to your fork. Channel and provider skills follow the /add pattern, such as /add-telegram, and copy just the modules you need. Third-party skill packs like Virlo-AI/Virlo-Agent-Plugin go in with npx skills add from the root of the fork.

Can NanoClaw see TikTok videos?

Through Virlo, yes: it gets each video's spoken hook, on-screen text, format, views, the creator's usual performance and, for TikTok, the full transcript. That is enough for the agent to explain why something broke out and draft a version for you.

Can I limit Virlo to one NanoClaw group?

That is the default. MCP servers are configured per group, so only the group whose config holds the Virlo entry can call it. Your other chats stay without the key or the tools, and you can remove it later with ncl groups config remove-mcp-server.

How do I change the NanoClaw trigger word?

NanoClaw answers to @Andy by default. Ask Claude Code in your fork to change it, for example "Change the trigger word to @Scout". Prompts on this page use @Andy; swap in whatever name your assistant uses. The trigger applies in every group, including the one with Virlo mounted.

Is NanoClaw better than OpenClaw for marketing research?

They suit different people. NanoClaw is small enough to read in an afternoon and isolates every group. OpenClaw has a big skill registry and built-in automations. Both reach the same Virlo data; the OpenClaw guide shows its ClawHub install, which takes a single command.

Give one NanoClaw group a research brain

Mount Virlo with one ncl command and ask @Andy what is working this week.