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.
Step 1: Create your Virlo account for free
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.
Terminalncl groups listStep 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.
Terminalncl 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"}'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.
Terminalnpx skills add Virlo-AI/Virlo-Agent-PluginStep 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?
| Route | Where it lives | Who sees it | Best for |
|---|---|---|---|
| Remote MCP server | The group's mcp_servers entry, written by ncl groups config add-mcp-server | Only that group | Asking @Andy live questions about trends, hooks and creators |
| Virlo skills | npx skills add Virlo-AI/Virlo-Agent-Plugin in your fork | Agents with the Virlo server mounted | Better tool choices and a weekly plan format |
| Virlo CLI in the container | virlo-cli added to the group image, key in VIRLO_API_KEY | That group | Agents that prefer shell commands with --json output |
| Virlo Automations | Your Virlo account, delivering to Telegram, Slack or Discord | Whoever is in the destination chat | Fixed 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
| Trend | Stage | Creators this week | Creators last week |
|---|---|---|---|
| Fresh | 659 | new this week | |
| Rising | 346 | 115 | |
| Fresh | 175 | new this week | |
| Fresh | 158 | 33 | |
| Fresh | 158 | new 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 copyHow 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.
| Key | Value |
|---|---|
type | http (NanoClaw also accepts streamable-http) |
url | https://dev.virlo.ai/api/mcp/mcp |
headers | Authorization: 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
nclapply 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.
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
- 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