ConvertFleet

MCP docs › Tools › YouTube Competitor Analyzer

YouTube Competitor Analyzer

youtube_competitor slow · returns a job Video, audio & downloads

Compare 1-5 YouTube channels side by side (subscriber counts, upload cadence, recent performance).

When to use. Benchmarking 2-5 YouTube channels against each other (subs, upload cadence, recent performance) for a content or competitor report.
Not for. A single channel (use youtube_extract).

Parameters

NameTypeRequiredDefaultDescription
urls string[] yes — 1-5 YouTube channel URLs to compare.
max_videos integer no 30 Recent videos to sample per channel.

Returns

One row per channel plus comparative stats.

Each row typically carries: channel channel_url subscribers total_views video_count uploads_per_week avg_views top_video

The response body is { status, count, fields, results }. Runs that exceed the inline wait return { status: "running", job_id, tool_flow } instead — see Jobs & errors.

Call it over MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "youtube_competitor",
    "arguments": {
      "urls": [
        "https://www.youtube.com/@veritasium",
        "https://www.youtube.com/@kurzgesagt"
      ],
      "max_videos": 30
    }
  }
}

Call it over the REST API

curl -X POST https://convertfleet.online/api/tool-run \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"yt_comp","params":{"urls":["https://www.youtube.com/@veritasium","https://www.youtube.com/@kurzgesagt"],"max_videos":30}}'

Both paths run the same job engine, enforce the same plan limits and count against the same monthly quota. See the REST API page.

Related tools

youtube_extractGetting stats/metadata for a YouTube video, or listing a channel's recent uploads. Auto-detects video vs channel from the URL.

JSON Schema

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "1-5 YouTube channel URLs to compare."
    },
    "max_videos": {
      "type": "integer",
      "description": "Recent videos to sample per channel.",
      "default": 30
    }
  },
  "additionalProperties": false,
  "required": [
    "urls"
  ]
}