Use Gemini to research TikTok and Instagram
Updated
Virlo is social listening for TikTok and Instagram Reels. Gemini can reason over long research, but it doesn't know which TikTok or Instagram videos are breaking out today. Add Virlo to Gemini CLI with one gemini mcp add command and Gemini can pull trends, hooks, sounds and outliers from a database of 23.1M viral videos.
- One command in Gemini CLI
- Shows as Connected in gemini mcp list
- Works with any Gemini model you run in the CLI
Part of Virlo's AI assistant guides. Prefer an editor? See Cursor. Using another terminal agent? See Codex or Claude Code.
How do I connect Virlo to Gemini CLI?
Three minutes in your terminal: a key, one command and a check.
Step 1: Create your Virlo account for free
Step 2: Copy your Virlo API key
Open API Keys in the Virlo developer dashboard and generate a key. It starts with virlo_tkn_.
Step 3: Add Virlo to Gemini CLI
Run this with your key in place. It saves Virlo to your Gemini settings; add
--scope projectto save it in the current folder instead.Terminalgemini mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp \ --header "Authorization: Bearer virlo_tkn_YOUR_KEY"Step 4: Check that Virlo is connected
Gemini CLI tries each server and prints its status. You want to see virlo marked Connected. Inside a session,
/mcplists the Virlo tools.Terminalgemini mcp listStep 5: Ask Gemini
Start
geminiand ask in plain English. Gemini picks the Virlo tool and asks before running it.PromptWhich sounds are breaking out on TikTok and Instagram Reels this week? Pick three for a [type of brand] and show a video using each.
Prefer a file? The same setup can be written by hand into ~/.gemini/settings.json; the exact block is in the table below.
gemini mcp add vs settings.json: which setup should I use?
| Setup | Where it goes | Best for |
|---|---|---|
gemini mcp add (default) | Your Gemini settings | Using Virlo in every folder |
gemini mcp add --scope project | .gemini/settings.json in the current folder | A project or a shared repo |
| By hand | ~/.gemini/settings.json: "mcpServers" with "type": "http", the URL and an Authorization header | Dotfiles and machine setup scripts |
Keep the key out of shared repos: use the user-level file, or keep the project file in .gitignore.
Gemini settings.json block for Virlo
| Field | Value |
|---|---|
type | http (Streamable HTTP) |
url | https://dev.virlo.ai/api/mcp/mcp |
headers.Authorization | Bearer virlo_tkn_YOUR_KEY |
The whole file: { "mcpServers": { "virlo": { "type": "http", "url": "https://dev.virlo.ai/api/mcp/mcp", "headers": { "Authorization": "Bearer virlo_tkn_YOUR_KEY" } } } }
Which TikTok trends can Gemini see this week?
The trends to copy with the most creators posting in the last 7 days, as Gemini receives them from 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 633 creators posting it as of November 18, 2026.
As of November 18, 2026 at 16:07 UTC
| Trend | Stage | Creators this week | Creators last week |
|---|---|---|---|
| Fresh | 633 | new this week | |
| Rising | 351 | 121 | |
| Fresh | 245 | 2 | |
| Fresh | 176 | new this week | |
| Fresh | 130 | 8 |
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 18, 2026 at 16: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, “Use Gemini to research TikTok and Instagram”, virlo.ai/gemini
What can Gemini do with Virlo?
With Virlo connected, Gemini CLI can combine live social data with its long context and your local files:
- Read a whole folder of briefs or past posts, then find TikTok and Instagram videos that match them.
- Rank videos by Virality Score rather than raw views, so smaller creators show up.
- Pull a TikTok transcript and rewrite it as a script for your product.
- Compare sounds, hashtags and hook types across TikTok and Instagram.
- Save research to Markdown or CSV for the next session.
What can I ask Gemini with Virlo connected?
Paste into a Gemini CLI session. Replace the brackets.
Brief match
Read every file in ./briefs, then use Virlo to find 5 TikTok videos per brief that already prove the idea.
Breakouts
Which TikTok sounds are breaking out this week? Leave out anything older than a month.
Trend picks
List the trends to copy in [your niche] that are still Fresh or Rising, with an example video each.
Hashtag check
Which Instagram hashtags in [your niche] grew fastest over the last 30 days?
Transcript
Get the transcript of [TikTok link] and mark the hook, the turn and the payoff.
Creator list
Find 10 rising creators in [your niche] on Instagram with their best Reel each, and save them to creators.md.
Outliers
Show the 20 videos about [topic] from the last 30 days with the highest Virality Score.
Gemini CLI vs the Gemini app: which one connects to Virlo?
Google ships Gemini in several places. This page uses the one that takes MCP servers.
Gemini CLI (this page)
Google's open-source AI agent for the terminal. Add Virlo with gemini mcp add and ask with any Gemini model.
The Gemini app
Google's chat assistant on the web and phone. For Virlo data, run the same Gemini models through Gemini CLI.
Other MCP apps
VS Code, Windsurf and other editors that run Gemini models connect to Virlo with the configs on the MCP server page.
What are the limits?
- Public TikTok and Instagram data only. Virlo never touches your social accounts and has no posting tools.
- Gemini CLI loads servers at startup: restart it after you add or change Virlo.
- If every tool says "Invalid or inactive API key", copy the key again from your dashboard; the first call is where the key is checked.
- Trends to copy are checked by the Virlo team before they appear and refresh hourly.
- Virlo plans: pricing.
Frequently asked questions
How do I add an MCP server to Gemini CLI?
Use gemini mcp add with --transport http, a name and the URL, plus any header the server needs. For Virlo: gemini mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp --header "Authorization: Bearer virlo_tkn_YOUR_KEY". Then gemini mcp list shows it as Connected.
Can Gemini access TikTok data?
Yes, through Virlo. Once the Virlo server is added to Gemini CLI, Gemini can pull public TikTok data on request: trends to copy, viral videos ranked by Virality Score, trending and breakout sounds, hashtags, creators and full video transcripts.
Can Gemini analyze Instagram Reels?
Yes. With Virlo connected, Gemini can search public Reels on any topic, rank them by Virality Score, see which Reels sounds are trending and look up Instagram creators. For one Reel it gets the hook, format and numbers that explain why it worked.
Where does Gemini CLI store MCP servers?
In settings.json. User-level servers live in ~/.gemini/settings.json and project servers in .gemini/settings.json inside the folder, under "mcpServers". gemini mcp add writes there for you; --scope project picks the project file.
Is Virlo a Gemini extension?
Virlo connects to Gemini CLI as an MCP server, which is the part of an extension that provides tools. One gemini mcp add command gives Gemini the same Virlo tools an extension would, with nothing else to install.
Does the Gemini app connect to Virlo?
Use Gemini CLI for Virlo data. It runs the same Gemini models and accepts MCP servers, so one command connects Virlo. The Gemini chat app on the web and phone is set up for Google's own apps.
Do I need an API key for Virlo in Gemini CLI?
Yes, in the setup on this page: the key goes in the Authorization header of the gemini mcp add command. Generate it in the Virlo developer dashboard; it starts with virlo_tkn_. Keep it in your user settings, not in a shared repo.
Can Gemini post to TikTok or Instagram through Virlo?
No. Virlo is read-only. Gemini can research, rank and write with Virlo data, but posting, commenting and anything in your own accounts stays with you.
Give Gemini a social media brain
One command connects Virlo to Gemini CLI. Ask what is breaking out in your niche.