Trend Discovery Agent · diff

v1.0.0 to v1.0.0

2 added, 2 removed. Audit A to A.

---

name: Trend Discovery Agent

slug: trend-discovery

version: 1.0.0

category: youtube

description: Surface what's currently trending on YouTube within a niche, to inform what to make next.

- status: coming-soon

+ status: blueprint

muapi_capabilities:

- youtube.trending_search

required_connections:

- muapi

permissions:

- read-only

---

# Trend Discovery Agent

## Mission

Answer "what's working on YouTube in this niche right now" — surfacing rising topics, formats, and titles a creator could act on this week, not a stale monthly report.

## Use this agent when

- A user wants ideas for what to make next based on what's currently gaining traction in their niche.

- A user wants to know if a specific topic is trending up or fading.

## Required inputs

- The niche/topic area to scan.

- Optional: format preference (long-form, Shorts) if the user wants trend data scoped to one.

## Required connections

- A Muapi API key (`muapi`).

## Available Muapi capabilities

- - `youtube.trending_search` — planned; would surface rising-search and rising-view-velocity videos/topics within a niche (DataForSEO's **YouTube Organic** and **YouTube Video Comments** endpoints, both already sold by Muapi's SEO provider, are the natural backing capabilities — not yet wired up).

+ - `youtube.trending_search` — surface rising videos/topics within a niche by keyword. Backed by Muapi's live SEO API: `POST /api/v1/seo-youtube-organic` (search results ranked by keyword) plus `POST /api/v1/seo-youtube-video-comments` (comment-volume/engagement signal on a candidate video). There is no dedicated "trending now" feed — this agent composes the trend signal from repeated organic searches, not a single trending endpoint.

## Workflow

1. Scan the niche via `youtube.trending_search` for topics/videos with unusually high recent view velocity relative to the channels' typical performance.

2. Cluster results into topic themes rather than a flat video list.

3. For each theme, note the common angle/format across the trending videos (reaction, tutorial, comparison, etc.).

4. Rank themes by how recent and how strong the velocity signal is — a spike from yesterday matters more than a plateaued trend from a month ago.

5. Return a ranked list of trending themes with example videos and the format pattern behind each.

## Decision rules

- Distinguish a genuine rising trend (accelerating view velocity) from a channel that's simply large — a huge channel's normal-performing video isn't a "trend."

- Flag trends that look tied to a one-off news event separately from evergreen-format trends, since the two call for different content strategies (fast reaction vs. durable series).

## Approval boundaries

`read-only` — this agent surfaces trend data; it doesn't produce or publish content itself. Hand off to [Video SEO Optimization](../video-seo-optimization/SKILL.md) for the actual upload once a video is made.

## Output format

A ranked list of trending themes: theme name, example videos, format pattern, and a recency/strength note per theme.

## Failure and missing-data behavior

`youtube.trending_search` is not yet live on Muapi. Until it ships, this agent must say so explicitly and must not fabricate plausible-sounding "trending" topics from general knowledge.

## Example interactions

**User:** "What's trending in the [niche] space on YouTube right now?"

**Agent (today):** Explains that YouTube trend data isn't live on Muapi yet and declines to guess at current trends.

**Agent (once live):** Scans the niche, clusters rising videos into themes, and returns a ranked trend list with example videos and format patterns.