Use the goose AI agent to research TikTok and Instagram
Updated
Virlo is social listening for TikTok and Instagram Reels. goose can run commands, edit files and call any extension you give it, yet it has no window into which TikTok or Instagram videos are taking off. Add Virlo as a Remote Extension and goose can search a database of 23.1M viral videos for trends, sounds, hooks and outliers, then save what it finds. goose is the open-source AI agent Block created, running on your own machine as a desktop app or CLI and extended through MCP.
- Added through goose configure or the desktop Extensions page
- Browser sign-in, or a custom Authorization header
- Works inside recipes and scheduled goose jobs
Part of Virlo's AI assistant guides. Comparing open-source terminal agents? See OpenCode or the Claude Code guide.
How do I add Virlo to goose as an extension?
The CLI wizard takes about a minute. The desktop route asks for the same three things: a name, the endpoint and a timeout.
Step 1: Create your Virlo account for free
Step 2: Start the goose configure wizard
In your terminal, launch the wizard, pick
Add Extensionfrom the first menu, then chooseRemote Extension (Streamable HTTP)as the extension type.Terminalgoose configureStep 3: Answer the five prompts
Call the extension virlo, paste the Virlo endpoint, keep the 300-second timeout and answer No to custom headers. goose prints "Added virlo extension" when it is saved to
config.yaml.goose configure promptsWhat would you like to call this extension? virlo What is the Streamable HTTP endpoint URI? https://dev.virlo.ai/api/mcp/mcp Please set the timeout for this tool (in secs): 300 Enter a description for this extension: TikTok and Instagram research Would you like to add custom headers? NoStep 4: Approve the Virlo sign-in
Open a new session. goose registers itself with Virlo automatically and sends you to the Virlo approval page the first time the extension loads; approve it and the browser hands control back to goose.
Terminalgoose sessionStep 5: Ask goose for research
Type a plain request at the goose prompt. It chooses which Virlo tool to call and can write the answer straight into a file in your working folder.
Your first promptUse the virlo extension to find the 10 TikTok and Instagram videos about [your niche] with the highest Virality Score in the last 30 days, then save them to research/outliers.md with the hook each one opened with.
On goose Desktop, open the sidebar with the top-left button, click Extensions, then Add custom extension, pick the Streamable HTTP type, paste the endpoint and click Add Extension. The CLI and the desktop app read the same extension list.
goose configure vs Desktop vs deeplink vs header: which route fits?
Four ways to give goose the Virlo extension. All of them land in the same extension list.
| Route | What you do | Sign-in | Pick it when |
|---|---|---|---|
goose configure wizard | Add Extension, then Remote Extension (Streamable HTTP) | Virlo approval page in your browser | You live in the goose CLI |
| goose Desktop | Sidebar, Extensions, Add custom extension | Virlo approval page in your browser | You prefer the desktop chat window |
| Install link | Open goose://extension?type=streamable_http&url=https%3A%2F%2Fdev.virlo.ai%2Fapi%2Fmcp%2Fmcp&id=virlo&name=Virlo&description=TikTok%20and%20Instagram%20research&timeout=300 and click Yes | Virlo approval page in your browser | You want teammates to install Virlo in one click |
| Custom header | Answer Yes to "add custom headers" and enter Authorization with Bearer virlo_tkn_... | API key, no browser | A shared box or headless machine with no browser |
Keys for the header route come from Virlo API Keys and always start with virlo_tkn_.
goose on its own vs goose with the Virlo extension
| Job | goose alone | goose with Virlo |
|---|---|---|
| Spot what is trending on TikTok | Guesses from model memory | Reads Trends to copy, refreshed hourly |
| Pick a sound for a Reel | No sound data | Lists trending and breakout sounds for TikTok and Instagram Reels |
| Judge a competitor video | Needs you to paste numbers | Pulls its Virality Score against the creator's usual views |
| Rewrite a viral script | Works from your description | Fetches the real TikTok transcript first |
Which TikTok sounds can goose pull for you this week?
This is live data goose receives when it calls Virlo's sound tool: TikTok sounds ranked by how many videos used them over the past 7 days, ready to drop into a recipe's output file.
In Virlo's data, 316 TikTok videos used "original sound - hazel gray" in the last 7 days, more than any other sound on TikTok as of November 19, 2026.
As of November 19, 2026 at 12:03 UTC
| Sound | Artist | TikTok videos (7 days) | Licensed for brands |
|---|---|---|---|
original sound - hazel gray | hazel gray | 316 | Yes |
Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score] | Justice & Tame Impala & SZA & King Gizzard & the Lizard Wizard | 287 | Yes |
original sound | spam_lilah1 | 276 | Yes |
| original sound - cluberich | cluberich | 264 | Yes |
| original sound - rosyconfessions | ᝰ.ᐟ | 252 | Yes |
See all 300 trending TikTok sounds
Usage history and the TikTok videos behind every sound are in the Virlo app.
Open sounds in VirloHow this sample is made
- Source
- Virlo's sound rankings for TikTok, built from the TikTok videos Virlo collects.
- Window
- TikTok videos posted in the last 7 days that Virlo collected. Counts are TikTok videos in Virlo's data, not every video on the platform.
- Method
- Ranked by the number of videos using each sound in the window. "Licensed for brands" = the sound is in TikTok's commercial music library.
- As of
- November 19, 2026 at 12:03 UTC. Rebuilt every day.
- Made by
- Numbers are pulled automatically from Virlo's data; the text around them is written by the Virlo team.
Suggested citation: Source: Virlo, “Use the goose AI agent to research TikTok and Instagram”, virlo.ai/goose
How do I run Virlo research on a schedule with goose recipes?
A goose recipe is a YAML file that bundles a prompt with the extensions it needs, and goose schedule runs that recipe on a cron timetable. List Virlo in the recipe's extensions block and the scheduled session gets the same research tools you use by hand, so a Monday trend brief can write itself while you sleep.
Schedule it with goose schedule add --schedule-id weekly-trends --cron "0 0 9 * * 1" --recipe-source ./recipes/virlo-weekly.yaml, check it with goose schedule list, and trigger a test run with goose schedule run-now --schedule-id weekly-trends.
| Recipe line | Purpose |
|---|---|
extensions: | Starts the list of MCP servers this recipe may use |
- type: streamable_http | Tells goose the extension is a remote Streamable HTTP server |
name: virlo | The label goose shows when it calls a Virlo tool |
uri: https://dev.virlo.ai/api/mcp/mcp | Virlo's hosted MCP endpoint |
timeout: 300 | Seconds goose waits for a research call before giving up |
Pair the recipe with a prompt such as "Pull this week's trends to copy for [your niche] and write recipes/output/[date].md", and each scheduled session leaves a dated brief behind.
What does goose actually do with Virlo connected?
goose treats every extension as a toolbox it can reach for mid-task. With Virlo in that toolbox, marketers use it for jobs like these:
- Build a weekly content calendar from Trends to copy, keeping the part of each trend that must stay the same.
- Compare two creators by pulling their outlier videos and writing a side-by-side Markdown file.
- Turn a TikTok transcript into three hook rewrites for your own product.
- Collect breakout Instagram Reels sounds into a CSV before a shoot.
- Hand a research step to a goose subagent while the main session drafts scripts.
What can I ask goose to research?
Paste these into a goose session or a recipe prompt once the virlo extension is enabled. Swap the bracketed parts for your own.
Monday brief
Pull the trends to copy for [your niche] and write briefs/[date].md with what to keep, what to change and two example videos per trend.
Sound shortlist
List the breakout sounds on Instagram Reels and TikTok this week and save the five best fits for [your brand] to sounds.csv.
Rival scan
Look up @[competitor] on TikTok and Instagram, find their videos that beat their usual views the most, and summarise the repeated formats.
Hook bank
Find 20 hooks from [your niche] videos with a Virality Score of 18 or more and group them by hook type in hooks.md.
Script rebuild
Fetch the transcript of [TikTok link] and rewrite it as a script for [your product], keeping the same beat structure.
Hashtag check
Which hashtags are growing fastest around [topic] this week? Return a table with the top 10 and one example video each.
Recipe draft
Write a goose recipe YAML that uses the virlo extension to produce a weekly trend report for [your niche].
Watch a niche
Set up a Virlo marketing agent that watches [your niche] and tell me what it found on its latest run.
goose AI vs other tools called goose: which one is this?
Several developer tools share the name. This guide is only about the open-source AI agent.
goose AI agent (this page)
The open-source agent Block created, with a desktop app and CLI. Its GitHub home moved from block/goose to aaif-goose/goose, and Virlo plugs in as an extension.
pressly/goose
A Go database migration tool that also runs as a goose command. It has no agent features and no MCP support.
Goose load testing
A Rust load-testing framework for web apps. Unrelated to AI agents or social media research.
Other terminal agents
If you are choosing between agents, Claude Code, Codex and OpenCode each have their own Virlo guide.
What should I know before relying on it?
- Virlo reads public TikTok and Instagram data only; goose cannot log in to your social accounts or publish anything through it.
- Extensions live in goose's
config.yaml(under~/.config/gooseon macOS and Linux), so remove virlo there or from the Extensions page to switch it off. - Trends to copy refresh hourly and are checked by the Virlo team; outlier and sound rankings update as new videos are collected.
- A recipe with its own
extensionsblock only loads what it lists, so add virlo there even if it is enabled globally. - Virlo plans are listed on pricing.
Frequently asked questions
How do I add an MCP server to goose?
Run goose configure, choose Add Extension and pick Remote Extension (Streamable HTTP) for a hosted server like Virlo. Give it a name, paste the endpoint URI, keep a 300-second timeout and decide whether to add custom headers. On goose Desktop the same thing lives under Extensions, then Add custom extension.
What is goose AI?
goose is an open-source AI agent that runs on your own computer, either as a desktop app or a command-line tool. It works with the model provider you choose and gains new abilities through extensions, which are MCP servers. Adding Virlo gives it live TikTok and Instagram research.
Is goose made by Block?
Yes, Block built goose and released it as open source. The repository now lives at aaif-goose/goose on GitHub, and the documentation moved to goose-docs.ai. The extension setup on this page matches the current documentation for both the CLI and goose Desktop.
Does goose support remote MCP extensions with sign-in?
Yes. Remote Streamable HTTP extensions can use OAuth, and goose obtains a client ID on its own through client ID metadata or dynamic registration. Virlo supports both, so the first session that loads the extension opens the Virlo approval page and no key has to be pasted.
Can goose research TikTok trends?
With the Virlo extension enabled it can. Ask for trends to copy, breakout sounds, top hashtags or the highest Virality Score videos on a topic, and goose calls the matching Virlo tool and returns real rows with links back to each TikTok or Instagram video.
Where are goose extensions stored?
In goose's config.yaml file. On macOS and Linux that is ~/.config/goose/config.yaml. A remote extension is saved with type streamable_http, its uri, a timeout and an enabled flag, and the desktop app and CLI both read that same file, so toggling virlo in one shows up in the other.
Can I use an API key instead of signing in?
Yes. When goose configure asks whether you want custom headers, answer Yes, enter Authorization as the header name and Bearer followed by your Virlo key as the value. That suits headless machines where nobody can click through a browser approval.
Can goose run Virlo research automatically every week?
Yes. Put the Virlo extension in a goose recipe, then register it with goose schedule add and a cron expression. Each scheduled run starts a fresh session that pulls the latest data and writes the output wherever the recipe prompt tells it to.
Can goose post videos to TikTok through Virlo?
No. Virlo is a read-only research source built on public TikTok and Instagram data, and it never signs in to social accounts. goose can analyse, rank and write scripts with that data, but posting, replying and scheduling uploads stay with you and whatever publishing tool your team already runs.
Give goose a view of social media
Add the Virlo extension once and every goose session and recipe can research TikTok and Instagram.
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
- 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

![Cover art for Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score]](https://media.virlo.ai/sound-covers/f59fe6c5233489f9b8bc083eb73ea41509e58c05fd5f7fa96ce5e016727bc458.jpg)
