social·scout

Tools for your agent

search_viral_videos

Describe a video idea in plain words and get the viral brand videos that match.

Returns
Videos with brand, views, multiple, ad or not, a summary and a link.
Does
Reads
Who
Paid plan · plans
Limits
Up to 30 results per call. 1,500 tool calls a day on the paid plan, shared by all tools.

Try it on your account

Your plan does not include this tool. Running it shows the answer your agent would get, which says what it needs.

Give it to your agent

Prompt for

No key in it: your agent reads it from SOCIALSCOUT_KEY or asks you.

Read the prompt
Set up SocialScout for me and use it: Belgian social-media data (viral brand videos, Flemish creators, Meta ads and what they say, the Belgian marketing calendar, my own numbers and my content calendar), as an MCP server.

## 1. Connect
You are Claude Code. Add SocialScout as an MCP server for my user (not in this project's .mcp.json, so the key never lands in git):

claude mcp add --transport http --scope user socialscout https://socialscout.be/api/mcp --header "Authorization: Bearer $SOCIALSCOUT_KEY"

First check that SOCIALSCOUT_KEY is set (echo ${SOCIALSCOUT_KEY:+set}); the shell fills it in when the command runs.
Then tell me to run /mcp (or restart Claude Code) so the socialscout tools load.

My key: use the environment variable SOCIALSCOUT_KEY. If it is not set, ask me for my key (I find it at https://socialscout.be/me/crew, under "SocialScout inside your AI": the part after ?key=). Treat it as a password: never print it back, never put it in a file that goes into git.

What the key may do: it reads everything my plan includes and may make drafts in my calendar (scopes read + drafts). It cannot schedule, publish or touch ads: schedule_post, reschedule_post, unschedule_post and delete_post answer "needs_confirmation" with a review_url. Give me that link; nothing happens until I confirm there.
Check the connection: call corpus_stats (works without a key), then list_accounts (needs the key), and tell me in one line what you see.

## The tool: search_viral_videos
Describe a video idea in plain words and get the viral brand videos that match.
Returns: Videos with brand, views, multiple, ad or not, a summary and a link.
Does: Reads · Paid plan
Limits: Up to 30 results per call. 1,500 tool calls a day on the paid plan, shared by all tools.

Parameters:
- question (string): plain-language description of the video/campaign you have in mind
- ads? ("all" | "organic" | "ads"): all = everything, organic = no paid ads, ads = paid only
- limit? (integer)

Use it well: Ask two or three phrasings of the same idea; keep the videos that come back more than once.

## Worked example
"Which supermarket videos with a staff member as the star went viral?"
Call search_viral_videos {"question":"supermarket staff doing a sketch in the shop","ads":"all","limit":8} and answer from what it returns, with the links.

## Rules
- Every claim about a video, creator, brand or ad comes from a tool result. Say so when a tool returned nothing.
- Every result carries a link to its page on socialscout.be: put it next to each name.
- "5x" or "viral" means five times the account's own normal views, not a fixed number.
- Times without an offset are Belgian time (Europe/Brussels).
- A tool that answers with a sentence instead of data is telling you what it needs (a plan, a key): pass that on, do not guess.

What your agent reads

Paid plan (market research). Semantic search across thousands of analyzed viral brand videos (Flemish/Belgian corpus). Ask in plain language what kind of video you want to make; returns the viral videos that match, with the brand behind each and why it worked.

ParameterTypeAbout
questionstringRequired. plain-language description of the video/campaign you have in mind
ads"all" | "organic" | "ads"all = everything, organic = no paid ads, ads = paid only
limitinteger

More in videos & formats

  • top_viral The biggest brand videos: each one did at least 5x the account's normal views.
  • creator_breakouts The biggest videos by people (not brands): each at least 5x their normal reach.
  • get_video Everything about one video: what happens, the format, the numbers, who made it and why it spread.
  • moment_videos The videos made for one moment, with how sure the model is that they were.
  • today Today on SocialScout: the date, today's and upcoming moments, and the posts that just took off.
  • explore Exactly what an Explore view shows: the cards and the charts with their findings.
  • stats_query Any count across all posts: group by sector, format, weekday, hour and more, with filters.
  • list_formats The formats and trends library: hook, mechanic, what it is best for, example videos.

← All 60 tools

search_viral_videos · Tools · SocialScout