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.

  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: Start the goose configure wizard

    In your terminal, launch the wizard, pick Add Extension from the first menu, then choose Remote Extension (Streamable HTTP) as the extension type.

    Terminal
    goose configure
  3. Step 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 prompts
    What 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?         No
  4. Step 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.

    Terminal
    goose session
  5. Step 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 prompt
    Use 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.

RouteWhat you doSign-inPick it when
goose configure wizardAdd Extension, then Remote Extension (Streamable HTTP)Virlo approval page in your browserYou live in the goose CLI
goose DesktopSidebar, Extensions, Add custom extensionVirlo approval page in your browserYou prefer the desktop chat window
Install linkOpen 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 YesVirlo approval page in your browserYou want teammates to install Virlo in one click
Custom headerAnswer Yes to "add custom headers" and enter Authorization with Bearer virlo_tkn_...API key, no browserA 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

Jobgoose alonegoose with Virlo
Spot what is trending on TikTokGuesses from model memoryReads Trends to copy, refreshed hourly
Pick a sound for a ReelNo sound dataLists trending and breakout sounds for TikTok and Instagram Reels
Judge a competitor videoNeeds you to paste numbersPulls its Virality Score against the creator's usual views
Rewrite a viral scriptWorks from your descriptionFetches 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

Which TikTok sounds can goose pull for you this week?
SoundArtistTikTok videos (7 days)Licensed for brands
Cover art for original sound - hazel grayoriginal sound - hazel grayhazel gray316Yes
Cover art for Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score]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 Wizard287Yes
Cover art for original soundoriginal soundspam_lilah1276Yes
original sound - cluberichcluberich264Yes
original sound - rosyconfessionsᝰ.ᐟ252Yes

See all 300 trending TikTok sounds

Usage history and the TikTok videos behind every sound are in the Virlo app.

Open sounds in Virlo

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

The Virlo entry inside a goose recipe
Recipe linePurpose
extensions:Starts the list of MCP servers this recipe may use
- type: streamable_httpTells goose the extension is a remote Streamable HTTP server
name: virloThe label goose shows when it calls a Virlo tool
uri: https://dev.virlo.ai/api/mcp/mcpVirlo's hosted MCP endpoint
timeout: 300Seconds 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/goose on 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 extensions block 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.